VS Code로 자바(Java) 개발 환경 만드는 방법: JDK·Extension Pack for Java 설치와 실행 순서 (2026년 9월 23일 확인)

이클립스나 IntelliJ가 무겁게 느껴져 VS Code로 자바를 쓰려는 분이 많습니다. 그런데 VS Code는 기본 상태에서 자바를 컴파일하지 못하고, JDK와 확장 팩을 따로 설치해야 실행·디버깅이 됩니다. 이 글은 Visual Studio Code 공식 자바 문서를 기준으로 2026년 9월 23일에 확인한 설치 순서와, 첫 실행이 안 될 때 점검할 항목을 정리했습니다.

3줄 요약

• 필요한 것은 두 가지입니다. JDK(1.8 이상)와 Extension Pack for Java 확장 팩입니다.
• Windows·macOS라면 Coding Pack for Java를 쓰면 VS Code·JDK·확장이 한 번에 설치됩니다.
• 자바 파일은 파일 하나만 열지 말고 폴더를 열어야 언어 서버가 정상 동작합니다.

설치 전 준비물

항목	기준
JDK 버전	Extension Pack for Java는 Java 1.8 이상 지원
필수 확장	Language Support for Java™ by Red Hat, Debugger for Java
권장 방식	Extension Pack for Java 한 번에 설치
간편 설치	Coding Pack for Java (Windows·macOS 전용)
JDK 배포판	Temurin, Microsoft Build of OpenJDK, Corretto, Zulu, Oracle Java SE 등

설치와 첫 실행 순서

1. JDK를 설치합니다. 공식 문서가 안내하는 배포판 중 하나를 고르면 되고, Windows·macOS라면 VS Code·JDK·확장을 함께 넣어 주는 Coding Pack for Java가 가장 간단합니다. Linux는 이 팩이 제공되지 않아 개별 설치가 필요합니다.
2. VS Code를 열고 왼쪽 [Extensions] 아이콘을 누른 뒤 검색창에 Extension Pack for Java를 입력하고 [Install]을 누릅니다. 이 팩에는 Red Hat 언어 지원, 디버거, 테스트 러너, Maven, 프로젝트 매니저, IntelliCode가 들어 있습니다.
3. [File] → [Open Folder]로 작업할 폴더를 엽니다. 공식 문서는 폴더를 열지 않고 자바 파일만 열면 언어 서버가 제대로 동작하지 않을 수 있다고 안내합니다.
4. 폴더 안에 Hello.java 파일을 만듭니다. 파일을 열면 자바 언어 서버가 로딩되고, 상태 표시줄 오른쪽에 로딩 아이콘이 있는 언어 상태 항목이 나타납니다.
5. 프로젝트 형태로 시작하려면 Ctrl+Shift+P(맥은 Shift+Command+P)로 명령 팔레트를 열고 Java: Create Java Project를 실행합니다. 위치·이름과 빌드 도구를 선택할 수 있습니다.
6. 실행과 디버깅은 중단점을 찍고 F5를 누르거나 [Run] → [Start Debugging] 메뉴를 씁니다. 편집기 위에 표시되는 Run | Debug 코드렌즈를 눌러도 됩니다.
7. 처음이라면 명령 팔레트에서 Java: Tips for Beginners를 실행해 안내 가이드를 한 번 훑어보는 것을 권합니다.

JDK가 여러 개일 때

PC에 JDK가 여러 개 깔려 있으면 VS Code가 어떤 것을 쓰는지 헷갈립니다. 프로젝트별 실행 환경은 공식 문서의 Configure Runtime for Projects 항목에서 설정하며, 터미널에서 java -version 결과가 기대와 다르면 JAVA_HOME과 PATH부터 정리해야 합니다.

주의사항

VS Code의 자바 지원은 확장에 의존하므로, 확장 버전이 올라가면 화면 문구나 명령 이름이 바뀔 수 있습니다. 이 글의 메뉴 이름은 확인 시점 영문 UI 기준입니다. 또한 미리보기(preview) 문법을 쓰려면 Maven의 maven-compiler-plugin 설정이나 Gradle의 --enable-preview 옵션을 직접 넣어야 합니다.

실행이 안 될 때 추가 점검

• 파일만 열지 않았는지 확인합니다. 폴더를 열어야 클래스패스가 잡힙니다.
• 언어 서버가 계속 로딩 상태라면 명령 팔레트에서 Java: Clean Java Language Server Workspace를 실행하고 다시 로드합니다.
• 회사 네트워크에서 의존성 다운로드가 막히면 프록시 문제일 수 있습니다. 공식 FAQ는 java.jdt.ls.vmargs 설정에 프록시 호스트·포트를 넣는 방법을 안내합니다.
• 단축키가 손에 안 익으면 IntelliJ IDEA·Eclipse 키맵 확장을 설치해 기존 단축키를 그대로 쓸 수 있습니다.
• "Classpath is incomplete" 경고는 Red Hat 확장 위키의 같은 제목 문서에서 원인별 해결책을 확인할 수 있습니다.

자주 묻는 질문

Q1. JRE만 있어도 되나요?
아닙니다. 컴파일이 필요하므로 JDK가 있어야 하고, 확장 팩은 Java 1.8 이상을 지원합니다.

Q2. 확장을 전부 설치해야 하나요?
공식 튜토리얼 기준 최소 구성은 Language Support for Java™ by Red Hat과 Debugger for Java 두 가지입니다. 나머지는 필요할 때 추가하면 됩니다.

Q3. Linux에서도 Coding Pack을 쓸 수 있나요?
아닙니다. Coding Pack for Java는 Windows와 macOS에서만 제공되며, 그 외 OS는 JDK·VS Code·확장을 각각 설치해야 합니다.

함께 보면 좋은 글

• JDK 여러 개 설치 후 java -version이 안 바뀔 때: JAVA_HOME·PATH 정리 순서
• IntelliJ Cannot resolve symbol 빨간 글씨 해결
• Spring Boot Port 8080 was already in use 오류 해결

공식 출처

• Visual Studio Code Docs – Getting Started with Java
• Visual Studio Code Docs – Java FAQ
• Visual Studio Code Docs – Java Project Management
• Extension Pack for Java (Marketplace)