できない.dev

Bash で PATH に追加したのに command not found が消えない

.bashrc に export PATH=... を書いても効かないのは、そのシェルがどの起動ファイルを読むかが起動の種類で違うためである。
対話ログインシェルは .bash_profile 系を読み、対話非ログインシェルは .bashrc を読む。

公開: 更新:

症状できない · exit 127
bash -l -c hello
bash: line 1: hello: command not found
解決後できた · exit 0
bash -l -c hello
hello from .local/bin

2026-10-17 に node:20(Bash 5.2.15 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

PATH を通したはずなのに command not found が消えないとき、設定内容ではなく 書いたファイルがそのシェルで読まれていない ことがほとんどである。
Bash はシェルの種類によって読む起動ファイルを変える。

$ echo $PATH
/usr/local/bin:/usr/bin:/bin      # 追加したはずの ~/.local/bin が無い
$ grep PATH ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"   # 書いてはある

書いた場所は合っているのに反映されない、という状態である。
まずどの起動ファイルが読まれるシェルなのかを確かめる。

実行例

~/.bashrc にだけ PATH を足したホームでログインシェル(bash -l)からコマンドを呼ぶと、.bashrc が読まれず、終了コード 127 の command not found になった。
echo $PATH にも ~/.local/bin は出てこなかった。
~/.bash_profile から ~/.bashrc を読み込ませると、同じ呼び出しが通った。
type -a でも、~/.local/bin 側のコマンドが引かれていると確認できた。

$ cat .bashrc
export PATH="$HOME/.local/bin:$PATH"
$ bash -l -c hello
bash: line 1: hello: command not found
$ echo $?
127
$ bash -l -c 'echo $PATH'
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
$ cat .bash_profile
[ -f ~/.bashrc ] && . ~/.bashrc
$ bash -l -c hello
hello from .local/bin
$ echo $?
0
$ bash -l -c "type -a hello"
hello is /tmp/tmp.dzBFg5ZRke/.local/bin/hello

— 2026-10-17 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-17 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • Bash 5.2.15

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

解決策

1. .bashrc に書き、.bash_profile から読ませる

# ~/.bash_profile
[ -f ~/.bashrc ] && . ~/.bashrc
# ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"

設定の実体は .bashrc に一本化し、.bash_profile は橋渡しだけにする。
こうするとログイン・非ログインのどちらでも同じ PATH になる。

2. 現在のシェルに反映する

source ~/.bashrc
echo $PATH

新しいターミナルを開き直しても同じ結果になる。

3. どこから引かれているかを見る

type -a python3

複数出るときは上に出たものが実際に使われる。
意図しないパスが先勝ちしているなら、追記の順序($PATH の前に置くか後ろに置くか)を見直す。

よくある原因

  1. ログインシェルは .bashrc を読まない。
    Bash Startup Files(新しいタブで開く) のとおり、対話ログインシェルは /etc/profile を読んだあと ~/.bash_profile・~/.bash_login・~/.profile をこの順に探し、最初に見つかった 1 つだけを読む。
    対話非ログインシェルが読むのは ~/.bashrc である。
  2. .bash_profile が .profile を潰している。
    .profile に書いたのに効かない場合は、.bash_profile が存在していて、そちらが優先されている。
  3. 編集した内容を反映していない。
    ファイルを編集しただけでは、現在のシェルの PATH は変わらない。
  4. export を忘れた。
    PATH=... だけではシェル変数にとどまり、そこから起動したコマンドには渡らない。
  5. 非対話シェルで動かしている。
    cron や CI のステップはどの起動ファイルも読まないため、対話シェルでは通るのにジョブでは落ちる。