MacでPythonパス（PYTHONPATH）を設定する方法をわかりやすく解説

Mac OSでPythonのモジュールやパッケージを、標準以外のディレクトリからもインポートできるようにしたい場合、「PYTHONPATH」という環境変数を設定します。この記事では、ターミナルを使った基本的な設定方法と、その際の注意点を解説します。

PYTHONPATHとは？

PYTHONPATHは、Pythonがモジュールやパッケージを検索する際に参照する追加のディレクトリを指定するための環境変数です。ここにパスを追加することで、Pythonはデフォルトの検索場所に加えて、指定したディレクトリ内も探すようになります。

ターミナルでの設定方法

Macのターミナルを開き、以下のコマンドを実行します。この例では、ホームディレクトリ直下にある「foo」ディレクトリをPYTHONPATHに追加しています。

$ export PYTHONPATH=${PYTHONPATH}:${HOME}/foo

このコマンドのポイントは、既存のPYTHONPATHの値を上書きせずに追記しているという点です。「${PYTHONPATH}:」の部分がそれまでの設定値を保持し、その後ろに新しいパス「${HOME}/foo」を連結しています。もし既存の値を消してしまうと、これまで動いていたモジュールの読み込みが壊れる可能性があるため、必ずこの形式で追記しましょう。

設定を永続化させるには

上記のexportコマンドによる設定は、ターミナルのセッションが終了すると失われます。恒久的に反映させたい場合は、シェルの設定ファイルに追記してください。最近のmacOSはデフォルトシェルがzshのため、以下のように~/.zshrcに記述します。

$ echo 'export PYTHONPATH=${PYTHONPATH}:${HOME}/foo' >> ~/.zshrc
$ source ~/.zshrc

bashを使用している場合は、~/.bash_profileまたは~/.bashrcに同様の行を追加してください。

設定時の注意点

多くの場合、PYTHONPATHを直接編集する必要はありません。むしろ、不用意に変更するとモジュールのインポートエラーやバージョンの衝突など、予期しないトラブルの原因になりがちです。

• プロジェクトごとの依存関係管理には、仮想環境（venvやvirtualenv）の利用を推奨します。
• 一時的にパスを通したいだけなら、実行時に指定する方法もあります：

  $ PYTHONPATH=/path/to/dir python script.py

• どうしても設定が必要な場合は、既存の値を壊さず「追記」することを徹底しましょう。

正しく理解して使えば便利なPYTHONPATHですが、まずは仮想環境など標準的な手法で対応できないか検討するのが安全です。