VSCode Java 개발 완료! Hello World 출력부터 Spring Boot 프로젝트 생성까지

지난 글에서 Java Extension Pack 설치를 무사히 마쳤다면, 이제는 실제로 코드를 작성하고 실행해 볼 차례입니다. "설치가 끝났는데 왜 바로 시작이 안 되지?"라고 당황하실 필요 없습니다. 오늘은 VSCode에서 첫 자바 프로그램을 실행하고, 실무에서 가장 많이 쓰이는 Spring Boot 프로젝트를 생성하는 과정을 아주 쉽게 설명해 드리겠습니다.

자바 개발의 첫 단추: Hello World 출력하기

먼저 모든 개발자의 관문인 'Hello World'를 출력하며 내 PC의 자바 환경이 제대로 작동하는지 최종 점검해 보겠습니다. VSCode는 파일 하나만으로도 실행이 가능하지만, 자바의 특성상 프로젝트 폴더 구조를 이해하는 것이 중요합니다.

1. 폴더 열기: VSCode에서 [File] > [Open Folder]를 선택해 작업할 폴더를 하나 만듭니다.
2. 자바 파일 생성: 왼쪽 탐색기에서 새 파일 아이콘을 눌러 Main.java 파일을 생성합니다. (대문자로 시작해야 합니다.)
3. 코드 작성: class와 main을 입력하면 나오는 자동 완성 기능을 활용해 아래 코드를 입력합니다.

   public class Main {
       public static void main(String[] args) {
           System.out.println("Hello World!");
       }
   }

4. 실행: 코드 상단에 나타나는 [Run] 버튼을 클릭하거나 F5를 누릅니다. 하단 터미널(Terminal)에 "Hello World!"가 출력되면 성공입니다.

Spring Boot 프로젝트 생성을 위한 필수 조건

단순 자바 학습을 넘어 웹 서비스를 만들고 싶다면 Spring Boot가 필수입니다. VSCode에서는 'Spring Initializr'라는 강력한 기능을 통해 복잡한 설정 없이 프로젝트를 시작할 수 있습니다. 시작 전 아래 필수 확장 기능을 확인하세요.

확장 프로그램	Spring Boot Extension Pack	Spring Boot 개발 도구 통합 패키지
빌드 도구	Maven 또는 Gradle	라이브러리 관리 및 빌드 자동화
권장 JDK	JDK 17 이상	Spring Boot 3.0 이상 버전의 최소 요구 사양

실전! 첫 Spring Boot 프로젝트 만들기

이제 본격적으로 웹 애플리케이션의 뼈대를 만들어 보겠습니다. 이 과정은 별도의 웹사이트 방문 없이 VSCode 내부에서 모두 해결됩니다.

1. 명령 팔레트 실행: Ctrl + Shift + P를 눌러 명령 창을 엽니다.
2. Spring Initializr 검색: 검색창에 Spring Initializr: Create a Maven Project를 입력하고 엔터를 누릅니다.
3. 버전 및 언어 선택: Spring Boot 버전(보통 최신 Stable 버전 권장), Java 언어, Group ID(예: com.example), Artifact ID(예: demo)를 차례로 입력합니다.
4. 의존성(Dependencies) 추가: 프로젝트에 필요한 라이브러리를 고르는 단계입니다. 최소한 아래 3개는 추가하는 것이 좋습니다.
   • Spring Web: 웹 서비스를 만들기 위한 기본 도구
   • Lombok: 반복 코드를 줄여주는 필수 라이브러리
   • Spring Boot DevTools: 코드 수정 시 자동 재시작 지원
5. 저장소 선택: 프로젝트 폴더가 생성될 위치를 지정하면 자동으로 프로젝트 로딩이 시작됩니다.

가장 많이 겪는 오류와 해결법

Q: 프로젝트 생성 후 빨간 줄(에러)이 가득해요.

Spring Boot 프로젝트는 생성 직후 필요한 라이브러리를 인터넷에서 다운로드합니다. 하단 상태 표시줄의 'Building' 혹은 'Importing' 퍼센트가 100%가 될 때까지 기다려 주세요. 네트워크 환경에 따라 1~2분 정도 소요될 수 있습니다.

Q: 포트 8080이 이미 사용 중이라고 나옵니다.

이전에 실행한 서버가 제대로 종료되지 않았을 때 발생합니다. 터미널에서 서버를 Ctrl + C로 종료하거나, application.properties 파일에서 server.port=8081과 같이 포트 번호를 변경해 주면 해결됩니다.

효율적인 자바 개발을 위한 실무 팁

Spring Boot 프로젝트를 처음 만들면 수많은 폴더 구조에 당황할 수 있습니다. 하지만 핵심은 src/main/java 폴더 아래의 메인 클래스를 찾아 실행하는 것뿐입니다. VSCode 상단 검색창에 @를 입력해 클래스나 메서드로 빠르게 이동하는 습관을 들이면 대규모 프로젝트에서도 길을 잃지 않습니다.

 
특히 Maven/Gradle 탭을 자주 확인하세요. 의존성이 꼬였을 때 여기서 'Reload' 버튼 하나만 눌러도 대부분의 빌드 에러가 해결됩니다. 마이크로소프트와 스프링 재단이 긴밀하게 협력하여 VSCode용 확장을 업데이트하고 있으니, 항상 플러그인을 최신 상태로 유지하는 것이 좋습니다.

Windows 환경에서 VSCode Java 개발 환경 구축하기: Extension Pack 설치부터 설정까지