FirstBoot Guides

JDK 설치 후 환경변수(JAVA_HOME) 설정 가이드

JDK 설치만으로는 부족합니다. 시스템이 자바를 인식하도록 설정하고 IDE에 등록하는 과정을 알아봅니다.

1. 버전 확인

증상: 'java'은(는) 내부 또는 외부 명령이 아닙니다.

원인: 설치가 안 되었거나 PATH에 등록되지 않았습니다.

해결: 설치 경로를 확인하고 다음 명령어로 버전을 체크하세요.

java -version

2. JAVA_HOME 설정

증상: 빌드 도구(Maven/Gradle) 실행 시 JAVA_HOME 에러 발생

원인: 많은 자바 기반 도구들이 환경변수 JAVA_HOME을 참조합니다.

해결: 환경변수 편집에서 JAVA_HOME 변수를 만들고 JDK 설치 폴더 경로를 입력하세요.

# Windows (PowerShell 확인)
$env:JAVA_HOME

# macOS/Linux (zsh 확인)
echo $JAVA_HOME

3. IDE에서 SDK 설정

증상: 코드에서 빨간 줄이 뜨거나 빌드가 안 됨

원인: IntelliJ 등 IDE 프로젝트 설정에 SDK가 등록되지 않았습니다.

해결: [File] -> [Project Structure] -> [Project SDK]에서 설치한 JDK를 선택하세요.

1분 확인 방법

터미널에서 javac -version을 입력하여 컴파일러까지 정상 작동하는지 확인하세요.

관련 가이드