Mac에 Java 27을 설치했는데 터미널에서 java를 실행할 수 없는 이유는 무엇인가요?

먼저 설치 여부와 터미널이 선택한 JDK를 따로 확인합니다. 설치된 JDK 목록과 버전 확인 결과가 다르면 새로 설치하기보다 현재 터미널이 어떤 버전을 선택하는지 살펴보세요. 설치 목록에도 원하는 JDK가 없다면 공식 설치 안내와 수업의 요구 버전을 확인한 뒤 설치를 결정합니다.

Java 버전은 나오는데 javac를 찾지 못하면 무엇을 확인해야 하나요?

java는 프로그램을 실행하는 명령이고 javac는 자바 소스 파일을 컴파일하는 도구입니다. 먼저 javac 버전 확인 결과와 설치된 JDK 목록을 비교합니다. javac가 실행되지 않는다는 이유만으로 경로 문제라고 단정하지 말고, 현재 실행 환경에 컴파일 도구가 있는지와 수업 도구가 다른 JDK를 선택했는지를 구분합니다.

Mac에서 현재 사용하는 JDK를 확인하려면 어떻게 하나요?

터미널에서 java -version으로 실제 실행되는 자바 버전을 확인하고, /usr/libexec/java_home -V로 설치된 JDK 목록을 살펴봅니다. 여러 버전이 보이면 목록에 있는 것과 현재 명령이 사용하는 것이 같다고 가정하지 마세요. 수업에서 지정한 버전과 비교한 다음 편집기에서도 별도로 확인합니다.

수업에서 지정한 Java 버전과 터미널 버전이 다르면 어떻게 해야 하나요?

수업에서 요구하는 버전을 먼저 확인하고, 설치 목록에 해당 JDK가 있는지 살펴봅니다. 설치되어 있다면 수업에서 쓰는 편집기나 실행 도구의 설정을 공식 안내에 따라 확인합니다. 시스템 폴더를 바꾸거나 보안 설정을 건드리기 전에 작은 수업 프로그램을 컴파일하고 실행해 결과를 검증하세요.

Mac Java 27 명령을 찾을 수 없을 때: 2026 초보자 점검

터미널에 java: command not found 또는 javac 오류가 표시되면, 설치를 다시 하기 전에 현재 터미널이 사용할 수 있는 JDK와 버전부터 확인하세요.

이번 주에는 설치 목록, 실제 호출 버전, 수업 프로그램 순서로 점검하세요. 수업이 요구하는 버전과 다를 때만 해당 JDK를 선택하고, 확인 없이 시스템 경로를 바꾸지 않는 것이 안전합니다.

이 글은 이런 학습자를 위한 안내입니다.
- Mac에 Java 27을 설치한 뒤 java 또는 javac 명령을 찾지 못하는 학생
- JDK가 여러 개 있거나 수업 프로젝트가 다른 Java 버전을 쓰는 초보자
- 원격 Mac에서 과제를 하며 터미널의 실제 실행 환경을 확인하려는 학습자

마지막 업데이트: 2026년 10월 27일. 설치 위치와 버전 확인 절차는 Java SE 27의 Mac 설치 안내와 설치된 JDK의 디렉터리 설명을 기준으로 확인했습니다.

Mac Java 27 명령 오류는 설치와 호출 환경을 나눠 봅니다

오류 문구 하나만으로 JDK가 설치되지 않았다고 결론 내릴 수는 없습니다. JDK가 없을 수도 있고, 설치되어 있지만 현재 터미널이 그 위치를 찾지 못할 수도 있습니다. 또는 다른 버전을 실행하고 있을 수 있습니다.

여기서 JDK는 자바 프로그램을 만들고 실행할 때 쓰는 도구 상자라고 보면 됩니다. java는 프로그램 실행에, javac는 자바 소스 파일을 컴파일하는 데 쓰입니다. 두 명령이 맡은 역할은 각각 실행 명령 설명과 컴파일 명령 설명에서 확인할 수 있습니다.

첫 단계: 설치된 JDK와 현재 버전을 따로 확인합니다

터미널에서 다음 명령을 하나씩 실행하고 결과를 기록하세요. 아래 명령과 Mac에서 JDK 설치 여부를 살피는 방법은 Java SE 27 설치 안내에 설명되어 있습니다.

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

java -version은 현재 java 명령이 실행하는 버전을 보여줍니다. /usr/libexec/java_home -V는 Mac에 설치된 JDK 목록을 확인하는 데 씁니다. javac -version은 컴파일 도구가 현재 터미널에서 실행되는지 확인합니다.

출력을 이렇게 구분해 보세요.

세 명령 모두 실행되지 않습니다. JDK 설치 여부와 터미널이 명령을 찾는 상태를 각각 확인해야 합니다. 설치 목록이 비어 있다면 수업에서 요구하는 버전과 공식 설치 안내를 대조하세요.
java는 실행되지만 목록에 다른 버전도 보입니다. 여러 JDK가 함께 설치된 상태일 수 있습니다. macOS에서는 설치된 버전 중 기본으로 선택되는 버전이 문제의 원인인지 확인해야 합니다. 관련 동작은 여러 JDK와 기본 버전 안내를 기준으로 살펴보세요.
java는 실행되지만 javac는 실행되지 않습니다. 실행 도구와 컴파일 도구를 구별해서 확인하세요. JDK 목록과 수업 도구가 사용하는 환경도 함께 점검해야 합니다.

버전 문자열이 낯설어도 숫자 일부만 보고 수업에서 요구하는 버전이라고 단정하지 마세요. 버전 문자열 형식 안내에서 표기 방식을 확인하고, 수업 자료에 적힌 요구 사항과 비교하세요.

다음 단계: 수업 도구가 다른 JDK를 쓰는지 확인합니다

시스템 터미널에서 확인한 결과가 편집기나 수업 도구의 결과와 다를 수 있습니다. 사용하는 위치마다 선택된 JDK가 같다고 가정하지 말고, 각각의 결과를 따로 기록하세요.

점검은 다음 순서로 진행합니다.

수업 안내에서 필요한 Java 버전을 확인합니다. 과제 설명에 JDK 버전이나 실행 환경이 적혀 있다면 그 기준을 먼저 따릅니다.
터미널에서 java -version과 /usr/libexec/java_home -V 결과를 기록합니다.
편집기 안의 터미널이나 실행 설정에서 보고되는 버전을 확인합니다. 설정 위치는 해당 편집기의 공식 안내를 따릅니다.
수업의 요구 버전이 설치되어 있으면, 편집기나 실행 도구가 그 버전을 사용하도록 설정되어 있는지 살펴봅니다.
결과가 서로 다르면 설정을 한꺼번에 바꾸지 말고, 어떤 도구에서 불일치가 생기는지 먼저 좁힙니다.

예를 들어 터미널에서는 수업에 맞는 버전이 나오지만 편집기에서 컴파일이 되지 않는다면, 곧바로 JDK를 다시 설치할 이유는 없습니다. 편집기 설정이나 프로젝트가 지정한 실행 환경이 다른지 먼저 확인하세요.

`javac`만 찾지 못하면 컴파일 환경을 따로 점검합니다

java가 프로그램 실행 명령이라면 javac는 소스 코드를 컴파일하는 명령입니다. 따라서 java -version이 성공했다는 사실만으로 과제에 필요한 컴파일 환경까지 준비됐다고 볼 수 없습니다.

먼저 javac -version을 실행하고 설치된 JDK 목록과 비교하세요. JDK가 목록에 있어도 수업에 쓰는 편집기나 터미널이 다른 환경을 선택하면 결과가 달라질 수 있습니다. 반대로 javac가 실행되지 않는 현상을 모두 PATH 문제라고 단정해서도 안 됩니다. 컴파일러 명령의 기능과 사용법을 참고해 어떤 단계에서 실패하는지 구분하세요.

오류가 계속되면 문제가 생기는 위치를 나눠 보세요.

명령 자체를 실행할 수 없다면 설치 목록과 현재 터미널 환경을 확인합니다.
명령은 실행되지만 프로젝트가 컴파일되지 않으면 코드, 의존성, 프로젝트 설정을 살펴봅니다.
컴파일은 되지만 실행에 실패하면 실행 설정과 프로그램의 오류 메시지를 확인합니다.

학교에서 관리하는 컴퓨터라면 설치 권한이나 설정 제한이 있을 수 있습니다. 관리자 권한으로 명령을 반복하거나 시스템 파일을 지우지 마세요. 장비 관리 규칙과 수업 담당자가 안내한 절차를 먼저 확인합니다.

마지막 단계: 작은 수업 프로그램으로 고친 결과를 검증합니다

설정 변경 후에는 터미널을 닫았다가 새로 열고 버전 확인 명령을 다시 실행하세요. 새 터미널에서도 수업에 필요한 버전이 선택되는지 확인해야 합니다.

그다음 과제와 같은 환경에서 간단한 프로그램을 시험합니다.

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

파일 이름을 Hello.java로 저장한 뒤, 파일이 있는 폴더에서 다음 명령을 차례로 실행합니다. 컴파일과 실행은 각각 javac와 java를 사용합니다. 명령의 기능은 컴파일러 안내와 실행 명령 안내를 참고하세요.

javac Hello.java
java Hello

화면에 Hello가 표시되면 이 작은 예제의 컴파일과 실행은 통과한 것입니다. 다만 복잡한 과제의 라이브러리나 프로젝트 설정까지 확인된 것은 아닙니다. 이 예제는 성공하지만 과제만 실패한다면 프로젝트 설정과 코드, 편집기에서 선택한 JDK를 점검하세요. 새 터미널에서 버전이 바뀌었다면 터미널이 사용하는 환경을 다시 확인합니다.

확인 결과	우선 의심할 부분	다음 행동
설치 목록에 수업 버전이 없고 명령도 실행되지 않음	JDK 설치 여부	수업 요구 버전과 공식 설치 안내를 확인한 뒤 설치 여부 결정
`java`는 되지만 수업 버전과 다름	기본 선택 또는 도구별 JDK 설정	설치 목록과 편집기 설정을 대조
`java`는 되지만 `javac`는 실패	컴파일 도구 또는 도구별 환경	JDK 목록과 `javac -version` 결과를 함께 점검
작은 예제는 되지만 과제만 실패	프로젝트, 코드, 의존성 설정	과제와 편집기의 공식 안내에 따라 확인

자주 묻는 질문

Mac에 Java 27을 설치했는데 터미널에서 명령을 찾지 못하는 이유는 무엇인가요?

설치와 터미널의 명령 선택은 별개의 문제입니다. JDK 목록에 설치 흔적이 있는지 확인한 다음 java -version 결과를 비교하세요. 목록에도 원하는 버전이 없으면 수업 요구 사항과 공식 설치 안내를 확인합니다. 한 번의 오류 메시지만 보고 재설치하거나 시스템 경로를 바꾸지 마세요.

Java 버전은 나오는데 `javac`를 찾지 못하면 어떻게 하나요?

java는 실행, javac는 컴파일에 쓰입니다. javac -version을 실행하고 JDK 설치 목록 및 편집기에서 선택한 환경을 함께 점검하세요. 컴파일 도구가 없거나 다른 환경을 쓰는 경우가 있을 수 있으므로, 이 현상을 모두 PATH 문제로 단정하지 않는 것이 중요합니다.

Mac에서 현재 사용하는 JDK는 어떻게 확인하나요?

java -version으로 현재 실행되는 버전을 확인하고 /usr/libexec/java_home -V로 설치된 JDK 목록을 살펴봅니다. 설치 목록과 현재 실행 버전은 서로 다를 수 있습니다. 수업의 요구 버전과 비교하고, 편집기 안에서도 결과를 별도로 확인하세요.

수업에서 지정한 버전과 터미널 버전이 다르면 어떻게 하나요?

먼저 수업이 요구하는 버전이 설치되어 있는지 확인합니다. 설치되어 있다면 수업에서 사용하는 편집기나 실행 도구가 그 버전을 선택하는지 해당 도구의 안내에 따라 점검하세요. 설정을 바꾼 뒤에는 새 터미널에서 버전과 작은 수업 프로그램의 실행 결과를 다시 확인합니다.

Mac 환경이 없다면 Windows 컴퓨터로 macOS 전용 도구를 직접 실행할 수 없고, 학교 컴퓨터는 설치 권한이 제한될 수 있으며, 원격 환경은 네트워크 상태에 영향을 받습니다. 반면 Java 기초 문법 학습이나 이미 정상 작동하는 로컬 JDK 사용에는 원격 Mac이 필요하지 않습니다. 막힌 원인이 실제 macOS 환경의 부재인지 먼저 판단한 뒤, 필요하다면 VpsMesh의 Mac 학습 환경과 Mac 사용 선택지를 살펴보세요. Java 명령 오류가 모두 장비 문제인 것은 아니므로, 수업 요구 버전과 현재 환경을 확인한 뒤 결정하는 편이 낫습니다.