M1 Mac에서 "zsh: command not found" 오류 해결하기

 

(M1) zsh: command not found

 

맥(Mac) 사용자들이 터미널에서 명령어를 실행할 때

"zsh: command not found"라는 오류 메시지를 마주하는 경우가 종종 있습니다.

이 글에서는 이 오류의 원인과 해결 방법을 설명하겠습니다.

 

개발을 하나도 모르고 이곳에 입문하여 가지고 있는 맥북으로 연습해 보려 했는데

위와 같은 에러가 떠서 참 당황했었습니다.

인터넷에서 하라는 데로 마구잡이로 따라 하는데 문제 해결도 안 되고..

친절히 왜 이런 문구가 뜨는지 이유를 설명해 주거나

알려주는 해결 방법은 어떤 부분을 왜 건드려서 해결이 되는 건지

친절하게 알려주는 블로거분들이 많이 없더라고요

 

그래서 준비했습니다.

쉽게 써보겠지만 제 설명 또한 어려울 수 있습니다.

댓글로 물어봐 주시면 성심성의껏 답변해 드리도록 하겠습니다

---

먼저 여기서 나오는 command not found 에러는

이 오류는 시스템이 특정 명령어의 실행 파일을 찾지 못할 때 발생합니다.

이는 보통 환경변수 PATH에 해당 명령어의 위치가 포함되어 있지 않을 때 발생합니다.

무슨 말이냐 하면 검색 경로 문제에 따른 에러입니다.

즉 시스템에서 명령을 사용할 수 없거나 검색 경로에 명령 디렉터리가 없다는 뜻이죠

환경변수 PATH 이해하기 PATH는 운영 체제가 실행 파일을 찾기 위해 참조하는 디렉토리들의 목록입니다. 적절한 경로가 PATH에 추가되어 있지 않다면 시스템은 필요한 실행 파일을 찾을 수 없습니다.

 

우리는 위 에러를 해결하기 위해서 zshrc 파일을 수정하여 환경 변수를 설정해야 합니다.

여기서 말하는 zsh란 무엇일까요?

바로 셸이라는 것인데요 우리는 셸이 무엇인지에 대해 알고 넘어갈 필요가 있습니다.

아래 글에서 셸에 대해 알아보고 넘어가 보도록 하죠

(작성 중)

 

위처럼 zsh가 아니라 아래처럼 에러가 뜨시는 분들도 계실 겁니다.

"bash: command not found: nvm"

 

zsh 셀을 사용하는 저 같은 사람들은

vi ~/. bash_profile

위에 경로에서 에러를 수정하라는 만연히 퍼져있는 블로그를 따라 해도 전혀 문제가 해결되지 않으실 겁니다.

반대로 bash 셸을 사용하시는 분들은 제 블로그 글을 따라 해도 문제 해결이 되지 않겠죠!

왜냐하면 사용하는 셸 (zsh or bash)에 따라 해결법은 다르니까요!

 

현재 내가 사용 중인 셸이 어떤 건지 확인하고 싶으시다면 아래처럼 터미널에 적어보세요

echo $SHELL

---

Zshrc 파일 수정

지금부터 M1 사용자 중 zsh: command not found라는 오류 메시지가 나오는 분들을 위해 해결 방법을 공유드립니다.

시작 위치는 터미널입니다.

open ~/.zshrc
vim ~/.zshrc
vi ~/.zshrc

터미널에서 open ~/.zshrc, vim ~/.zshrc, 또는 vi ~/.zshrc 중 하나를 입력합니다. (vs code를 사용한다면 code ~/.zshrc를 사용하여 편집기를 열어주시면 됩니다)

 

 

위와 같은 창이 뜨신다면 i를 눌러주세요 (편집 모드입니다) 편집모드로 전환한 후, 맨 아래 줄에다가 export PATH="$HOME/your_directory:$PATH"를 추가합니다. (여기서 your_directory는 해당 명령어의 위치입니다.) EX) export workzone="$HOME/workzone" 자신의 경로를 잘 모르시겠다면 :q로 나가신 후 cd~ pwd /users/홍길동(계정명) 위와 같이 터미널에서 cd ~를 치신 후 pwd를 쳐보시면 /Users/홍길동(계정명) 이 뜰 텐데, 이럴 경우라고 할때 써야하는 내용은 export workzone="$HOME/홍길동" 이 되는 겁니다. 다시한번, 저는 컴퓨터 이름으로 JD라고 설정했습니다. 그럼 제가 써야 할 내용은 export workzone="$HOME/JD" 이 되겠네요.

 

다시 돌아와서 환경 변수를 적어주었습니다.

이제 :wq를 입력하여 저장하고 종료합니다.

 

항상 환경변수를 수정하면 저장을 하고 새로고침을 해서 적용을 해주어야 하는데요

source ~/. zshrc를 실행하여 변경 사항을 적용합니다.

 

 

 

위에 설정한 환경변수는 어떤 내용일까요?

원래는 특정 디렉터리로 이동하기 위해 /usr/bin/test/test2/ 이런 식으로 하나 하나 이동해야 하는 명령어를 cd $test2로
한 번에 이동하기 위해 변경되었습니다.
이제 cd $workzone 만으로 해당 경로로 이동할 수 있습니다. (다시 한번 말하지만 workzone은 다 다릅니다)

 

잘 적용됐는지 확인해 볼까요? 아래와 같이 터미널에서 타이핑해보세요 여기서 workzone은 변경되어야겠죠?

echo $workzone
cd $workzone

---

위의 방법으로 해결이 안 될 경우를 대비한 방법입니다.

 

homebrew 설치

 

Homebrew는 macOS (및 Linux) 용 패키지 관리자입니다.

패키지 관리자란 소프트웨어 설치, 업데이트, 구성 및 제거를 자동화하는 도구입니다.

Homebrew를 사용하면 명령줄 인터페이스를 통해 소프트웨어를 쉽고 빠르게 설치하고 관리할 수 있습니다.

 

터미널에서 cd /opt; sudo mkdir homebrew를 입력하여 Homebrew를 설치할 디렉토리를 생성합니다. curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew를 실행하여 Homebrew를 다운로드합니다. echo "export PATH=/opt/homebrew/bin:$PATH" >> ~/.zshrc를 입력하여 Homebrew의 경로를 환경변수에 추가합니다. /bin/bash -c "$(curl -fsSL https://gist.githubusercontent.com/nrubin29/bea5aa83e8dfa91370fe83b62dad6dfa/raw/48f48f7fef21abb308e129a80b3214c2538fc611/homebrew_m1.sh)"를 실행하여 설치를 완료합니다.

cd /opt
sudo mkdir homebrew
curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew
echo "export PATH=/opt/homebrew/bin:$PATH" >> ~/.zshrc
/bin/bash -c "$(curl -fsSL https://gist.githubusercontent.com/nrubin29/bea5aa83e8dfa91370fe83b62dad6dfa/raw/48f48f7fef21abb308e129a80b3214c2538fc611/homebrew_m1.sh)"

 

zsh: command not found 해결 완료

---

궁금하신 사항은 댓글에 남겨주세요

댓글에 남겨주신 내용은

추후 정리해서 올려드리겠습니다

이웃 신청하시면 업로드 시 알려드릴게요!

-

조금이라도 도움이 되셨다면

공감&댓글 부탁드리겠습니다

감사합니다!