Spring Boot 설치 및 환경 설정 완벽 가이드 (2025 최신버전: UTF-8, Lombok 세팅)

📖 스프링부트(SpringBoot)란?

스프링부트는 스프링 프레임워크(Spring Framework)를 더 쉽게 사용하도록 만들어진 자바 기반 웹 애플리케이션

개발 프레임워크야.
복잡한 설정 없이 빠르게 애플리케이션을 만들 수 있도록 도와줘.

 

🛠️ 왜 스프링부트를 써야 할까?

• 설정이 간단함: 최소한의 설정으로 애플리케이션 구동 가능.
• 자동 구성 지원: 필요한 라이브러리를 자동으로 설정해줌.
• 내장 서버 제공: 톰캣 등의 서버가 내장돼 있어 바로 실행 가능.
• 빠른 개발 가능: 템플릿 프로젝트로 손쉽게 개발 시작 가능.
• Spring Initializr 지원: 웹에서 몇 번의 클릭으로 기본 구조 생성.
• 강력한 생태계: JPA, Security 등 다양한 라이브러리와의 통합 용이.
• 테스트 편의성: 테스트 도구가 잘 갖춰져 있어 TDD에 적합.

위처럼 좋은 기능들이 많지만, 우리가 Spring Boot를 꼭 배워야 하는 진짜 이유는 따로 있습니다.대한민국은 지금 "자바민국"이라고 불릴 만큼 자바를 정말 많이 사용하고 있으며,그중에서도 실무에서는 Spring Boot가 거의 표준처럼 사용되고 있습니다.따라서 일단 배워두면 취업이나 프로젝트에 있어서 매우 유리합니다.

저 역시 좋은 기회를 잡기 위해 지금부터 Spring Boot 공부를 시작하게 되었습니다.

 

먼저 알아보기에 앞서 스프링부트를 설치, 그리고 첫 세팅 하는걸 알아볼겁니다!

일단 시작하기에 앞서 준비물이 있습니다
SpringBoot는 자바 기반의 프로그램입니다 그래서 자바가 필수적으로 설치가 되어 있어야 합니다!!

 

---

 

✅ JDK 설치하기

https://jdk.java.net/

JDK Builds from Oracle

 

제가 자바를 설치하고 있는곳은 이곳 openJDK입니다
보통 상업용으로 사용할때는 이곳에서 많이 받고 아님
https://www.oracle.com/kr/java/technologies/downloads/

Download the Latest Java LTS Free

이곳 오라클 JDK를 받아서 사용합니다

저 같은 경우는  처음 만들때 이제 그냥 공부하면서 만드는데 이왕 만들꺼 좀 예쁘게 만들어서 상업적으로도 쓸수 있으면? 하고 openJDK로 만듭니다 (막상 잘된거는 별로 안보이네요)

⚠️  Oracle JDK vs OpenJDK 차이점

항목	Oracle JDK	OpenJDK
라이선스	상업용은 유료 (Oracle No-Fee Terms)	오픈소스 (GPLv2 + Classpath Exception)
지원	Oracle에서 공식 기술 지원 제공	커뮤니티 중심 지원
업데이트 주기	정기 보안 패치 및 장기 지원 제공	기능은 동일하지만, 벤더에 따라 다름
기능 차이	예전엔 소소한 부가기능 있었지만, 현재는 거의 동일	OpenJDK 기반으로 대부분 동일
사용 용도	기업용, 상용 환경에 적합 (라이선스 주의)	자유롭게 사용 가능 (개인/상용 포함)

자바 설치 과정은 여기서 까지 다루면 너무 길어 지기 때문에
https://jaeuk9060.tistory.com/21

Java - OpenJDK 설치 방법 및 환경변수 세팅

위 링크를 통해서 확인해 주시길 바랍니다
자바 설정이 끝났으면 이제 springboot를 설치 해 보겠습니다

---

 

✅스프링부트 설치하기

https://spring.io/tools

Spring | Tools

위 스프링부트 공식 사이트에 들어가시면 

 

 

이 vscode방법 Eclipse방법 두개가 나오게 됩니다
여기서 저는 Eclipse방법을 선택해서 다운하겠습니다
만 아래에 있는 4.29.1-WINDOWS X86_64(앞 버전은 달라질 수 있음)를 클릭해서 다운받아 주시면 됩니다.

 

 

위 파일을 받으면 zip파일을 하나 받을텐데 저는 이 파일을 압축을 풀어서
C:\Program Files\Java 이경로에 넣어서 풀어 주었습니다(경로는 편한데로 지정하시면 됩니다)

이러한 모습이 뜨실텐데

위 처럼 ini파일을 메모장으로 켜줍니다

메모리의 할당 최소값을 수정해줍니다 (렘 용량이 적으시다면 초기값 그대로 사용해도 무방합니다!)

그 후 저장을 해주고 저희는 Lombok을 설치해 줄겁니다

 

---

 

✅Lombok설치하기(선택)

🍃 Lombok이란? 

롬복(Lombok)은 자바 코드에서 반복적으로 작성해야 하는 코드(boilerplate code)를 자동으로 만들어주는 라이브러리입니다.

예를 들면, getter, setter, toString(), equals() 같은 메서드를 우리가 매번 손으로 작성하지 않아도 되게 도와줘!

---

💡 왜 Lombok을 사용할까?

✅ 코드가 간결해짐	반복적인 getter/setter 코드 안 써도 됨
✅ 가독성이 좋아짐	핵심 로직에 집중할 수 있음
✅ 생산성이 올라감	코딩 속도 빠르고, 유지보수 쉬움

 

https://projectlombok.org/download

저는 Lombok이 거의 반 필수라고 생각하지만 그래도 없어도 돌아가는데는 지장이 없기때문에

설치 방법을 아래에 적어 놓겠습니다

필수설치도 아니기도 하고 설치방법은 좀 길기 때문에 접어 놓겠습니다
확인 하실분은 아래 더보기를 눌려주세요

위 사이트에 들어가셔서lombok을 받으시면 lombok.jar파일이 나올겁니다

그 파일을 압축 해제 해서 자신이 원하는 경로에 넣어주세요
저 같은 경우는 c/Program files/java 안에 넣어 놓았습니다

이렇게 STS(Springboot파일안에 넣어줍니다)
그 이후 콘솔창을 켜 줍니다

저희는 이처럼 관리자 권한으로 실행해 줄겁니다 (반드시 관리자 권한으로 실행시켜 주세요)

 

이처럼 경로를 누른다음 복사해줍니다

cd <복사한 경로>

cd C:\Program Files\Java\sts-4.29.1.RELEASE
저같은 경우는 저렇게 되겠네요

이처럼 경로가 변경이 될겁니다

그 이후 이런식으로 java로 lombok을 열어주면

java -jar lombok.jar

Specify location으로 sts(springboot파일)을 찾아서 경로를 지정해 줍니다

경로는 이런식으로 끝까지 들어가는게 아닌 해당 폴더를 클릭후 select를 눌려주세요

이렇게 나오게 될겁니다 이후 install 해주시면

라는 글이 나오고 해당 lombok설치 파일을 종료 해 주시면 됩니다

 

✅ 스프링부트(Springboot 초기세팅)

 

설치 해주신 springboot에 들어가시면

 workspace 경로를 설정 하라고 하는데 저같은 경우는 
C:\project\springboot\workspace
이곳에 경로를 준비해놓겠습니다

📌UTF-8 설정하기

이제 안에 들어 오셔서 이제 필수 설정을 해 줄겁니다

상단에 있는 Window메뉴 > Prefernces에 들어가 검색필드에 "encoding"라고 입력해 줍니다

이후 Text를 클릭 맨 아래 "UTF-8"이라고 입력후 우측에 있는 Update를 눌려줍니다

이처럼 아래도 Text file encoding 을 UTF-8 로 변경하고 New text file line delimeiter 는 Unix 로 변경해줍니다

여기까지 UTF-8을 설정 하셨으면 이제 주석을 달거나 한글을 작성할때 깨짐이 없을겁니다

그 이후 설치한 JDK 파일을 Springboot에 연결시켜 줍니다

Window > Preferences > Java > Installed JREs
혹시라도 경로가 안보인다면
Add를 눌려 추가 해 줍니다

 

📌JDK 설정하기

 

여러버전의 jdk를 사용하실거면 jre를 체크후 project에서 관리하시면 됩니다 

 

 

추가로 궁금하신거나 안되시는 부분 있으시면 댓글 달아주시면 말씀해 드리겠습니다