Mac에 Java 25를 설치했는데도 이전 버전인가요? 2026년 초보자 복구 안내

JDK는 Java 프로그램을 실행하고 컴파일하는 도구 묶음입니다. 책으로 비유하면 JDK는 교재가 들어 있는 책장입니다. 설치가 끝났다는 것은 책장에 새 교재가 들어왔다는 뜻이지, 책상 위에 놓인 교재가 자동으로 바뀌었다는 뜻은 아닙니다.

다음 세 명령을 순서대로 실행합니다. 각 결과를 메모해 두십시오.

java -version
javac -version
/usr/libexec/java_home -V

첫 번째 명령에서 25가 표시되면 현재 터미널이 실행하는 Java는 Java 25입니다. 이전 숫자가 나오면 설치된 JDK와 기본 선택이 일치하지 않습니다.

두 번째 명령도 25를 보여 주어야 합니다. java만 정상이고 javac를 찾을 수 없다면 실행 환경만 잡혔거나, 완전한 JDK가 선택되지 않은 상태일 수 있습니다. Java 학습에서는 소스 파일을 컴파일해야 하므로 javac 확인을 건너뛰면 안 됩니다.

세 번째 명령은 Mac이 인식한 JDK 목록과 설치 경로를 보여 줍니다. 목록에 Java 25가 있으면 설치 자체는 인식된 것입니다. 목록에 없으면 다운로드한 파일의 구조가 맞지 않거나 설치가 끝나지 않았을 가능성이 있으므로 Oracle의 Mac용 JDK 25 설치 절차를 다시 확인하십시오.

Oracle 문서는 Mac의 JDK 설치 위치와 java_home을 이용한 버전 선택을 설명합니다. 명령 결과가 서로 다르면 삭제보다 경로 통일이 먼저입니다.

java는 이미 만들어진 프로그램을 실행하는 명령입니다. javac는 .java 소스 파일을 컴파일해 실행 가능한 형태로 바꾸는 명령입니다. 따라서 Java를 배우는 사람에게는 java만 작동하는 환경이 충분하지 않습니다.

다음으로 Java 25의 선택 경로와 컴파일러 파일을 함께 확인합니다.

/usr/libexec/java_home -v 25
ls "$( /usr/libexec/java_home -v 25 )/bin/javac"

첫 번째 명령이 경로를 출력하면 macOS가 Java 25를 선택할 수 있다는 뜻입니다. 두 번째 명령이 javac를 가리키면 해당 JDK 안에 컴파일러가 있는 것입니다. No such file or directory가 나오면 선택된 경로가 예상한 JDK가 아니거나 설치가 불완전합니다.

다운로드할 때는 Mac의 처리 방식도 확인해야 합니다. Oracle은 JDK 25에서 Apple Silicon용 AArch64와 Intel Mac용 x64 설치 패키지를 구분합니다. Oracle의 JDK 25 다운로드 안내에서 설치 대상과 패키지 종류를 대조하십시오.

원격 Mac을 쓰고 있다면 장비 이름만 보고 판단하지 마십시오. 전달받은 환경 정보나 시스템 화면에서 처리 방식이 Apple Silicon인지 Intel인지 확인해야 합니다. 잘못된 패키지는 설치 실패, 도구 실행 오류, 호환성 문제를 일으킬 수 있지만, 여기서 특정 성능 차이를 단정할 근거는 없습니다.

주의: macOS가 보호하는 시스템 폴더를 삭제하거나, 출처가 불분명한 복구 스크립트를 실행하지 마십시오. 학교 기기의 관리 설정을 끄거나 보안 기능을 해제하는 방법도 해결책이 아닙니다.

JAVA_HOME은 수강 신청표와 비슷합니다. 어떤 Java 교재를 이번 수업의 기준으로 삼을지 지정합니다. PATH는 교실을 찾는 안내판입니다. 둘 중 하나만 바꾸면 터미널이 여전히 이전 JDK를 찾을 수 있습니다.

먼저 현재 값을 확인합니다.

echo "$JAVA_HOME"
echo "$PATH"
which java
which javac

which java와 which javac가 같은 Java 25 계열 경로를 가리키는지 봅니다. JAVA_HOME이 비어 있어도 java가 작동할 수 있으므로, 빈 값만으로 오류라고 판단하지 마십시오. 반대로 JAVA_HOME은 Java 25인데 which java가 이전 경로를 보여 주면 PATH 순서가 문제입니다.

현재 터미널 창에서만 시험하려면 다음처럼 입력합니다.

export JAVA_HOME=$(/usr/libexec/java_home -v 25)
export PATH="$JAVA_HOME/bin:$PATH"
java -version
javac -version

두 버전 명령 모두 25를 보여 주면 현재 창의 설정은 맞습니다. 새 터미널을 열었을 때 다시 이전 버전이 나오면 설정 파일에 저장되지 않은 것입니다.

영구 설정을 하기 전에는 사용 중인 셸과 설정 파일을 확인합니다.

echo "$SHELL"
ls -a ~

이미 JAVA_HOME이나 PATH를 설정한 줄이 있다면 새 줄을 계속 추가하지 말고 기존 줄을 수정하십시오. 같은 변수가 여러 번 선언되면 마지막 줄이 앞선 설정을 덮어씁니다. 변경 전에는 해당 파일을 복사해 복구 지점을 남겨 두십시오.

cp ~/.zshrc ~/.zshrc.before-java25

설정 파일을 수정한 뒤에는 새 터미널을 열거나 현재 설정을 다시 읽습니다.

source ~/.zshrc
java -version
javac -version

현재 셸이 zsh가 아니라면 무조건 .zshrc를 수정하지 마십시오. 사용 중인 셸의 설정 파일과 Oracle이 안내하는 Java 경로를 기준으로 작업해야 합니다. 설정이 꼬였다면 백업 파일로 되돌린 뒤 한 가지 설정만 남기는 편이 안전합니다.

터미널과 IDE는 같은 컴퓨터에서도 서로 다른 Java를 사용할 수 있습니다. 세 가지를 따로 봐야 합니다.

• 터미널이 호출하는 기본 Java
• IDE 자체가 실행되는 Java
• 프로젝트와 모듈이 사용하는 SDK

IntelliJ IDEA에서 터미널이 Java 25를 보여 주는데 프로젝트 실행 결과가 다르다면 프로젝트 SDK와 모듈 SDK를 확인하십시오. 프로젝트와 모듈 설정에 관한 공식 안내는 이 설정들이 프로젝트별로 적용될 수 있음을 설명합니다.

IDE 안의 터미널도 별도 설정이나 셸 초기화 상태를 사용할 수 있습니다. IDE 터미널 설정 문서를 참고해 IDE 터미널에서 다시 java -version과 javac -version을 실행하십시오.

가장 확실한 비교 방법은 최소 파일 하나를 양쪽에서 실행하는 것입니다.

class Main {
    public static void main(String[] args) {
        System.out.println(System.getProperty("java.version"));
    }
}

파일을 Main.java로 저장한 뒤 터미널에서 실행합니다.

javac Main.java
java Main

터미널 출력과 IDE 실행 출력이 모두 Java 25이면 환경이 일치합니다. 터미널만 25라면 IDE의 프로젝트 SDK를 바꿔야 합니다. IDE 설정을 바꿀 권한이 없거나 학교 관리 정책으로 막혀 있다면 계속 우회하지 말고 담당자에게 승인된 방법을 문의하십시오. Java 시작 과정은 공식 입문 자료의 기본 실행 흐름과도 대조할 수 있습니다.

아래 조건에 따라 다음 행동을 선택하십시오.

• JDK 목록에 Java 25가 있고 javac도 25인 경우: 설치를 반복하지 말고 JAVA_HOME과 PATH를 통일합니다.
• JDK 목록에는 Java 25가 있지만 javac가 없는 경우: 완전한 JDK 설치 여부와 선택 경로를 다시 확인합니다. 실행 전용 환경만 남아 있다면 공식 설치 파일로 교체합니다.
• 현재 창에서는 정상이고 새 터미널에서만 실패하는 경우: 셸 설정 파일의 중복 선언과 저장 여부를 점검합니다.
• 터미널은 정상이고 IDE만 실패하는 경우: 프로젝트 SDK와 모듈 SDK를 수정합니다. IntelliJ IDEA의 SDK 선택 방식은 공식 SDK 안내를 기준으로 확인합니다.
• 학교 컴퓨터에서 관리자 권한이 없는 경우: 허용된 사용자 영역 설치나 승인된 개발 환경을 선택합니다. 관리 정책을 우회하지 않습니다.
• 원격 Mac에서 작업하는 경우: 로그인 후에도 버전이 유지되는지 확인하고, 프로젝트 파일을 원격 저장소나 승인된 저장 위치에 보관합니다.

다음 항목을 모두 통과해야 수업이나 과제에 사용할 준비가 된 것입니다.

• [ ] java -version이 Java 25를 표시합니다.
• [ ] javac -version이 Java 25를 표시합니다.
• [ ] which java와 which javac가 예상한 JDK 경로를 가리킵니다.
• [ ] echo "$JAVA_HOME"이 선택한 JDK와 일치합니다.
• [ ] Main.java를 컴파일하고 실행했습니다.
• [ ] 새 터미널을 열거나 다시 로그인한 뒤에도 같은 결과가 나옵니다.
• [ ] IDE 프로젝트 SDK와 모듈 SDK가 Java 25로 맞습니다.
• [ ] 과제 파일을 다시 열었을 때 소스와 실행 설정이 남아 있습니다.

환경을 고칠지 바꿀지 판단할 때는 다음처럼 결정하십시오.

• JDK 목록과 javac가 정상이고 설정 파일만 어긋났다면 현재 Mac을 계속 사용합니다.
• Java 25가 설치되어도 학교 정책 때문에 설정을 바꿀 수 없다면 승인된 별도 환경으로 이동합니다.
• 터미널과 IDE가 계속 다른 버전을 사용하고 설정을 저장할 수 없다면 독립된 실제 Mac 환경에서 최소 프로젝트를 먼저 검증합니다.
• 장기간 안정적인 고정 작업이 필요하거나 물리 장치 연결이 필수라면 직접 소유한 Mac이 더 적합할 수 있습니다.

자주 놓치는 복구 신호

Java 25와 이전 버전의 공존 자체는 반드시 문제는 아닙니다. 수업마다 다른 버전이 필요하다면 여러 JDK를 유지할 수 있습니다. 문제는 어떤 프로젝트가 어떤 버전을 선택하는지 모르는 상태입니다.

재설치가 필요한 경우도 제한적입니다. /usr/libexec/java_home -V에 Java 25가 전혀 없거나, 선택한 JDK 안에 javac가 없을 때만 공식 설치 절차를 다시 확인하십시오. 단순히 java -version만 이전 버전이라고 해서 기존 설치를 먼저 지우지는 마십시오.

학교 컴퓨터는 관리자 권한, 설치 제한, 재부팅 뒤 초기화가 실제 장애가 될 수 있습니다. 개인 Windows 컴퓨터에서 macOS 전용 도구가 필요한 경우에는 가상 환경보다 설정과 파일 보존이 예측 가능한 실제 Mac이 학습에 유리할 수 있습니다. 반대로 장기간 매일 무거운 작업을 하거나 물리 장치가 필요한 경우에는 원격 환경이 맞지 않을 수 있습니다.

Java 과제처럼 터미널과 IDE의 버전 일치만 확인하면 되는 작업이라면, 먼저 원격 Mac 개발 환경 검수 안내를 읽고 접속 뒤 위 검수표를 그대로 실행해 보십시오. 학교 기기의 권한 충돌을 억지로 풀기보다, 독립된 환경에서 같은 Main.java를 컴파일하고 저장되는지 확인하는 편이 원인 분리에 도움이 됩니다.

현재 장비에서 발생하는 문제는 설치 파일보다 환경 선택의 충돌인 경우가 많습니다. java, javac, JAVA_HOME, PATH, IDE SDK를 같은 Java 25로 맞추고, 새 로그인 뒤에도 최소 프로젝트가 실행되는지 확인하면 됩니다.

학교 기기의 제한이나 오래 쌓인 설정 충돌 때문에 이 과정이 반복된다면, CALMVPS의 원격 Mac에서 먼저 승인된 학습 환경을 만들고 검수해 보는 방법이 있습니다. CALMVPS의 원격 Mac 이용 안내에서 연결 방식과 이용 조건을 확인한 뒤, 장기 구매가 필요한지 판단하십시오.