Spring Boot 4 프로젝트 생성 가이드: JetBrains(IntelliJ) 유저와 비유저(VS Code 등) 환경별 세팅법

안녕하세요 Lovefield입니다.

프론트엔드 개발을 주로 하다가 백엔드 API 서버를 직접 구축하거나, 풀스택 환경에서 Spring Boot 4 기반 프로젝트를 처음 시작할 때 가장 먼저 마주하는 고민이 바로 "어떤 도구로 어떻게 프로젝트를 생성하고 세팅해야 하는가?"입니다.

자바(Java) 및 스프링 생태계는 사용하는 IDE(통합 개발 환경)에 따라 초기 프로젝트 생성 방식과 개발 편의 기능의 차이가 꽤 큰 편입니다. 특히 유료 라이선스인 IntelliJ IDEA Ultimate을 사용하는 경우와, VS Code 또는 IntelliJ Community Edition 등 무료 도구를 사용하는 경우의 워크플로우가 명확히 나뉩니다.

이번 글에서는 Java 25 및 Spring Boot 4.x 이상을 기준으로, 두 가지 환경별 가장 깔끔하고 표준적인 프로젝트 생성 방법과 초기 필수 의존성, 그리고 실행 환경 구성 방법을 정리해 보려 합니다.

공통 사전 준비: Java 25 (LTS) 버전 확인

Spring Boot 4.x 이상 환경에서는 최신 JVM 성능 최적화와 가상 스레드(Virtual Threads) 기능 등을 온전히 활용하기 위해 Java 25(LTS) 이상을 사용하는 것이 표준입니다. 터미널에서 아래 명령어로 로컬 머신에 설치된 자바 버전을 먼저 확인합니다.

Shell

1

java -version

만약 25 미만 버전이거나 설치되어 있지 않다면 SDKMAN!(macOS/Linux)이나 Eclipse Temurin(Adoptium) 배포판을 통해 JDK 25 버전을 설치해 두시는 것을 권장합니다.

JetBrains (IntelliJ IDEA Ultimate) 유저

JetBrains의 유료 에디션인 IntelliJ IDEA Ultimate을 사용하고 있다면, 별도의 웹사이트에 접속할 필요 없이 IDE 내부에 내장된 전용 생성 위저드(Wizard)를 통해 원클릭으로 프로젝트를 구성할 수 있습니다.

프로젝트 생성 절차

  1. IntelliJ 실행 후 메인 화면에서 New Project를 클릭합니다.

  2. 왼쪽 사이드바의 Generators 목록에서 Spring Boot를 선택합니다. (※ Community 에디션에는 이 메뉴가 기본 제공되지 않습니다.)

  3. 기본 프로젝트 메타데이터를 입력합니다.

  • Name / Location: 프로젝트 이름과 저장 경로

  • Language: Java (또는 Kotlin)

  • Type: Gradle - Groovy 또는 Gradle - Kotlin 권장 (Maven보다 빌드 속도가 빠르고 설정이 간결합니다.)

  • Group / Artifact: 패키지 네임스페이스 (예: com.example / demo)

  • JDK / Java: 로컬에 설치된 25 선택

  1. Next를 누른 뒤, Spring Boot 4.x.x 버전을 선택하고 필요한 스타터 의존성(Dependencies)을 체크합니다.

  2. Create를 누르면 Gradle 동기화부터 실행 구성(Run Configuration)까지 자동으로 완료됩니다.

IntelliJ Ultimate만의 장점

  • application.yml 또는 application.properties 작성 시 Spring Boot 4 전용 프로퍼티 자동완성 및 폐기(Deprecated) 설정 경고를 즉시 지원합니다.

  • 우측 상단의 실행 버튼(Shift + F10)만으로 내장 톰캣(Tomcat) 서버 구동과 디버깅 브레이크포인트가 바로 동작합니다.

비유저 (VS Code, IntelliJ Community 등 무료 환경)

IntelliJ Community Edition이나 Visual Studio Code(VS Code)를 주력으로 사용하신다면, 스프링 공식 웹 프로젝트 생성기인 Spring Initializr를 활용해 뼈대 프로젝트를 내려받은 뒤 IDE에서 여는 방식이 가장 표준적입니다.

Spring Initializr 웹에서 프로젝트 생성하기

  1. 브라우저에서 공식 사이트(start.spring.io)에 접속합니다.

  2. 좌측 영역에서 프로젝트 속성을 선택합니다.

  • Project: Gradle - Groovy

  • Language: Java

  • Spring Boot: 4.x.x 최신 안정화(GA) 버전 선택 (SNAPSHOT이 붙지 않은 버전 권장)

  • Packaging: Jar (내장 서버 실행 및 Docker 컨테이너 배포에 표준으로 사용됩니다.)

  • Java: 25

  1. 우측 ADD DEPENDENCIES... 버튼을 눌러 필요한 라이브러리를 추가합니다.

  2. 하단의 GENERATE 버튼을 클릭해 .zip 파일을 다운로드하고, 작업 폴더에 압축을 해제합니다.

CLI(터미널)로 빠르게 생성하고 싶다면?

웹 브라우저를 열지 않고 터미널에서 curl 명령어 한 줄로도 Java 25 기반 프로젝트를 바로 내려받을 수 있습니다.

Shell

1

2

3

4

5

6

7

8

curl https://start.spring.io/starter.zip \
  -d type=gradle-project \
  -d language=java \
  -d javaVersion=25 \
  -d groupId=com.example \
  -d artifactId=my-api \
  -d dependencies=web,lombok,validation \
  -o my-api.zip && unzip my-api.zip -d my-api

VS Code에서 Spring Boot 4 개발 환경 완성하기

VS Code는 기본적으로 경량 텍스트 에디터이므로, 압축을 해제한 스프링 프로젝트를 제대로 다루기 위해서는 공식 확장 팩(Extension Pack) 두 가지를 반드시 설치해야 합니다. (※ Java 25 문법 지원을 위해 확장 프로그램을 최신 버전으로 유지해 주세요.)

필수 확장 프로그램 설치

VS Code 좌측 확장 탭(Ctrl + Shift + X)에서 아래 두 패키지를 검색해 설치합니다.

  1. Extension Pack for Java (Microsoft 제공): Java 25 컴파일, 디버깅, 테스트 실행, Gradle 빌드 연동을 담당합니다.

  2. Spring Boot Extension Pack (VMware 제공): 스프링 빈(Bean) 탐색기, application.yml 자동완성, Spring Boot Dashboard(원클릭 서버 실행/중지) 기능을 제공합니다.

프로젝트 열기 및 서버 실행

  1. 압축을 푼 my-api 폴더를 VS Code에서 엽니다.

  2. 우측 하단에 Gradle 빌드 동기화 알림이 뜨면 완료될 때까지 잠시 기다립니다.

  3. 좌측 사이드바 하단에 생성된 Spring Boot Dashboard 패널에서 앱 이름 옆의 재생(▶) 버튼을 클릭하면 내장 서버가 실행됩니다.

초기 생성 시 추천하는 핵심 의존성(Dependencies)

프로젝트를 처음 만들 때 어떤 의존성을 골라야 할지 막막하다면, 아래 4가지를 기본 세트로 시작해 보시는 것을 추천합니다.

Spring Web | REST API 컨트롤러(@RestController) 작성 및 내장 Tomcat 웹 서버 구동을 위한 필수 모듈 

Lombok | @Getter, @Setter, @RequiredArgsConstructor 등의 어노테이션으로 반복적인 자바 보일러플레이트 코드 제거 

Validation | API 요청 DTO의 필드 값 검증(@NotNull, @Email, @Size 등)을 선언적으로 처리 

Spring Boot DevTools | 코드 수정 후 빌드 시 애플리케이션을 자동으로 빠르게 재시작해 주는 개발 편의 도구 

> 주의 (Lombok 및 Java 25 호환성): VS Code나 IntelliJ에서 Lombok 어노테이션이 인식되지 않고 컴파일 에러가 난다면, IDE 설정에서 Annotation Processing(어노테이션 프로세싱) 옵션이 활성화되어 있는지 확인하고 Lombok 버전이 Java 25 바이트코드를 지원하는 최신 버전인지 점검해야 합니다.

정리하며

정리하자면 IntelliJ Ultimate 유저는 내장 위저드로 모든 과정을 한 번에 처리할 수 있고, VS Code나 Community 에디션 유저는 start.spring.io에서 Java 25와 Spring Boot 4 버전을 지정해 프로젝트를 부트스트래핑한 뒤 공식 확장 팩만 세팅하면 쾌적한 개발 환경을 구축할 수 있습니다.

각자의 주력 에디터 환경에 맞춰 가볍게 첫 Spring Boot 4 API 서버를 띄워보시고, 이후 데이터베이스 연동(Spring Data JPA)이나 Docker 컨테이너 배포로 확장해 나가보시길 권장합니다.

해당 글은 AI를 통해 제작되었습니다.

Lovefield

Web Front-End developer

하고싶은게 많고, 나만의 서비스를 만들고 싶은 변태스러운 개발자입니다.

CSS Anchor Positioning과 Popover API: 외부 라이브러리 없이 툴팁과 드롭다운 구현하기

자바스크립트 위치 계산 라이브러리나 Vue Teleport 없이 순수 HTML/CSS 표준(Popover API, CSS Anchor Positioning)만으로 최상단 레이어 툴팁, 드롭다운 메뉴, 화면 끝단 자동 회피(position-try-fallbacks)를 구현하는 방법을 정리합니다.

CSS

v5.0