Zsh「command not found」の原因と直し方
zsh: command not found は、実行ファイルのあるディレクトリを PATH に足せば直る。
入っていなければ先にインストールする。
ls まで見つからないときは、.zshrc の PATH の書き方が壊している。
公開: 更新:
zsh -f -c mytool zsh:1: command not found: mytool
zsh -i -c mytool mytool ok
2026-11-14 に alpine:3(Zsh 5.9) で実際に打って取った出力。検証環境の詳細
要約
zsh: command not found: pnpm は、zsh が $path のどのディレクトリにもその名前の実行ファイルを見つけられないときに出る(公式ドキュメント(新しいタブで開く))。
実行ファイルのあるディレクトリを PATH に足せば直る。
入っていなければ先にインストールする。
zsh 5.9 では、zsh -c が zsh:1: command not found: mytool、スクリプトが s.zsh:1: command not found: mytool と出した。
終了コードはどれも 127 である。
実行例
alpine:3 の Zsh 5.9 では、PATH に無い mytool が command not found と終了コード 127 になった。.zshrc に PATH を足しても zsh -c では見つからず、zsh -i -c では通った。
CRLF の .zshrc は 127 になり、sed で CR を取ると通った。
$ zsh -f -c mytool
zsh:1: command not found: mytool
$ echo $?
127$ zsh -f -c "whence -a mytool"
$ echo $?
1$ zsh -f -c 'print -l $path'
/usr/local/sbin
/usr/local/bin
/usr/sbin
/usr/bin
/sbin
/bin$ zsh -f -c 'export PATH="~/bin:$PATH"; mytool'
zsh:1: command not found: mytool
$ echo $?
127$ zsh -f -c 'export PATH=$HOME/bin; ls'
zsh:1: command not found: ls
$ echo $?
127$ zsh -f -c 'export PATH=/usr/local/bin:/usr/bin:/bin:$HOME/bin; mytool'
mytool ok
$ echo $?
0$ zsh -c mytool
zsh:1: command not found: mytool
$ echo $?
127$ zsh -i -c mytool
mytool ok
$ echo $?
0$ zsh -i -c mytool
zsh:1: command not found: mytool
$ echo $?
127$ sed -i 's/\r$//' /root/.zshrc$ zsh -i -c mytool
mytool ok
$ echo $?
0— 2026-11-14 時点の出力
検証環境Zsh 5.9 / 2026-11-14 検証
- 検証日
- 実行環境
alpine:3Alpine Linux v3.24- バージョン
- Zsh 5.9
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. コマンドの有無を確かめる
whence -a mytool
print -l $pathwhence -a は見つかった場所を表示し、無ければ何も出さない。print -l $path は探す先を 1 行ずつ表示する。
実行ファイルの場所は find / -type f -name mytool 2>/dev/null で探せる。
無ければインストールする。pnpm の手順は pnpm の記事にあり、ほかのツールは下の関連記事を読む。
2. .zshrc で PATH に足す
export PATH="$HOME/bin:$PATH"クオートの中では $HOME を使う。PATH と連動する配列を使って path=(~/bin $path) と書いても動く。
3. 設定を読み直す
source ~/.zshrczsh -c などにも渡すなら ~/.zshenv に書く。
読まれる順番は.zshrc が反映されない記事にある。
4. 壊した PATH を戻す
ls まで見つからないときは、開いているシェルで設定し直してから .zshrc を直す。
export PATH=/usr/local/bin:/usr/bin:/bin:$HOME/binCRLF は GNU や BusyBox の sed で取り除ける。
sed -i 's/\r$//' ~/.zshrc5. カレントのスクリプトはパスを付ける
./run.sh と打つ。
実行権限が無いファイルは zsh: permission denied になる。
よくある原因
- インストールしていないか、名前を打ち間違えている。
大文字と小文字は区別されるので、Lsと打ってもlsは起動しない。 - 実行ファイルのあるディレクトリが
PATHに無い。~/binに置いただけでは起動できない。 - 書いた設定が読み込まれていない。
zsh は.bashrcを読まない。.zshrcの編集は開いているシェルに反映されず、zsh -cは.zshrcを読まない。 PATHの書き方が間違っている。export PATH="~/bin:$PATH"はチルダが展開されず、~/binという文字のまま入る。export PATH=$HOME/binは元の値を消すので、lsまでcommand not found: lsになる。PATH = ...と空白を入れると、command not found: PATHと出る。- カレントディレクトリのスクリプトを
run.shと打っている。
.zshrc の行末が CRLF のときも起きる。export PATH="$PATH:$HOME/bin" の末尾に \r が付き、そのディレクトリのコマンドが見つからない。