できない.dev

Zsh「command not found」の原因と直し方

zsh: command not found は、実行ファイルのあるディレクトリを PATH に足せば直る。
入っていなければ先にインストールする。
ls まで見つからないときは、.zshrc の PATH の書き方が壊している。

公開: 更新:

症状できない · exit 127
zsh -f -c mytool
zsh:1: command not found: mytool
解決後できた · exit 0
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:3 Alpine Linux v3.24
バージョン
  • Zsh 5.9

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. コマンドの有無を確かめる

whence -a mytool
print -l $path

whence -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 ~/.zshrc

zsh -c などにも渡すなら ~/.zshenv に書く。
読まれる順番は.zshrc が反映されない記事にある。

4. 壊した PATH を戻す

ls まで見つからないときは、開いているシェルで設定し直してから .zshrc を直す。

export PATH=/usr/local/bin:/usr/bin:/bin:$HOME/bin

CRLF は GNU や BusyBox の sed で取り除ける。

sed -i 's/\r$//' ~/.zshrc

5. カレントのスクリプトはパスを付ける

./run.sh と打つ。
実行権限が無いファイルは zsh: permission denied になる。

よくある原因

  1. インストールしていないか、名前を打ち間違えている。
    大文字と小文字は区別されるので、Ls と打っても ls は起動しない。
  2. 実行ファイルのあるディレクトリが PATH に無い。
    ~/bin に置いただけでは起動できない。
  3. 書いた設定が読み込まれていない。
    zsh は .bashrc を読まない。
    .zshrc の編集は開いているシェルに反映されず、zsh -c は .zshrc を読まない。
  4. PATH の書き方が間違っている。
    export PATH="~/bin:$PATH" はチルダが展開されず、~/bin という文字のまま入る。
    export PATH=$HOME/bin は元の値を消すので、ls まで command not found: ls になる。
    PATH = ... と空白を入れると、command not found: PATH と出る。
  5. カレントディレクトリのスクリプトを run.sh と打っている。

.zshrc の行末が CRLF のときも起きる。
export PATH="$PATH:$HOME/bin" の末尾に \r が付き、そのディレクトリのコマンドが見つからない。