자바 환경 변수 설정 완전 정복 - JAVA_HOME부터 Path까지 완벽 가이드

 

자바를 설치했는데, 여전히 명령어가 작동하지 않는다면? 그렇다면 아마도 환경 변수 설정을 하지 않은 상태일 수 있습니다. JDK를 설치하는 것만으로는 자바를 제대로 사용할 수 없어요. 여러분의 컴퓨터가 자바를 인식할 수 있도록 "이 컴퓨터에 자바가 설치되어 있어요!" 라고 알려줘야 하거든요.

이번 포스팅에서는 자바를 처음 설치한 분들이라면 반드시 알아야 할 자바 환경 변수 설정 방법을 상세히, 차근차근, 누구나 따라 할 수 있도록 안내드릴게요. 단순히 따라하기만 해도 설정을 마칠 수 있도록 단계별로 설명드리겠습니다.

---

🌱 환경 변수란 무엇일까요?

간단하게 말해서 환경 변수(Environment Variable) 는 운영체제가 프로그램에게 제공하는 설정 정보입니다. 컴퓨터는 다양한 소프트웨어가 동시에 실행되기 때문에, 프로그램들이 ‘내가 어디에 설치되어 있는지’, ‘어떤 폴더를 참조해야 하는지’ 같은 정보를 알아야 하죠.

그런 정보를 운영체제가 가지고 있다가 프로그램이 실행될 때 알려주는데요, 바로 이런 정보들이 환경 변수입니다.

그리고 자바는 실행되기 전에 반드시 이 정보를 확인해야 제대로 작동합니다. 그래서 우리는 자바가 잘 작동하도록 환경 변수를 직접 설정해줘야 해요.

---

🛠️ 자바 환경 변수 설정이 필요한 이유

• javac, java 명령어가 터미널(CMD, PowerShell 등)에서 실행되지 않을 경우
• Eclipse, IntelliJ 같은 자바 IDE가 설치된 JDK를 인식하지 못할 경우
• 여러 버전의 JDK를 번갈아 사용해야 할 경우

이럴 때 환경 변수 설정은 필수입니다.

---

🔧 설정해야 할 환경 변수는 두 가지!

자바를 제대로 사용하기 위해서는 다음 두 가지 환경 변수를 설정해야 합니다.

1. JAVA_HOME: JDK가 설치된 디렉터리를 알려주는 변수
2. Path: javac, java 같은 명령어를 언제 어디서든 사용할 수 있게 해주는 경로

이제 하나씩 설정해볼까요?

---

1️⃣ JAVA_HOME 설정하기

📍 Step 1. 환경 변수 설정 창 열기

1. 윈도우 좌측 하단 검색창에 시스템 환경 변수 편집 입력
2. 검색 결과에서 [시스템 환경 변수 편집] 클릭
3. 시스템 속성 창에서 [환경 변수] 버튼 클릭

📍 Step 2. JAVA_HOME 변수 만들기

1. 하단 '시스템 변수' 섹션에서 [새로 만들기] 클릭
2. 변수 이름: JAVA_HOME
3. 변수 값: JDK가 설치된 경로 입력
   예: C:\Program Files\Java\jdk-21 (버전에 따라 다름)

❗ 주의: JRE가 아닌 JDK 경로여야 합니다. bin 폴더는 포함하지 않습니다.

📍 Step 3. 입력 완료 후 '확인' 클릭

JAVA_HOME이 시스템 변수에 새로 생겼다면 성공입니다!

---

2️⃣ Path 변수 설정하기

이제 JAVA_HOME을 기반으로 명령어들이 인식될 수 있게 Path를 설정할 차례입니다.

📍 Step 1. 기존 Path 변수 편집

1. 동일한 환경 변수 창에서 시스템 변수 목록 중 Path 선택
2. 오른쪽 [편집] 클릭

📍 Step 2. 새로운 경로 추가

1. 오른쪽 [새로 만들기] 클릭
2. 다음 값 입력:
3. %JAVA_HOME%\bin
4. [확인]을 눌러 저장

✅ %JAVA_HOME%을 사용하는 이유는?
JDK 경로가 바뀌어도 JAVA_HOME만 수정하면 Path도 자동 반영되기 때문입니다.

---

✅ 설정 완료 후 확인 방법

환경 변수가 잘 설정되었는지 확인하려면 아래 방법을 따라 해보세요!

📍 CMD 혹은 PowerShell 열기

1. 윈도우 검색창에 CMD 또는 PowerShell 입력 후 실행
2. 다음 명령어 입력 후 엔터:
3. javac -version

📍 결과 확인

• ✅ 정상 출력 예시:
• javac 21.0.2
• ❌ 오류 발생 시:
• 'javac'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

이런 메시지가 뜬다면 환경 변수 설정이 잘못된 것입니다. 다시 JAVA_HOME과 Path 설정을 차근차근 확인해 주세요.

---

🔁 예제 시나리오 3가지로 정리

✔️ 예제 1: 자바를 처음 설치한 사용자

• JDK 21 설치 후, javac 명령어 인식 안 됨
• 해결: JAVA_HOME 생성, %JAVA_HOME%\bin을 Path에 추가

✔️ 예제 2: 자바 버전 변경이 필요한 개발자

• 기존 JAVA_HOME: jdk-17, 새로 jdk-21 설치
• 해결: JAVA_HOME 값만 jdk-21로 변경 → Path는 수정할 필요 없음

✔️ 예제 3: 환경 변수 설정 없이 이클립스 사용하던 사용자

• 이클립스는 자체적으로 JDK 경로 지정 가능
• 그러나 다른 툴(CMD, Maven 등) 사용 시 환경 변수 필요
• 해결: JAVA_HOME 설정 후 Path 연결

---

🚨 환경 변수 설정 시 주의사항

1. JAVA_HOME 경로에 공백이나 한글이 포함되면 문제가 발생할 수 있어요.
2. JRE가 아닌 JDK 경로를 설정해야 합니다.
3. Path 변수에서 기존 다른 설정을 삭제하지 않도록 주의하세요.
4. ;로 구분되는 다른 항목과 겹치지 않게 새 줄로 추가하세요.

---

🧁 마무리하며: 자바 개발의 첫 걸음

JDK 설치는 단지 시작일 뿐이고, 환경 변수 설정은 자바 개발을 위한 필수 준비 작업입니다. 이 단계를 한번 정확하게 해두면, 이후 자바로 개발할 때 환경 문제로 스트레스를 받을 일이 확 줄어듭니다.

여러분도 이 글을 따라 설정을 끝냈다면 이제 자바 개발을 위한 기초 체력을 갖추신 겁니다! 👏

앞으로도 한 잔씩 즐기는 자바 코딩 레시피 시리즈에서는 더 다양한 자바 기초와 실전 팁을 알려드릴 예정이니, 다음 포스팅도 기대해주세요!