초보자를 위한 Java PATH/JAVA_HOME 설정과 첫 번째 Hello World 실행하기 (Maven/Gradle 없이)

Java 개발에 입문하면서 가장 첫 번째로 만나게 되는 벽이 바로 환경변수 설정이다. 처음 자바를 배울 때 나도 이 부분에서 많은 시행착오를 겪었고, 지금까지도 새로운 개발환경을 세팅할 때마다 다시 한번 확인하게 되는 중요한 기초 작업이다. 복잡한 빌드 도구 없이도 간단하게 자바 프로그램을 실행할 수 있는 기본기를 확실히 익혀두는 것이 나중에 큰 도움이 된다.

Java 개발환경이 필요한 이유

자바는 다른 프로그래밍 언어와 달리 먼저 바이트코드로 컴파일된 후 JVM에서 실행되는 특별한 구조를 가지고 있다.
이 때문에 자바 프로그램을 작성하고 실행하려면 두 가지 핵심 도구가 필요하다.

• javac (Java Compiler): 자바 소스코드(.java)를 바이트코드(.class)로 변환하는 컴파일러
• java (Java Interpreter): 컴파일된 바이트코드를 실행하는 인터프리터

이 두 도구가 어디에 있는지 운영체제에게 알려주는 것이 바로 환경변수 설정이다. 환경변수를 제대로 설정하지 않으면 명령 프롬프트에서 "java 또는 javac가 내부 또는 외부 명령으로 인식되지 않습니다"라는 오류를 만나게 된다.

JDK 다운로드 및 설치

자바 개발을 위해서는 먼저 JDK(Java Development Kit)를 설치해야 한다. Oracle 공식 웹사이트에서 최신 버전을 다운로드할 수 있으며, 일반적으로 Windows 환경에서는 x64 Installer를 선택하면 된다.

설치 과정에서 주의깊게 살펴봐야 할 점은 설치 경로다. 기본적으로 C:\Program Files\Java\jdk-버전명 형태로 설치되는데, 이 경로를 나중에 환경변수 설정에서 사용하게 된다.

설치가 완료되면 해당 경로에 bin 폴더가 생성되고, 그 안에 javac.exe와 java.exe 파일이 들어있는 것을 확인할 수 있다.

Windows에서 환경변수 설정하기

JAVA_HOME 설정
환경변수 설정은 Windows의 시스템 속성에서 진행한다. 시작 메뉴에서 "환경변수"를 검색하거나, 내 PC를 우클릭하여 속성 → 고급 시스템 설정 → 환경변수 순으로 접근할 수 있다.
시스템 변수에서 "새로 만들기"를 클릭하고 다음과 같이 입력한다:

• 변수 이름: JAVA_HOME
• 변수 값: C:\Program Files\Java\jdk-18.0.1.1 (실제 설치된 JDK 경로)

JAVA_HOME을 설정하는 이유는 여러 자바 기반 프로그램들이 이 변수를 참조하기 때문이다. 특히 Tomcat과 같은 웹 애플리케이션 서버를 나중에 사용할 때 JAVA_HOME이 없으면 오류가 발생한다.

PATH 설정
PATH 변수는 시스템이 실행 파일을 찾는 경로를 지정한다. 시스템 변수에서 PATH를 찾아 편집 버튼을 클릭한다. 환경변수 편집 창에서 "새로 만들기"를 클릭하고 %JAVA_HOME%\bin을 입력한다.

이때 중요한 팁이 있다. PATH에서 %JAVA_HOME%\bin을 가장 위로 올려주는 것이 좋다. 명령 라인에서 명령어를 찾을 때 PATH에 등록된 순서대로 찾기 때문에, 다른 Java 버전이 먼저 등록되어 있으면 새로 설치한 Java가 제대로 인식되지 않을 수 있다.

설정 확인
환경변수 설정이 완료되면 반드시 확인 과정을 거쳐야 한다. 명령 프롬프트를 새로 열고 다음 명령어를 입력해본다:

java -version

javac -version

두 명령어 모두 정상적으로 버전 정보가 출력되면 환경변수 설정이 성공한 것이다. 만약 오류가 발생한다면 환경변수 창에서 확인을 눌렀는지, 명령 프롬프트를 새로 열었는지 점검해보자. 기존에 열려있던 명령 프롬프트는 환경변수 변경사항이 적용되지 않는다.

macOS에서 환경변수 설정하기

macOS 사용자는 터미널을 통해 환경변수를 설정한다. 사용하는 쉘에 따라 설정 파일이 다른데, zsh을 사용한다면 .zshrc 파일을, bash를 사용한다면 .bashrc 또는 .bash_profile 파일을 수정한다.

nano ~/.zshrc

파일에 다음 내용을 추가한다.

export JAVA_HOME=$(/usr/libexec/java_home -v 11)

export PATH=${PATH}:$JAVA_HOME/bin

설정을 저장한 후 다음 명령어로 변경사항을 적용한다.

source ~/.zshrc

macOS는 /usr/libexec/java_home 명령어를 제공하여 설치된 Java 버전을 쉽게 찾을 수 있다. 여러 Java 버전이 설치된 경우 -v 옵션으로 특정 버전을 지정할 수 있다.

첫 번째 Hello World 프로그램 작성

환경변수 설정이 완료되었다면 이제 실제 자바 프로그램을 작성해볼 차례다. 텍스트 에디터(메모장, VS Code, Notepad++ 등)를 열고 다음 코드를 입력한다:

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

코드 구조 이해하기

이 간단한 코드에는 자바의 핵심 개념들이 모두 들어있다.

• public class HelloWorld: HelloWorld라는 이름의 클래스를 선언한다. 자바는 모든 코드가 클래스 안에 존재해야 한다
• public static void main(String[] args): 프로그램의 시작점이 되는 메서드다. JVM은 이 메서드부터 실행을 시작한다
• System.out.println("Hello, World!"): 콘솔에 "Hello, World!"를 출력하는 명령어다

파일 저장 규칙

자바에서는 파일명과 클래스명이 반드시 일치해야 한다는 중요한 규칙이 있다. 클래스명이 HelloWorld라면 파일명도 HelloWorld.java여야 한다. 대소문자도 정확히 일치해야 하며, 확장자는 반드시 .java를 사용해야 한다.

파일을 저장할 때는 작업하기 편한 경로를 선택한다. 예를 들어 C:\test 디렉토리를 만들고 그 안에 HelloWorld.java 파일을 저장하면 된다.

컴파일과 실행 과정

컴파일하기
저장한 자바 파일을 실행 가능한 바이트코드로 변환하는 과정이 컴파일이다. 명령 프롬프트를 열고 파일이 저장된 디렉토리로 이동한다:

cd C:\test

javac HelloWorld.java

컴파일이 성공하면 같은 디렉토리에 HelloWorld.class 파일이 생성된다. 이 파일이 JVM에서 실행할 수 있는 바이트코드다. dir 명령어로 파일이 생성되었는지 확인할 수 있다.

실행하기
컴파일된 클래스 파일을 실행하려면 java 명령어를 사용한다.

java HelloWorld

주의할 점은 실행할 때는 파일명이 아닌 클래스명을 사용하며, .class 확장자는 생략한다는 것이다. 모든 과정이 정상적으로 진행되었다면 콘솔에 "Hello, World!"가 출력된다.

자주 발생하는 오류와 해결 방법

"javac가 내부 또는 외부 명령으로 인식되지 않습니다"
이 오류는 PATH 환경변수가 제대로 설정되지 않았을 때 발생한다.
다음 사항들을 점검해보자.

• JAVA_HOME이 올바른 JDK 경로로 설정되었는지
• PATH에 %JAVA_HOME%\bin이 추가되었는지
• 환경변수 설정 후 명령 프롬프트를 새로 열었는지

"클래스를 찾을 수 없습니다"
이 오류는 보통 파일명과 클래스명이 일치하지 않거나, 실행 명령어에서 클래스명을 잘못 입력했을 때 발생한다. public class의 이름과 파일명이 정확히 일치하는지 확인하고, 대소문자까지 정확히 입력했는지 점검해보자.

컴파일은 되는데 실행이 안 되는 경우
컴파일된 클래스 파일이 있는 디렉토리에서 java 명령어를 실행하고 있는지 확인한다. 또한 java 명령어 뒤에는 .class 확장자를 포함하지 않은 클래스명만 입력해야 한다는 점을 기억하자.

실무에서 유용한 팁들

여러 Java 버전 관리
실무에서는 프로젝트마다 다른 Java 버전을 사용하는 경우가 많다. 이때는 JAVA_HOME을 프로젝트에 맞게 변경하거나, IDE에서 프로젝트별로 JDK를 설정하는 방법을 활용할 수 있다.

클래스패스 이해하기
복잡한 프로젝트에서는 외부 라이브러리를 사용하게 된다. 이때 컴파일과 실행 시 -classpath 옵션을 사용해 라이브러리 경로를 지정해야 한다. 기본기를 익힌 후에는 이런 고급 기능들도 차근차근 학습해보자.

IDE 활용
명령어를 통한 컴파일과 실행을 익혔다면, Eclipse나 IntelliJ IDEA 같은 통합개발환경을 사용해보자. IDE는 자동 컴파일, 디버깅, 코드 완성 등 편리한 기능을 제공하지만, 기본 원리를 이해하고 사용하는 것이 중요하다.

Java 개발환경 설정과 첫 번째 프로그램 실행은 자바 학습의 첫걸음이다. 처음에는 복잡해 보일 수 있지만, 한 번 제대로 익혀두면 앞으로의 자바 학습에 든든한 밑바탕이 된다. 환경변수 설정부터 컴파일, 실행까지의 전체 과정을 이해했다면 이제 본격적인 자바 문법 학습을 시작할 준비가 되었다.

Maven이나 Gradle 같은 빌드 도구를 사용하기 전에 이런 기본기를 확실히 다져놓는 것이 중요하다. 나중에 복잡한 프로젝트를 다룰 때도 문제가 생기면 기본 원리부터 차근차근 점검할 수 있는 능력이 생기기 때문이다.

오늘 배운 내용을 바탕으로 다양한 자바 프로그램을 직접 작성해보면서 실력을 쌓아가길 바란다.

자바 개발 완전정복! JDK/JRE/JVM 개념 차이부터 설치까지 한 번에 끝내기