VSCode + Spring Boot + Gradle 기본 환경 세팅 가이드

요즘 많이 사용하는 VSCode에서 Spring Boot와 Gradle을 활용한 기본 개발 환경을 세팅하는 방법을 단계별로 기록해 보겠습니다.

필수 소프트웨어 설치

• JDK 설치
  Spring Boot 3.x 이상을 사용하려면 JDK 17 이상이 필요.
  설치 후, 터미널에서 아래 명령어로 정상 설치 여부 확인.

  java --version

• VSCode 설치
  공식 사이트에서 최신 버전을 설치.

VSCode 확장팩 설치

• Extension Pack for Java (Microsoft)
• Spring Boot Extension Pack (Pivotal)
• Gradle for Java
• Lombok Annotations Support for VS Code (선택, Lombok 사용 시)

VSCode 좌측 메뉴에서 Extensions(확장) 아이콘을 클릭하거나 Ctrl/Cmd + Shift + X로 확장팩을 검색 및 설치할 수 있습니다.

Spring Boot Gradle 프로젝트 생성

1. Ctrl + Shift + P를 눌러 Command Palette 실행
2. Spring Initializr: Create a Gradle Project 선택
3. 아래 항목 입력 및 선택
   - Java 버전 (17 이상)
   - Group Id, Artifact Id 등 프로젝트 정보
   - 필요한 Dependency(추 후 설정해도 되니 기본이 되는 Spring Web 만..)





















4. 프로젝트 생성 후, 원하는 폴더에 저장

프로젝트 열기 및 구조 확인

• 생성된 폴더를 VSCode에서 열면 아래와 같은 구조가 보입니다.
  • src/main/java: Java 소스 코드
  • src/main/resources: 설정 파일 등
  • build.gradle: Gradle 빌드 설정 파일

YAML설정 및 PORT변경

전 개인적으로 계층구조로 가독성이 뛰어난 YAML로 설정파일을 변경하겠습니다.

• application.properties >> application.yml로 변경

• 
    server:
    port: 9090
  
  spring:
    application:
      name: app
    

빌드 및 실행

• 터미널에서 아래 명령어로 빌드 및 실행:

  ./gradlew build      # 빌드
  ./gradlew bootRun    # 실행
              

• VSCode의 Gradle 확장팩을 설치했다면, 사이드바의 코끼리(Gradle) 아이콘 클릭 → Tasks > application > bootRun에서 ▶(실행) 버튼 클릭.
• 메인 클래스 파일(~Application.java) 열어서 우측 상단의 Run Java(삼각형 ▶ 아이콘) 클릭 또는 F5 키로 실행
• 로컬실행(http://localhost:9090)
  실행 확인

Whitelabel Error Page는 "처리할 페이지가 없다"는 의미입니다. 저희의 기본 환경 세팅은 정상이니 걱정 마세요. 기본 세팅 끝!

어때요? 이 과정을 따르면 VSCode에서 Spring Boot + Gradle 백엔드 개발을 위한 기본 환경을 빠르게 구축할 수 있습니다. 쉽죠? 자 이제 개발 시작하시죠~