PATH を理解する

インストールしたのに、見つからないと言われる

手順どおりにツールを入れて、いざ名前を打つとこう返ってきます。

mytool --version
# bash: mytool: command not found

ファイルは確かに置かれています。それでも見つからないのは、シェルが探しにいく場所を決め打ちしているからです。その場所の一覧が環境変数 PATH で、コロンで区切って並んでいます。

echo $PATH
# /usr/local/bin:/usr/bin:/bin

シェルは、名前を打たれると先頭のディレクトリから順に同じ名前のファイルを探します。全部見て見つからなければ command not found です。だからこのエラーは「入っていない」ではなく「探した場所に無い」という意味になります。入れたツールがどこに置かれたのかを確かめて、その場所を PATH に足せば解決します。

先に見つけた方が勝つ

PATH は先頭から順に見て、最初に当たったところで探索をやめます。同じ名前のファイルが複数のディレクトリにあると、前に並んでいる方だけが実行されます。バージョンを上げたのに古い方が動き続ける、という現象はこれです。

いま実際にどれが動いているかは which で分かります。候補が複数あるかどうかまで知りたいときは type -a を使います。

which python
# /usr/bin/python

type -a python
# python is /usr/local/bin/python
# python is /usr/bin/python

type -a が 2 行返したなら、上の行が勝っています。新しい方を使わせたければ、そのディレクトリを PATH の前に持ってきます。

export PATH="$HOME/tools/bin:$PATH"

前に足すと優先され、うしろに足すと既存のものが優先されます。言語のバージョン切り替えツールがやっているのも、結局この並べ替えです。仕組みを知っていると、切り替えたつもりで切り替わっていないときに自分で追えます。

:$PATH を落とすと ls すら動かなくなる

PATH を足すときの書き方には、事故になる形があります。

export PATH="$HOME/tools/bin"

これは追加ではなく置き換えです。もともと並んでいた /usr/bin などが全部消えるので、ls も grep も見つからなくなり、そのシェルではほとんど何も打てなくなります。必ず末尾に :$PATH を残して、既存の一覧を引き継いでください。

もうひとつ避けたいのが、いま居るディレクトリを PATH に入れることです。作業用のディレクトリに ls という名前のファイルが紛れ込んでいたら、それが実行されます。中身が何かは分かりません。共有サーバーでは特に危険なので、入れないでください。

区切りを改行に変えて、検索順を読む

長い一覧は、1件ずつ行を分けると順番を読みやすくなります。tr は文字を置き換えるコマンドです。次は PATH とは別の、色の一覧を表示する例です。

echo 'red:green:blue:yellow' | tr ':' '\n' | head -2
# red
# green

tr ':' '\n' はコロンを改行へ変えます。| は左の出力を右へ渡すので、1行の一覧が複数の行になり、head -2 が先頭の2行を取り出します。PATH も同じ区切りなので、この方法で検索先を先頭から読めます。

演習では元の PATH を1行で表示してから、$HOME/.local/bin を先頭に追加し、追加後の先頭3件を確かめます。元の値を残すことが大切です。区切り線や件数の表示は不要です。ひな形の末尾には、元の検索先が全体として残っているか確かめる処理も用意しています。この確認処理を書き直す必要はありません。

解説

「コマンドが動かない」と相談されたら、echo $PATH と which の 2 つから始めてください。置き場所が一覧に入っていないだけ、という結末が圧倒的に多く、数十秒で終わります。

1. echo で変更前の PATH を1行で表示する
2. export を使い、$HOME/.local/bin を PATH の先頭に追加する。既存の PATH は残す
3. 追加後の PATH を tr ':' '\n' で改行区切りにして、head -3 で先頭3件を表示する
4. 表示するのは変更前の1行と、追加後の先頭3件だけ。区切り線や件数は表示しない
5. 採点環境の HOME は /tmp、変更前の PATH は /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin である