VSCode에서 Spring Boot 개발하기

평소엔 IntelliJ로 스프링부트를 개발했었는데, 이번에는 VSCode에서 개발환경을 한번 세팅해봤다. 생각보다 많이 어렵지 않았고, 오히려 가볍고 빠른 느낌이 꽤 마음에 들었다.

1. 필요한 확장(extension) 설치

VSCode는 기본적으로 자바 개발에 필요한 기능들이 없어서, 확장부터 먼저 설치해야 한다. 내가 설치한 확장은 아래 두 개였다.

• Extension Pack for Java (Microsoft 제공)
• Spring Boot Extension Pack (Pivotal 제공)

Extension Pack for Java는 Language Support, Maven, Debugger, Test Runner 같은 자바 개발에 꼭 필요한 기능들이 다 포함되어 있다. Spring Boot Extension Pack은 Spring Initializr, Spring Boot Dashboard 같은 기능이 들어 있어서 부트 프로젝트를 관리할 때 편하다.

2. JDK 설치 및 환경 변수 확인

나는 JDK 17을 설치했다. Spring Boot 3.x 버전부터는 17 이상이 필요하다고 해서 맞췄다. 설치 후에 아래 명령어로 잘 설치되었는지 확인했다.

java -version
javac -version

 

버전이 정상적으로 출력되면 됐다. 만약 환경 변수 설정이 안 되어 있다면, 이 부분에서 막힐 수도 있다.

3. Spring Initializr로 프로젝트 만들기

Command Palette (Ctrl+Shift+P 또는 ⌘+Shift+P) 열고, "Spring Initializr: Generate Maven Project"를 입력하면 프로젝트 생성 마법사가 뜬다. 내가 설정한 값은 다음과 같다.

• Language: Java
• Build Tool: Maven
• Group: com.example
• Artifact: demo
• Dependencies: Spring Web, Spring Boot DevTools

.zip 파일로 내려받고, 원하는 폴더에 압축 풀어서 VSCode로 열면 끝이다.

4. 프로젝트 실행하기

프로젝트를 열면 DemoApplication.java 같은 메인 클래스가 있다. 이 파일 위에 ▶ 아이콘이 뜨는데, 누르면 바로 실행된다.

또는 터미널에서 이렇게 실행해도 된다.

./mvnw spring-boot:run

처음엔 로딩이 좀 오래 걸릴 수 있지만, 잘 실행되면 http://localhost:8080이 열린다.

5. 간단한 컨트롤러 만들어보기

정상적으로 실행되는지 테스트하기 위해 아래처럼 컨트롤러 하나 만들어봤다.

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, VSCode + Spring Boot!";
    }
}

실행 후 http://localhost:8080/hello에 접속하면 "Hello, VSCode + Spring Boot!"라는 문자열이 잘 뜬다.

6. 디버깅도 생각보다 괜찮다

처음엔 VSCode에서 디버깅이 불편할 줄 알았는데, 생각보다 괜찮았다. 특히 Run and Debug 탭에서 Java 프로젝트가 자동으로 인식되고, 별다른 설정 없이 디버깅이 가능했다. 중단점 걸고, 변수 확인하고, 흐름 따라가는 것 정도는 충분히 가능하다.

7. 자주 겪는 문제들

내가 겪었던 문제 몇 가지도 같이 정리해둔다.

• Run 버튼이 안 나오는 경우: main 함수가 제대로 인식 안 되거나, 확장 설치가 덜 된 경우가 많았다.
• 자바 버전 문제: 프로젝트에 지정된 자바 버전이랑 시스템에 설치된 버전이 다르면 실행이 안 될 수 있다.
• Maven 빌드 오류: 처음 열었을 때는 mvn clean install 한번 돌려주는 게 안정적이다.

8. 마무리

VSCode에서 스프링부트를 개발하는 건 생각보다 괜찮은 선택이었다. 특히 IntelliJ처럼 무겁지 않아서 빠르게 실행하고 실험할 수 있다는 게 좋았다. 기능적인 면에서도 확장만 잘 깔면 꽤나 쓸만한 개발 환경이 된다.