Spring Boot 개발 환경 구축 (VS Code)

초보자도 10분이면 시작하는 Spring Boot + VS Code 개발 환경 만들기

Spring Boot를 처음 시작할 때 가장 먼저 해야 할 일은 개발 환경 구축입니다. IntelliJ IDEA를 많이 사용하지만, VS Code 역시 가볍고 무료이며 충분히 강력한 Spring Boot 개발 환경을 제공합니다.

이번 글에서는 VS Code를 이용하여 Spring Boot 개발 환경을 구축하는 방법을 단계별로 알아보겠습니다.

 

왜 VS Code로 Spring Boot를 개발할까?

VS Code는 마이크로소프트에서 제공하는 무료 코드 에디터로 다음과 같은 장점이 있습니다.

✅ 무료 사용 가능
✅ 가벼운 실행 속도
✅ 강력한 확장 기능 제공
✅ Spring Boot 지원
✅ Git 연동 편리
✅ Docker, Kubernetes 개발 가능

최근에는 Java 개발 지원도 매우 좋아져 실제 현업에서도 많이 사용되고 있습니다.

 

1. JDK 설치

Spring Boot는 Java 기반 프레임워크이므로 먼저 JDK를 설치해야 합니다.

 

권장 버전

• JDK 21 (최신 LTS)
• JDK 17 (안정적인 LTS)

OpenJDK 다운로드

• https://jdk.java.net/
• https://adoptium.net/

자바 홈(JAVA_HOME) 설정은 시스템 환경 변수 편집 창에서 변수이름을 JAVA_HOME으로 하고, 변수 값에 JDK가 설치된 경로를 입력한 뒤 Path에 등록(%JAVA_HOME%\bin)하면 완료됩니다.

 

설치 후 자바 버전 확인 : java -version

2. VS Code 설치

VS Code를 설치합니다.

다운로드:

• https://code.visualstudio.com/

설치 후 실행합니다.

 

 

 

3. VS Code 필수 확장 프로그램 설치

좌측 메뉴의 Extensions(확장 프로그램)를 클릭합니다.

다음 확장을 설치합니다.

 

Extension Pack for Java

제작자: Microsoft

포함 기능

• Java Language Support
• Debugger for Java
• Maven for Java
• Test Runner for Java

Spring Boot Extension Pack

제작자: VMware

포함 기능

• Spring Boot Dashboard
• Spring Initializr 지원
• Spring 프로젝트 관리

 

추가 추천 확장

Lombok Annotations Support

Lombok 코드 지원

GitLens

Git 이력 확인

Docker

컨테이너 관리

 

4. Spring Boot 프로젝트 생성

가장 쉬운 방법은 Spring Initializr를 이용하는 것입니다.

 

Spring Initializr

• https://start.spring.io/

설정 예시

항목	값
Project	Gradle
Language	Java
Spring Boot	최신 안정 버전
Group	com.example
Artifact	demo
Packaging	Jar
Java	21

Dependencies 추가

다음 항목을 선택합니다.

Spring Web
Spring Boot DevTools
Lombok
Spring Data JPA
H2 Database

5. VS Code에서 프로젝트 열기

압축 해제 후 VS Code에서 열기

 

File → Open Folder

 

프로젝트 폴더를 선택합니다.

처음 열면 Java 환경을 자동으로 분석합니다.

 

6. 프로젝트 실행하기

프로젝트 루트에서 실행

Linux/macOS

./gradlew bootRun

Windows

gradlew.bat bootRun