MENU

コマンドが見つからないと表示されたときにパス設定を確認・修正する手順

目次

「command not found」が出る仕組みを理解する

コマンドを入力したときに次のようなエラーが表示されることがあります。

-bash: xxxxx: command not found

これは、シェルがそのコマンドの実行ファイルを見つけられなかったことを意味します。シェルはコマンドを探す際に PATH という環境変数に列挙されたディレクトリを順番に検索します。コマンドの実行ファイルがそのいずれにも存在しないか、存在してもそのディレクトリが PATH に含まれていない場合にこのエラーが発生します。

原因としては主に次の3つが考えられます。

  • コマンドがそもそもインストールされていない
  • インストール先ディレクトリが PATH に含まれていない
  • PATH の設定ファイルに記述ミスがある

まずインストールの有無を確認し、インストール済みであれば PATH の設定を見直します。

現在のPATH設定を確認する

現在の PATH の値は次のコマンドで確認できます。

echo $PATH

コロン(:)区切りで複数のディレクトリが列挙されています。シェルはここに並んだ順に各ディレクトリを検索します。

コマンドがどこにインストールされているかを調べるには which または find を使います。ただし which 自体も PATH を参照するため、PATH 外にあるファイルは見つかりません。インストール先が不明な場合は find で広く探す方が確実です。

# コマンドが PATH 内にあるかを確認する
which python3

# PATH 外も含めて実行ファイルを探す
find /usr /opt /home -name python3 2>/dev/null

コマンドのインストール先ディレクトリが判明したら、そのディレクトリが PATH に含まれているかどうかを確認します。

PATHを一時的に追加して動作を確認する

設定ファイルを変更する前に、現在のシェルセッションだけに一時的に PATH を追加して動作を確かめることができます。

export PATH=$PATH:/追加したいディレクトリ

想定例として、/opt/myapp/bin を追加するときは次のようにします。

export PATH=$PATH:/opt/myapp/bin

この方法は現在開いているターミナル(シェルセッション)の間だけ有効です。ターミナルを閉じたり、新しいシェルを開いたりすると元に戻ります。一時追加でコマンドが動くことを確認してから設定ファイルへの永続化に進むと、トラブルを防ぎやすくなります。

PATHを永続的に設定する

設定を永続化するには、シェルの設定ファイルに PATH の追記を加えます。どのファイルに書くかはシェルの種類と適用範囲によって異なります。

bash を使っている場合

多くのLinuxディストリビューションでは ~/.bashrc に追記するのが一般的です。エディタで直接開いて末尾に1行追加します。

nano ~/.bashrc

ファイルの末尾に次の行を追加して保存します。

export PATH="$PATH:/opt/myapp/bin"

コマンドで一行だけ追記する場合は次の方法も使えます。

echo 'export PATH=$PATH:/opt/myapp/bin' >> ~/.bashrc

zsh を使っている場合

~/.zshrc に同様に追記します。

echo 'export PATH=$PATH:/opt/myapp/bin' >> ~/.zshrc

システム全体に設定したい場合

全ユーザーに適用したい場合は /etc/profile.d/ 以下に .sh ファイルを作成します。root権限が必要です。

sudo tee /etc/profile.d/myapp.sh <<'EOF'
export PATH="$PATH:/opt/myapp/bin"
EOF

設定が反映されているか確認する

設定ファイルを変更した後、現在のシェルに設定を読み込ませるには source コマンドを使います。

source ~/.bashrc

その後、echo $PATH で追加したディレクトリが含まれているかを確認できます。

echo $PATH

コマンドが認識されるようになったかは which コマンドで確認できます。

which コマンド名

新しいターミナルウィンドウを開いて再度確認すると、設定ファイルが正しく読み込まれているかをより確実に検証できます。

よくあるつまずきと対処法

source を忘れて「まだ動かない」となる

設定ファイルを編集しただけでは現在のシェルセッションには反映されません。source ~/.bashrc を実行するか、新しいターミナルを開く必要があります。設定を変更した後は必ずどちらかの手順を踏むことを意識しておくと、無用な混乱を防げます。

$PATH を上書きして既存コマンドが動かなくなる

次のような書き方は、既存の PATH をすべて消してしまうため注意が必要です。

# 誤り:既存の PATH を上書きしてしまう
export PATH=/opt/myapp/bin

# 正しい:既存の PATH に追記する
export PATH=$PATH:/opt/myapp/bin

上書きしてしまった場合、同じターミナル上で正しい export コマンドを実行するか、ターミナルを再起動すると元の状態に戻ります。設定ファイルに誤った記述を書き込んでしまった場合はファイルを直接修正します。

ログインシェルとインタラクティブシェルで挙動が違う

bash では ~/.bash_profile はログイン時のみ、~/.bashrc はインタラクティブシェル起動時に読み込まれます。SSHでログインしたときだけ動かないケースや、逆にターミナルエミュレータ上では動かないケースはこの違いが原因であることがあります。

一般的には ~/.bash_profile から ~/.bashrc を読み込む設定を入れておくことで、両環境で同じ PATH を使えるようになります。

# ~/.bash_profile に追加しておくと、ログインシェルでも ~/.bashrc が読み込まれる
if [ -f ~/.bashrc ]; then
  source ~/.bashrc
fi

sudo でコマンドを実行すると見つからない

sudo はセキュリティ上の理由から、実行時に PATH を制限されたものに置き換えます。sudo 環境でもコマンドを使いたい場合は、フルパスで指定するか、env コマンドで現在の PATH を明示的に引き渡す方法があります。

# フルパスで指定する
sudo /opt/myapp/bin/mycommand

# 現在の PATH を引き継いで sudo を実行する
sudo env PATH=$PATH mycommand

「コマンドは打てる。次は"現場で通用する型"を最短で身につけたい」——そんなあなたへ。

ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。

>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)

※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次