BackEnd/Java

0장. VSCode에 자바 설치하기

허쌤 2025. 12. 26. 19:49

0장. VSCode에 자바 설치하기

이 장에서는 Java 개발을 위한 개발 환경을 구축하는 방법을 단계별로 설명합니다. Visual Studio Code(VSCode)를 사용하여 Java 개발 환경을 설정하는 방법을 학습합니다.

사전 준비사항

Java 개발을 시작하기 전에 다음 사항을 확인하세요:

Windows 운영체제 (Windows 10 이상 권장)
인터넷 연결
관리자 권한 (설치 시 필요할 수 있음)

1단계: JDK 설치

JDK란?

JDK (Java Development Kit)는 Java 프로그램을 개발하고 실행하기 위한 필수 도구입니다. JDK에는 다음이 포함됩니다:

컴파일러 (javac): Java 소스코드를 바이트코드로 변환
실행기 (java): 바이트코드를 실행
라이브러리: Java 표준 라이브러리
개발 도구: 디버거, 문서 생성기 등

JDK 다운로드 및 설치

방법 1: Oracle JDK 설치 (권장)

Oracle 공식 사이트 접속
- https://www.oracle.com/java/technologies/downloads/
- 또는 https://www.oracle.com/kr/java/technologies/downloads/ (한국어)
JDK 버전 선택
- LTS (Long Term Support) 버전 권장: JDK 17 또는 JDK 21
- LTS 버전은 장기간 지원되므로 안정적입니다
- 최신 버전도 사용 가능하지만, 학습 목적이라면 LTS 버전을 권장합니다
Windows용 JDK 다운로드
- Windows x64 Installer 선택
- .exe 파일 다운로드
JDK 설치
- 다운로드한 .exe 파일 실행
- 설치 마법사 따라하기
- 설치 경로 확인: 기본 경로는 C:\Program Files\Java\jdk-XX (XX는 버전 번호)
- 설치 완료

방법 2: OpenJDK 설치 (무료, 오픈소스)

Adoptium (Eclipse Temurin) 접속
- https://adoptium.net/
JDK 다운로드
- 버전 선택 (JDK 17 또는 JDK 21 권장)
- 운영체제: Windows
- 아키텍처: x64
- 패키지 타입: JDK
- 다운로드
설치
- 다운로드한 .msi 파일 실행
- 설치 마법사 따라하기

환경 변수 설정

JDK 설치 후 환경 변수를 설정해야 명령줄에서 Java를 사용할 수 있습니다.

자동 설정 (권장)

최신 JDK 설치 프로그램은 대부분 자동으로 환경 변수를 설정합니다
설치 후 명령 프롬프트를 새로 열어서 확인하세요

수동 설정 (필요한 경우)

시스템 속성 열기
- Win + R 키 누르기
- sysdm.cpl 입력 후 Enter
환경 변수 설정
- "고급" 탭 클릭
- "환경 변수" 버튼 클릭
- "시스템 변수"에서 Path 선택 후 "편집" 클릭
- "새로 만들기" 클릭
- JDK의 bin 폴더 경로 추가:
```
C:\Program Files\Java\jdk-17\bin
```
  (버전에 따라 경로가 다를 수 있음)
- "확인" 클릭하여 모든 창 닫기

설치 확인

명령 프롬프트(cmd) 또는 PowerShell을 새로 열고 다음 명령어 실행:

java -version

예상 출력:

java version "17.0.9" 2023-10-17 LTS
Java(TM) SE Runtime Environment (build 17.0.9+11-LTS-201)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.9+11-LTS-201, mixed mode, sharing)

javac -version

예상 출력:

javac 17.0.9

⚠️ 주의사항:

명령어를 실행했을 때 "명령을 찾을 수 없습니다" 또는 "is not recognized" 오류가 나오면:
1. 환경 변수가 제대로 설정되지 않았을 수 있습니다
2. 명령 프롬프트를 새로 열어서 다시 시도하세요
3. JDK가 실제로 설치되었는지 확인하세요

2단계: Visual Studio Code 설치

VSCode란?

Visual Studio Code (VSCode)는 Microsoft에서 개발한 무료 코드 에디터입니다. Java 개발을 포함한 다양한 프로그래밍 언어를 지원하며, 확장 프로그램을 통해 기능을 확장할 수 있습니다.

VSCode 다운로드 및 설치

VSCode 공식 사이트 접속
- https://code.visualstudio.com/
다운로드
- "Download for Windows" 클릭
- 시스템에 맞는 버전 자동 선택 (64-bit 권장)
설치
- 다운로드한 .exe 파일 실행
- 설치 마법사 따라하기
- 추가 작업 선택 (선택 사항):
  - ✅ "PATH에 추가" 체크 (명령줄에서 code 명령어 사용 가능)
  - ✅ "파일 탐색기에서 'Code로 열기' 작업 추가" 체크
VSCode 실행
- 설치 완료 후 VSCode 실행

Java 프로젝트 만들기

Java 프로젝트 안에서 파일을 만들면 자동으로 클래스가 생성된다.

순서

Ctrl+ Shift + p
Java:Create Java Project
No Build Tools 선택
프로젝트 폴더 생성 (Hello)
Src 폴더
자바 파일 생성해서
터미널 - new 터미널 - 컴파일시 Ctrl + F5

3단계: Java 확장 프로그램 설치

VSCode에서 Java 개발을 하려면 Java 확장 프로그램이 필요합니다.

Extension Pack for Java 설치

확장 프로그램 탭 열기
- Ctrl + Shift + X 키 누르기
- 또는 왼쪽 사이드바에서 확장 프로그램 아이콘 클릭
Java 확장 프로그램 검색
- 검색창에 "Extension Pack for Java" 입력
- Microsoft에서 제공하는 "Extension Pack for Java" 선택
설치
- "설치" 버튼 클릭
- 이 확장 팩은 다음 확장 프로그램들을 자동으로 설치합니다:
  - Language Support for Java: Java 언어 지원
  - Debugger for Java: Java 디버거
  - Test Runner for Java: Java 테스트 실행기
  - Maven for Java: Maven 프로젝트 지원
  - Project Manager for Java: Java 프로젝트 관리
  - Visual Studio IntelliCode: AI 기반 코드 완성
설치 완료 확인
- 설치가 완료되면 "설치됨"으로 표시됩니다
- VSCode를 재시작할 필요는 없지만, 권장됩니다

추가 유용한 확장 프로그램 (선택 사항)

Java Extension Pack (이미 설치됨)
Code Runner: 코드를 빠르게 실행
GitLens: Git 기능 강화
Korean Language Pack: VSCode 한국어 지원

4단계: Java 설정 확인

VSCode에서 Java 버전 확인

명령 팔레트 열기
- Ctrl + Shift + P 키 누르기
Java 버전 확인
- "Java: Configure Java Runtime" 입력 후 선택
- 또는 "Java: Show Runtime" 입력 후 선택
- 설치된 JDK 버전이 표시됩니다

Java 설정 파일 확인

VSCode는 Java 프로젝트를 자동으로 인식합니다. 첫 번째 Java 파일을 열면 자동으로 설정이 완료됩니다.

5단계: 첫 Java 프로그램 테스트

프로젝트 폴더 생성

작업 폴더 생성
예: C:\Users\사용자명\Documents\JavaProjects
VSCode에서 폴더 열기
- File → Open Folder (또는 Ctrl + K, Ctrl + O)
- 생성한 폴더 선택

HelloWorld 프로그램 작성

새 파일 생성
- File → New File (또는 Ctrl + N)
- 파일 이름: HelloWorld.java
코드 작성
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World!"); System.out.println("Java 설치가 완료되었습니다!"); } }
파일 저장
- Ctrl + S 또는 File → Save

프로그램 실행

방법 1: VSCode에서 직접 실행 (가장 간단)

Run 버튼 클릭
- main 메서드 위에 나타나는 "Run" 또는 "▶ Run" 버튼 클릭
- 또는 F5 키를 눌러 디버그 모드로 실행
터미널에서 결과 확인
- 하단 터미널에 실행 결과가 표시됩니다:
```
Hello, World!
Java 설치가 완료되었습니다!
```

방법 2: 명령줄에서 실행

터미널 열기
- Ctrl + `` (백틱) 또는Terminal→New Terminal`
컴파일 및 실행
javac HelloWorld.java java HelloWorld
결과 확인
Hello, World! Java 설치가 완료되었습니다!

문제 해결 (Troubleshooting)

문제 1: "Java를 찾을 수 없습니다"

해결 방법:

JDK가 제대로 설치되었는지 확인
환경 변수 Path에 JDK의 bin 폴더가 추가되었는지 확인
명령 프롬프트를 새로 열어서 다시 시도
VSCode를 재시작

문제 2: VSCode에서 Java 확장 프로그램이 작동하지 않음

해결 방법:

확장 프로그램이 제대로 설치되었는지 확인
VSCode를 재시작
"Java: Configure Java Runtime" 명령으로 JDK 경로 확인
확장 프로그램을 제거 후 다시 설치

문제 3: 컴파일 오류 발생

해결 방법:

파일 이름과 클래스 이름이 일치하는지 확인
- 파일: HelloWorld.java → 클래스: public class HelloWorld
대소문자 구분 확인 (Java는 대소문자를 구분합니다)
코드 문법 오류 확인 (세미콜론, 중괄호 등)

문제 4: 여러 JDK 버전이 설치된 경우

해결 방법:

VSCode에서 사용할 JDK 버전 선택:
- Ctrl + Shift + P → "Java: Configure Java Runtime"
- 원하는 JDK 버전 선택
또는 settings.json에서 직접 설정:
{ "java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "C:\\Program Files\\Java\\jdk-17" } ] }

설치 체크리스트

설치가 완료되었는지 다음 항목을 확인하세요:

JDK 설치 완료 (java -version 명령어로 확인)
컴파일러 설치 확인 (javac -version 명령어로 확인)
VSCode 설치 완료
Extension Pack for Java 설치 완료
HelloWorld 프로그램 실행 성공
터미널에서 Java 명령어 사용 가능

다음 단계

설치가 완료되었다면 다음 장으로 진행하세요:

1장. Java 시작하기: Java의 기본 개념과 특징을 학습합니다.

참고 자료

Oracle Java 공식 사이트: https://www.oracle.com/java/
OpenJDK (Adoptium): https://adoptium.net/
VSCode 공식 사이트: https://code.visualstudio.com/
VSCode Java 확장 프로그램: https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack

요약

이 장에서는 다음을 학습했습니다:

✅ JDK 설치: Java 개발에 필수적인 JDK를 설치하는 방법
✅ VSCode 설치: 무료이면서 강력한 코드 에디터 설치
✅ Java 확장 프로그램 설치: VSCode에서 Java 개발을 위한 확장 프로그램 설치
✅ 환경 설정 확인: 설치가 제대로 되었는지 확인하는 방법
✅ 첫 프로그램 실행: HelloWorld 프로그램을 작성하고 실행하여 환경 구축 완료 확인

이제 Java 개발을 시작할 준비가 완료되었습니다! 🎉