정보

[윈도우 기준] VSCode에서 스프링 부트(Spring Boot) 프로젝트 생성 및 실행 방법 완벽 가이드

mindlab091904 2025. 5. 9. 16:32
반응형

 

자바(Java) 개발을 시작하려는 많은 분들이 선택하는 프레임워크가 바로 Spring Boot입니다. 기존 스프링 프레임워크보다 설정이 간편하고, 생산성이 높아 백엔드 개발에 최적화된 환경을 제공하기 때문입니다. 그러나 이 강력한 프레임워크를 제대로 활용하기 위해서는, 먼저 개발 환경을 올바르게 세팅하는 것이 중요합니다.

오늘은 Windows 환경에서 VSCode(Visual Studio Code)를 사용해 Spring Boot 프로젝트를 생성하고 실행하는 전 과정을 처음부터 끝까지 상세히 소개합니다. 특히 복잡한 설정 없이 마우스 클릭 몇 번으로 프로젝트를 만들고 실행할 수 있는 VSCode의 Spring Boot Extension Pack을 중심으로 설명드리겠습니다.

1. VSCode에 스프링 부트 개발 환경 준비하기

먼저, VSCode에서 Spring Boot 프로젝트를 생성하고 실행하기 위해 필수 확장 프로그램을 설치해야 합니다.

📦 필수 Extension 설치하기

  • VSCode를 실행한 뒤 좌측의 확장 프로그램(Extension) 아이콘을 클릭합니다.
  • 검색창에 Spring Boot Extension Pack을 입력하고 설치합니다.

해당 패키지는 다음과 같은 도구를 한 번에 설치해줍니다:

  • Spring Boot Tools: Spring 프로젝트 생성을 위한 도구
  • Spring Initializr Java Support: Maven/Gradle 프로젝트 템플릿 생성 도구
  • Spring Boot Dashboard: 프로젝트 관리 및 실행 패널

👉 이 확장팩을 설치하면 Spring Boot 프로젝트를 보다 직관적으로 관리할 수 있는 GUI 환경이 구성됩니다.

2. Spring Boot 프로젝트 생성하기

🧭 Command Palette 실행

  • Ctrl + Shift + P를 누르거나, 상단 메뉴에서 View → Command Palette를 클릭합니다.
  • Spring Initializr라고 입력합니다.
  • Spring Initializr: Create a Maven Project 또는 Create a Gradle Project를 선택합니다.

이번 예시에서는 Maven 기반 프로젝트로 진행하겠습니다.

🛠️ 프로젝트 생성 단계별 설정

  1. 스프링 부트 버전 선택
    • 현재 최신 버전이 3.x 대라면, 해당 버전을 선택해도 무방합니다.
    • 중요한 점은 이후 사용할 자바 버전이 최소 17 이상이어야 한다는 점입니다.
  2. 프로그래밍 언어 선택
    • 대부분의 경우 Java를 선택하지만, 필요에 따라 Kotlin이나 Groovy도 선택할 수 있습니다.
  3. Group ID 설정
    • 보통 도메인명을 반대로 뒤집어 사용합니다.
    • 예시: com.example, kr.co.myapp
  4. Artifact ID 설정
    • 프로젝트의 고유 식별자이자 폴더명이 됩니다.
    • 예시: my-spring-app
  5. 패키징 형식 선택 (Jar or War)
    • 대부분의 Spring Boot 애플리케이션은 Jar를 선택합니다.
    • War는 전통적인 톰캣 배포 방식이며, 특별한 이유가 없다면 Jar를 추천합니다.
  6. 자바 버전 선택
    • 반드시 Java 17 이상을 선택해야 Spring Boot 3.x 버전과 호환됩니다.
    • 로컬 환경에 해당 버전의 JDK가 설치되어 있어야 합니다.
  7. 의존성(Dependency) 선택
    • 자주 사용되는 의존성:
      • Spring Web: REST API용 필수 라이브러리
      • Spring Boot DevTools: 개발 편의를 위한 자동 리로딩
      • Lombok: 코드를 간결하게 만들어주는 어노테이션 도구
      • Spring Data JPA: 데이터베이스 연동
      • MySQL Driver: MySQL DB 사용 시 필요
    • 원하는 기능에 따라 체크하면 됩니다.

💾 프로젝트 저장 위치 지정

  • 모든 설정을 마치면 VSCode가 파일 탐색기를 띄웁니다.
  • 프로젝트를 저장할 폴더를 선택하고 generate into this folder 버튼을 누르면 생성이 완료됩니다.

3. VSCode에서 Spring Boot 프로젝트 실행하기

프로젝트 생성이 완료되었으면, 이제 본격적으로 서버를 실행해보겠습니다.

🧭 Spring Boot Dashboard 사용하기

  • VSCode 좌측 사이드바에서 Spring Boot 아이콘(화살표와 스프링 로고)을 클릭합니다.
  • APPS 항목 아래에 방금 생성한 프로젝트가 보일 것입니다.
  • 프로젝트 우측의 ▶️ 재생 버튼을 클릭하면, 자동으로 빌드 및 서버 실행이 시작됩니다.

🖥️ 실행 로그 확인

  • 하단의 터미널 패널에 Tomcat started on port(s): 8080 등의 로그가 출력되면 실행 성공입니다.
  • 웹 브라우저에서 http://localhost:8080에 접속해 확인해보세요.
  • 별도로 컨트롤할 수 있는 종료/재시작 버튼도 제공되며, 여러 프로젝트를 동시에 띄울 수도 있습니다.

4. 추가 팁: Java 버전 오류 해결 방법

Spring Boot 3.x 버전부터는 Java 17 이상만 지원됩니다. 로컬 환경에 Java 17 또는 21이 설치되어 있지 않다면 프로젝트 생성 이후 빌드 에러가 발생할 수 있습니다.

☑️ Java 버전 확인 방법

  • 터미널에 java -version 명령어를 입력해 현재 설치된 자바 버전을 확인합니다.
java -version

🛠️ VSCode에 JDK 경로 지정하기

  • VSCode 설정(settings.json)에서 다음과 같이 JDK 경로를 지정할 수 있습니다.
"java.configuration.runtimes": [
  {
    "name": "JavaSE-17",
    "path": "C:\\Program Files\\Java\\jdk-17",
    "default": true
  }
]

5. 마무리: VSCode로 스프링 부트 시작하기 정말 쉬워졌습니다

지금까지 Windows에서 VSCode를 사용해 Spring Boot 프로젝트를 생성하고 실행하는 전 과정을 상세하게 소개해드렸습니다. IntelliJ가 부담스러운 분들이나, 경량화된 개발 환경을 선호하는 분들에게 VSCode는 더없이 매력적인 선택이 될 수 있습니다.

VSCode + Spring Boot Extension Pack 조합은 GUI 기반의 직관적인 개발 환경을 제공하며, 무엇보다 초보자도 마우스 클릭 몇 번이면 프로젝트 생성부터 실행까지 가능하다는 점에서 큰 장점이 있습니다.

📌 요약 정리

단계 설명

1 VSCode에 Spring Boot Extension Pack 설치
2 Command Palette에서 Spring Initializr 실행
3 Maven/Gradle 선택 후 프로젝트 세팅
4 의존성 및 Java 버전 설정
5 폴더 지정 후 생성 완료
6 Spring Boot Dashboard에서 ▶ 실행
7 브라우저에서 localhost:8080 접속 확인

 

반응형