← PC・IT用語集へ戻る

パスを通す

Add to PATH
environment development beginner
新しくインストールしたツールやコマンドを、ターミナルのどこからでも名前を呼ぶだけで使えるようにする設定のこと。
パスを通す (Add to PATH)

概要（サマリー）

パスを通すとは、新しくインストールしたツールやコマンドを、ターミナルのどこからでも名前だけで呼び出せるようにする設定のことである。

開発ツールをインストールしたのに、ターミナルでそのコマンドを打つと command not found や「認識されていません」と出る場合、この「パスを通す」作業が必要だったり、正しく反映されていなかったりすることが多い。AIから「PATHに追加してください」「環境変数にパスを通してください」と指示されたら、「そのツールの置き場所をPCに登録するんだな」と考えると分かりやすい。

詳細解説

「パスを通す」とは何か

「パスを通す」とは、あるプログラムの置き場所を、OSやターミナルにあらかじめ教えておくことである。

たとえば、ある開発ツールがPC内のどこかにインストールされていても、その場所をOS側が知らなければ、ターミナルで名前だけ入力しても実行できない。そこで、そのツールが入っているフォルダを PATH という仕組みに登録しておくと、どのフォルダにいてもコマンド名だけで呼び出せるようになる。

ここで重要なのは、PATHに追加するのは多くの場合「実行ファイルそのもの」ではなく「実行ファイルが入っているフォルダ」である。たとえば example.exe を登録するのではなく、example.exe が入っている bin フォルダを登録する、という考え方になる。

PATHはコマンドの探索先リストである

ここでいう PATH は、普通のパスとは少し違う。普通のパスは、ファイルやフォルダの場所を示す住所のような文字列である。一方、設定項目としての PATH は、コマンドを探しに行くためのフォルダ一覧である。

たとえばターミナルで次のように入力したとする。

python --version

このときPCは、「python という実行ファイルはどこにあるか」を探す。その探す先として使われるのが PATH である。

PATH には、次のような候補一覧が入っている。

/usr/local/bin:/usr/bin:/bin

MacやLinuxでは、複数のフォルダを : で区切って並べることが多い。Windowsでは、次のように ; で区切られる。

C:\Windows\System32;C:\Program Files\Git\cmd

書き方はOSによって違うが、「コマンドを探すフォルダの一覧」という役割は同じである。

なぜ「パスを通す」が必要なのか

たとえば、あるツールを次のような場所にインストールしたとする。

C:\Program Files\ExampleTool\bin

この中に example.exe があったとしても、PATHにそのフォルダが登録されていなければ、ターミナルで次のように打っても見つけてもらえない。

example --version

その場合、毎回次のようにフルパスで書く必要が出てくる。

"C:\Program Files\ExampleTool\bin\example.exe" --version

これはかなり面倒で、AIや手順書が示すコマンドとも形が変わってしまう。そこで C:\Program Files\ExampleTool\bin をPATHに追加すると、以後は example だけで実行できるようになる。

つまり「パスを通す」とは、「インストールしたツールを、コマンドとして呼び出しやすくするための設定」である。

よく必要になる場面

パスを通す作業が必要になりやすいのは、主に開発ツールを使う場面である。

たとえば、Python、Node.js、Git、パッケージマネージャー、独自のCLIツールなどをインストールしたあと、ターミナルから名前だけで使いたいときに必要になることがある。

AIや手順書から次のように指示される場面でも関係する。

git --version
python --version
tool-name login
tool-name deploy

ツール自体がインストールされていても、PATHが通っていないと「そんなコマンドはない」と表示される。初心者が「インストールに失敗した」と思いやすいが、実際には「存在するが、コマンド探索先に入っていない」だけの場合も多い。

Windowsでの考え方

Windowsでは、システム設定内の Path 項目にフォルダを追加することが多い。インストーラーに Add to PATH というチェック項目があり、そこにチェックを入れるだけで自動設定される場合もある。

また、コマンドプロンプトやPowerShellで確認するときは、次のようなコマンドが使われる。

$Env:Path

特定のコマンドがどこから見つかっているかを調べるには、PowerShellでは次のように確認できる。

Get-Command python

WindowsのPath設定には、ユーザー用とシステム用の2種類がある。自分のユーザーだけで使うならユーザー側、PC全体で使うならシステム側に設定する。ただし、システム側の変更は影響範囲が広いため、初心者は必要がない限りユーザー側に追加する方が扱いやすい。

MacやLinuxでの考え方

MacやLinuxでは、シェル設定ファイルにPATHの追加を書くことが多い。たとえばzshなら ~/.zshrc、bashなら ~/.bashrc や ~/.bash_profile などが関係する。

一時的にPATHを追加するだけなら、次のように書くことがある。

export PATH="$PATH:/usr/local/example/bin"

この書き方は、「今のPATHを残したまま、末尾に /usr/local/example/bin を追加する」という意味である。$PATH を書かずに上書きしてしまうと、もともと使えていた基本コマンドまで見つからなくなることがあるので注意が必要である。

設定ファイルを編集したあとは、ターミナルを開き直すか、次のように設定を読み直す。

source ~/.zshrc

どの設定ファイルを編集するかは、使っているシェルや環境によって変わる。AIに聞くときは、Windows、Mac、Linuxのどれを使っているかに加えて、zshやbashなどのシェル名も伝えるとよい。

「インストールしたのに使えない」の正体

初心者がよく混乱するのが、「ちゃんとインストールしたのに、なぜ使えないのか」という点である。実際には、次のような状態になっていることが多い。

  • ツール本体はインストールされている
  • 実行ファイルもPC内に存在している
  • でもPATHにそのフォルダが入っていない
  • そのため、ターミナルがコマンドを見つけられない

つまり、「存在しない」のではなく、「見つけられていない」のである。

この違いが分かると、エラーへの向き合い方が変わる。command not found が出たときに、すぐ再インストールするのではなく、「実行ファイルはどこにあるか」「PATHにそのフォルダは入っているか」「ターミナルを開き直したか」を確認できるようになる。

PATHの順番にも注意する

PATHは単なる一覧ではなく、基本的には前から順番に検索される。そのため、同じ名前のコマンドが複数の場所にある場合、先に見つかったものが実行される。

たとえば、新しいPythonを入れたのに古いPythonが実行される場合、PATHの順番が原因になっていることがある。

python --version

このコマンドで古いバージョンが表示されるときは、どの python が呼ばれているかを確認する必要がある。MacやLinuxでは次のように確認できる。

which python

WindowsのPowerShellでは、先ほどのように次のコマンドが使える。

Get-Command python

「パスを通す」は、追加すれば終わりではない。どの順番で登録されているか、どの実行ファイルが優先されているかも重要である。

パスを通しすぎるのも危険である

便利だからといって、何でもかんでもPATHに追加すればよいわけではない。

理由としては、次のような問題がある。

  • 同じ名前のコマンドがぶつかることがある
  • どのプログラムが実行されているか分かりにくくなる
  • PATHの管理が煩雑になる
  • 意図しない実行ファイルが先に見つかることがある
  • セキュリティ上望ましくない場所を探索対象にしてしまうことがある

特に、ダウンロードフォルダや誰でも書き換えられるフォルダをPATHに入れるのは避けるべきである。PATHには、本当に日常的に呼び出したいツールの、信頼できるフォルダだけを追加するのが基本である。

AIコーディングとの関係

AIコーディングでは、ツールをインストールしてすぐにコマンドを実行する流れがよく出てくる。そのため、パスを通す仕組みを知らないと、AIの指示どおりに進めているつもりでも途中で止まりやすい。

たとえばAIに次のように言われることがある。

example-cli init
example-cli deploy

このとき example-cli が見つからなければ、原因はコードではなくPATH設定かもしれない。AIに相談するときは、エラーメッセージだけでなく、OS、使っているターミナル、インストールしたツール名、実行したコマンドをまとめて伝えると原因を切り分けやすい。

Macのzshで example-cli を使おうとしています。
インストールは完了しましたが、example-cli --version を実行すると command not found になります。
PATHの確認方法と、どこに追加すべきかを順番に教えてください。

AIはPATHの確認コマンドや設定ファイルの候補を提案できる。ただし、AIが示したコマンドをそのまま実行する前に、自分のOSやシェルに合っているかを確認する必要がある。特にPATHの上書き、管理者権限での変更、システム全体のPATH変更は、影響範囲が広いので慎重に扱う。

よくある勘違い

パスを通すとは、ファイルを移動すること？

ファイルを移動することではない。パスを通すとは、ツールが入っているフォルダをPATHに登録することである。ツール本体の場所を変えるのではなく、「ここも探してよい」とOSやターミナルに教える作業である。

インストールすれば必ず自動でPATHに入る？

必ずではない。インストーラーが自動で追加してくれる場合もあるが、手動で追加が必要なツールもある。インストール時に Add to PATH のチェックを外した場合や、zipで展開しただけのツールでは、自分で設定することがある。

PATHには実行ファイルそのものを入れる？

多くの場合、実行ファイルそのものではなく、実行ファイルが入っているフォルダを入れる。たとえば example.exe ではなく、example.exe が入っている bin フォルダをPATHに追加する。

command not found は必ず未インストールという意味？

必ずしも未インストールではない。ツール本体は存在しているが、PATHに入っていないため見つけられていないだけの場合もある。再インストールする前に、実行ファイルの場所とPATHの中身を確認するとよい。

まとめ

  • パスを通すとは、コマンドの実行ファイルが入っているフォルダをPATHに追加する設定である。
  • PATHは、ターミナルがコマンドを探すためのフォルダ一覧である。
  • Windows、Mac、Linuxで設定方法や区切り文字は違うが、基本の考え方は同じである。
  • PATHの順番によって、同じ名前のコマンドのどれが実行されるかが変わることがある。
  • 便利だからといって何でもPATHに追加せず、信頼できる必要なフォルダだけを登録する。

情報ソース

より詳しくAIに聞いてみよう

  • 「パスを通す」とは何かを、中学生でもわかるように説明してください。
  • PATH と普通のファイルパスの違いを、初心者向けに整理してください。
  • Windows で PATH を追加するときの基本的な考え方を教えてください。
  • Mac で PATH を設定するとき、なぜ設定ファイルを編集するのか教えてください。
  • ツールをインストールしたのに command not found になる原因を、具体例つきで説明してください。