2019년 macOS 카탈리나(Catalina) 출시 이후 맥은 기본 로그인 셸을 Bash에서 Zsh로 전환했습니다. 그 결과 시스템 업데이트 후 일부 명령어가 정상적으로 작동하지 않는 경우가 발생할 수 있습니다. 맥 터미널에서 명령어를 실행할 때 'zsh: command not found' 오류 메시지를 마주한 적이 있다면, 이는 입력한 명령이 유효하지 않다고 판단되어 나타나는 것입니다.
이 오류는 명령어가 시스템에 설치되어 있지 않거나, 문법이 올바르지 않거나, 단순히 오타가 있는 경우 등 다양한 원인으로 발생합니다. 다행히도 몇 가지 점검 절차를 통해 문제를 충분히 해결할 수 있습니다. 이 글에서는 오류의 원인과 실질적인 해결 방법을 하나씩 살펴보겠습니다.
맥 'Zsh: Command Not Found' 오류란?
Unix, Linux 또는 macOS를 사용하는 많은 사용자가 'zsh command not found python mac' 같은 오류를 경험하며, 관련 커뮤니티와 포럼에서도 지속적으로 질문이 올라오고 있습니다. 먼저 이 오류가 발생하는 대표적인 원인부터 알아보겠습니다.
1. 명령어 오타 또는 잘못된 입력
맥에서 Zsh 명령어를 처음 사용할 때 불필요한 기호를 추가하거나, 꼭 필요한 공백을 누락하는 실수가 자주 발생합니다. 잘못 입력된 명령어는 macOS가 인식하지 못하기 때문에 오류 메시지가 표시됩니다. 오류가 발생했다면 가장 먼저 입력한 명령어의 철자와 형식을 확인해 보세요.
2. 명령어는 올바르지만 패키지가 설치되지 않은 경우
명령어 자체는 정확하게 입력했더라도 해당 명령어에 필요한 패키지가 설치되어 있지 않으면 'Zsh command not found' 경고가 나타납니다. 문법에 문제가 없다면 필수 패키지가 설치되어 있는지 확인해야 합니다.
3. Zsh 기본 환경 설정 변경
macOS가 새 버전으로 업그레이드되면서 기본 명령어 환경도 달라졌습니다. 기존 Linux Bash 명령어들이 저장되어 있던 경로는 Zsh와 호환되지 않는 경우가 많습니다. Zsh는 기본적으로 이전 경로의 환경 변수를 읽어 들이지 않기 때문입니다.
맥에서 Zsh Command Not Found 오류 해결 방법
이 오류는 macOS Monterey 등 Zsh를 지원하는 모든 macOS 버전에서, 어떤 명령어든 발생할 수 있습니다. 아래 방법들을 하나씩 순서대로 시도해 보며 명령어가 정상 실행될 때까지 확인해 보시기 바랍니다.
방법 1: macOS 재설치 전 삭제된 데이터 복구하기
macOS를 재설치하면 'zsh command not found' 문제를 해결하는 데 도움이 될 수 있습니다. 다만 재설치나 업데이트 과정에서 중요한 파일이 삭제될 가능성도 있으므로 데이터 보호에 유의해야 합니다. 잘못된 업데이트나 조작으로 파일이 손실되었을 경우, 4DDiG Mac Data Recovery 같은 전문 데이터 복구 도구를 활용하는 것이 좋습니다.
- 맥 및 USB, SD카드, 디지털 카메라 등 Mac 기반 저장 장치에서 분실된 모든 데이터 복구
- 높은 복구 성공률을 자랑하는 안전한 Mac 데이터 복구
- T2 칩, M1, M1 Pro, M2, M3, M4 및 macOS Sequoia 지원
- 클릭 3번만으로 데이터 복구, SIP 비활성화 불필요
4DDiG-Mac 설치 후 데이터 복구를 시작할 위치(예: 로컬 드라이브)를 선택합니다. 위치 위에 마우스를 올리면 우측 하단에 스캔 아이콘이 나타나며, '스캔'을 클릭해 분실된 파일 검색을 시작할 수 있습니다.
스캔 결과가 준비되면 파일 유형별로 클릭하여 상세 미리보기를 확인합니다.
'복구'를 클릭하고 저장 위치를 지정합니다. 영구적인 데이터 손실을 방지하려면 복구된 파일을 반드시 다른 파티션에 저장하세요.
방법 2: 명령어 구문 점검
터미널에서 'Zsh: command not found' 오류가 발생하면 가장 먼저 명령어의 구문을 확인하세요. 직접 타이핑하는 것보다 원본 내용을 그대로 복사해 붙여넣는 것이 좋으며, 동일한 명령어를 사용하는 다른 예시와 비교해 보는 것도 큰 도움이 됩니다.
명령어에 익숙하지 않은 사용자는 공백 누락이나 불필요한 기호 삽입 같은 실수를 하기 쉽습니다. 예를 들어 Nano 편집기로 Hosts 파일을 수정할 때 'sudo nano/private/etc/hosts'라고 입력하면 오류가 발생하지만, nano 뒤에 공백을 넣은 'sudo nano /private/etc/hosts'가 올바른 구문입니다.
또한 '$ brew install pyqt'처럼 $ 기호까지 함께 붙여넣으면 '-bash: $: command not found' 오류가 반환됩니다. $는 문서에서 터미널 프롬프트를 표시하기 위한 예시 기호일 뿐 실제 명령어에 포함되지 않기 때문입니다.
방법 3: macOS 재설치
운영체제를 만지작거리던 중 실수로 일부 시스템 파일이나 폴더를 삭제했다면, 터미널 작동에 필요한 파일이 사라진 것일 수 있습니다.
드라이브를 포맷하지 않고 macOS를 재설치하면 초기 설정을 복원하고 'zsh: command not found' 문제를 해결할 수 있습니다. 재설치 과정에서 데이터 손실이 발생하지 않는 것이 일반적이지만, 만약을 위해 중요한 문서는 미리 백업해 두는 것이 좋습니다. 중요한 데이터를 찾을 수 없다면 재설치 후 데이터 복구를 시도해 보세요.
추가 해결 방법 3가지
방법 1: $PATH 환경 변수 확인
경로(path)는 파일 시스템 내 특정 위치를 의미합니다. 마찬가지로 터미널 명령어에서 $PATH 시스템 변수는 실행 가능한 프로그램이 담긴 여러 디렉터리를 가리킵니다. $PATH 덕분에 맥은 명령어 실행 시 어디를 찾아야 할지 알게 되므로, ls 같은 명령어를 절대 경로가 아닌 이름만으로 실행할 수 있습니다.
실행하려는 명령어의 경로가 설정되어 있지 않으면 'zsh command not found python mac' 또는 'zsh: command not found ls' 같은 오류가 발생합니다. 이 경우 명령어가 저장된 $PATH가 제대로 구성되어 있는지 확인해야 합니다.
터미널을 실행하고 다음 명령어를 입력해 macOS가 명령줄에서 사용하는 표준 경로를 설정하세요:
- export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" 입력
- 암호 입력 후 Enter 키 누르기
- 이전에 실패했던 명령어를 다시 실행해 macOS Monterey에서 오류가 재발하는지 확인. 문제가 지속되면 다음 방법으로 넘어갑니다.
방법 2: .zshrc 파일에 Zsh 명령어 경로 설정
프로그램을 설치하고 경로 변수를 설정한 뒤 터미널을 종료하고 다시 로그인해도 여전히 오류가 발생할 수 있습니다. 이럴 때는 .zshrc 파일에서 명령어 경로를 직접 편집해야 합니다. 터미널을 닫았다가 다시 열면 .zshrc 파일이 실행되어 명령어 경로가 설정됩니다. 다음 절차를 따라 .zshrc 파일을 편집해 보세요.
- macOS 터미널을 실행합니다.
- zsh를 입력하고 Enter 키를 눌러 Zsh 셸을 사용합니다.
- nano ~/.zshrc를 입력해 편집 창을 엽니다.
- $PATH 변수 정보를 추가합니다.
- Control + X, Y, Enter를 차례로 눌러 파일을 저장하고 Nano 편집기를 종료합니다.
- source ~/.zshrc 명령어를 실행해 변경 사항을 적용합니다.
방법 3: 필요한 패키지 설치 여부 확인
명령어를 실행하려고 하는데 필요한 패키지가 설치되어 있지 않은 경우가 생각보다 흔합니다. 명령어가 유효하고 철자도 정확하다면, 해당 명령어의 패키지를 맥에 설치했는지 놓치지 않고 확인하세요. 'command not found' 오류의 원인이 단순히 패키지 미설치인 경우가 많습니다.
자주 묻는 질문 (FAQ)
Q1. 맥에서 'zsh: command not found' 오류가 나타나는 이유는?
입력한 명령어가 기본 셸인 Zsh에서 인식되지 않을 때 이 오류가 표시됩니다. 명령어가 존재하지 않거나 시스템 PATH에 등록되어 있지 않다는 의미입니다. 철자를 점검하고, 해당 명령어가 설치되어 있거나 PATH 환경 변수에 추가되어 있는지 확인하세요.
Q2. 맥에 zsh 터미널을 설치하는 방법은?
- zsh를 설치하기 전에 Homebrew가 설치되어 있는지 먼저 확인합니다.
- Launchpad에서 Terminal을 검색해 실행한 뒤, 명령줄에 brew를 입력합니다. Homebrew가 없다면 관련 안내 메시지가 표시됩니다.
- Homebrew를 설치하려면 암호를 입력하고 다음 명령어를 실행합니다: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 다음 명령어로 zsh를 설치합니다: brew install zsh
Q3. 맥에서 Zsh 명령어로 전환하는 방법은?
- 터미널을 엽니다.
- zsh를 입력하고 Enter 키를 누릅니다.
- 프롬프트가 Zsh로 변경되며 Zsh 명령어를 사용할 수 있게 됩니다.
- Zsh를 기본값으로 설정하려면 chsh -s $(which zsh)를 실행한 뒤, 변경 사항을 적용하기 위해 터미널을 재시작합니다.
마무리
'zsh command not found' 오류는 주로 Bash 셸과 Zsh 셸의 차이에서 비롯됩니다. macOS 버전에 따라 호환성 문제가 발생할 수 있으므로, 맥을 최신 버전으로 업그레이드한 후 Zsh 명령어가 정상 작동하지 않는다면 위에서 소개한 방법들을 차례로 시도해 보시기 바랍니다. 또한 작업 중 데이터가 손실될 우려가 있다면 4DDiG Mac Data Recovery를 활용해 소중한 파일을 안전하게 보호할 수 있습니다.
William Bollson (수석 편집자)
William Bollson은 4DDiG의 편집장으로, 데이터 복구, 파일 손상 복구, 오류 해결을 포함한 Windows 및 Mac 관련 문제에 대한 최고의 솔루션을 제공하기 위해 노력하고 있습니다.