(자바 개발 필수) JAVA_HOME 환경변수 설정 완벽 가이드 (Windows & Mac)

안녕하세요, 코딩하는곰입니다! 자바 개발을 시작할 때 가장 먼저 해야 할 일 중 하나가 바로 JAVA_HOME 환경변수를 설정하는 것입니다. 오늘은 Windows와 Mac 사용자를 위한 JAVA_HOME 설정 방법을 단계별로 상세히 설명드리겠습니다. 자바 개발 환경 구축의 첫 걸음을 함께 떼어보아요!

1. JAVA_HOME이 왜 필요한가요?

자바 개발을 하기 위해서는 JDK(Java Development Kit)가 반드시 필요합니다. JAVA_HOME은 이 JDK가 설치된 경로를 시스템이 알 수 있도록 지정해주는 환경변수입니다. 이 변수가 설정되어 있지 않으면 터미널에서 javac나 java 명령어를 사용할 수 없으며, 이클립스나 인텔리제이 같은 IDE도 제대로 작동하지 않을 수 있습니다. 또한 Maven, Gradle 같은 빌드 도구들도 JAVA_HOME을 참조하기 때문에 정확한 설정이 필수적입니다. Windows 사용자를 위한 설정 방법:

1. JDK 설치 확인: 먼저 C:\Program Files\Java 폴더에 jdk-버전번호 형식의 폴더가 있는지 확인합니다.
2. 시스템 속성 열기: Windows 키 + Pause/Break → “고급 시스템 설정” → “환경 변수”
3. 시스템 변수 새로 만들기: 변수 이름은 JAVA_HOME, 변수 값은 JDK 설치 경로(예: C:\Program Files\Java\jdk-17.0.1)
4. Path 변수 편집: 새로 만들기 → %JAVA_HOME%\bin 추가
5. 확인: 명령 프롬프트에서 java -version과 javac -version 명령어로 확인

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("JAVA_HOME 설정 완료!");
    }
}

2. Mac에서 JAVA_HOME 설정하기

Mac 사용자는 터미널을 통해 더 쉽게 환경변수를 설정할 수 있습니다. 최신 macOS에서는 기본적으로 자바가 설치되어 있지 않기 때문에 Homebrew를 이용해 JDK를 설치하는 것이 일반적입니다. Homebrew로 JDK 설치:

brew install openjdk@17

설치 후 JAVA_HOME 설정:

1. 터미널 열기
2. zsh 사용자의 경우: nano ~/.zshrc bash 사용자의 경우: nano ~/.bash_profile
3. 파일 맨 아래에 다음 내용 추가:

export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH

4. 저장 후 종료 (Ctrl+O, Enter, Ctrl+X)
5. 변경사항 적용: source ~/.zshrc 또는 source ~/.bash_profile
6. 확인: echo $JAVA_HOME과 java -version 명령으로 확인 문제 해결 팁:

• java_home 명령이 작동하지 않으면 Xcode Command Line Tools를 설치해야 합니다: xcode-select --install
• 여러 JDK 버전이 설치된 경우 jenv 같은 도구로 버전 관리 가능

두뇌 건강을 위한 재미있는 퍼즐 게임이 필요하다면, 크립토 할아버지의 지혜가 담긴 스도쿠 저니를 설치해보세요.

3. JAVA_HOME 설정 시 주의사항 및 고급 팁

1. 버전 충돌 방지: 시스템에 여러 JDK가 설치된 경우 JAVA_HOME이 가리키는 경로가 사용하려는 버전과 일치하는지 반드시 확인하세요. 특히 오래된 프로젝트를 작업할 때는 해당 프로젝트에서 요구하는 자바 버전을 확인해야 합니다.
2. IDE와의 연동: 이클립스나 인텔리제이 같은 IDE는 자체적으로 JDK를 설정할 수 있지만, 대부분 기본적으로 시스템의 JAVA_HOME을 참조합니다. IDE에서 별도로 JDK를 지정했다 하더라도 빌드 도구들은 시스템의 JAVA_HOME을 사용할 수 있으므로 일관성을 유지하는 것이 중요합니다.
3. 환경변수 우선순위: 사용자 변수와 시스템 변수에 모두 JAVA_HOME이 설정되어 있다면 사용자 변수가 우선 적용됩니다. 팀 프로젝트를 진행할 때는 이 점을 유의해야 합니다.
4. Docker와의 연동: 도커 컨테이너 내에서 자바 애플리케이션을 실행할 때는 호스트의 JAVA_HOME이 아닌 컨테이너 내부의 자바 환경을 사용하게 됩니다. Dockerfile에 적절한 JDK 설치 명령어를 포함시켜야 합니다.
5. 지속적 통합(CI) 환경: 젠킨스, 깃허브 액션 같은 CI 도구를 사용할 때는 해당 환경에서도 JAVA_HOME이 올바르게 설정되어 있는지 확인해야 합니다.

매일 두뇌 운동을 위한 스도쿠가 필요하다면, 한국어와 영어를 지원하는 스도쿠 저니를 다운로드하세요.

오늘은 자바 개발의 첫 단계인 JAVA_HOME 설정 방법을 Windows와 Mac 두 환경에서 모두 알아보았습니다. 환경변수 설정은 처음엔 어려워 보일 수 있지만, 한 번 제대로 해두면 앞으로의 개발 작업이 훨씬 수월해질 거예요. 혹시 설정 중 문제가 발생하거나 궁금한 점이 있다면 댓글로 남겨주세요. 코딩하는곰이 최대한 빠르게 답변드리겠습니다! 다음 포스팅에서는 이렇게 설정한 자바 환경으로 간단한 프로젝트를 시작하는 방법을 알려드릴게요. 감사합니다!

매일 두뇌 훈련을 위한 스도쿠를 풀고 싶다면, 클래식과 스토리 모드를 모두 제공하는 스도쿠 저니를 다운로드하세요.