最近pythonを使い出したのですがPYTHONPATHというものがあると知りました。
このPATHの設定の仕方と設定する理由を教えていただけないでしょうか。
よろしくおねがいします。
2 件の回答
PYTHONPATH
とはなにか,とその設定方法について
Python の Documentation » Python Setup and Usageより:
Augment the default search path for module files. The format is the same as the shell’s PATH: one or more directory pathnames separated by os.pathsep (e.g. colons on Unix or semicolons on Windows). Non-existent directories are silently ignored.(中略)The default search path is installation dependent, but generally begins with prefix/lib/pythonversion (see PYTHONHOME above). It is always appended to PYTHONPATH.
すなわち,この環境変数は,python がモジュールを読み込む時に,デフォルト(典型的にはなんとか/lib/python(とそのバージョン)
)に加えて探しにいくディレクトリを設定するものです.記法はPATH とおなじで,Linux 系なら例えば ~/.bashrc
に
export PYTHONPATH="/path/to/the/directory/to/add:$PYTHONPATH"
のように記述しておくことで設定することができます.今何が設定されているかは echo $PYTHONPATH
などで見ることができます.
sys.path
には何が入っているか
sys.path
には PYTHONPATH
で設定したディレクトリ,デフォルトのパスに加えていくつかディレクトリが入っている場合があります.'/usr/lib/python2.7/dist-packages/gtk-2.0'
などはこの範疇ですね.
これについては英語ですが stackoverflow の この回答 が参考になります.インタープリタの起動時に (-S
をつけなければ)自動的に読み込まれる site.py
が *.pth
なファイルを読んで sys.path
にディレクトリを加えるなどし,例えば Debian や Ubuntu で /usr/local/lib/python<version>/dist-packages
にあるようなものはこのタイミングで加えられるようです.また自前で sys.path
にディレクトリを加えるようなモジュールもあるということです.
いつ設定するか
PYTHONPATH
は上のように,「追加で探して欲しい場所」を指定するものなので,apt
や pip
を使ってモジュールをインストールする分には,特段設定しなければならないことはあまりないようにおもいます.自作のモジュール(例えば ~/Documents/my/amazing/project/
下に置いてある)をどこからでも import
したいとか,どこかで見つけたモジュールを使うのだけれどシステムを汚したくないとか,そういうのが典型的な使い方だろうと思います.
import
の仕組みについて興味があれば documentation をどうぞ.この blog 記事 は簡潔でいいかも知れません.
http://docs.python.jp/2.7/using/cmdline.html#envvar-PYTHONPATH
Pythonが import
文で利用するモジュールを探す際のパスです。
以下のコードで、起動時にデフォルト設定されているパスが確認できます。
$ python
>>> import sys
>>> print(sys.path)
環境変数PYTHONPATHを設定すると、この値に追加されます。
-
['', '/usr/local/lib/python2.7/dist-packages', '/usr/lib/python2.7', '/usr/lib/python2.7/plat-x86_64-linux-gnu', '/usr/lib/python2.7/lib-tk', '/usr/lib/python2.7/lib-old', '/usr/lib/python2.7/lib-dynload', '/usr/lib/python2.7/dist-packages', '/usr/lib/python2.7/dist-packages/PILcompat', '/usr/lib/python2.7/dist-packages/gtk-2.0', '/usr/lib/pymodules/python2.7', '/usr/lib/python2.7/dist-packages/ubuntu-sso-client', '/usr/lib/python2.7/dist-packages/wx-2.8-gtk2-unicode'] これがデフォルトのパスということですか? 新しいパスの設定はしないといけないのですか?– ABECommented 2015年7月9日 5:10
-
目的によります。 開発中はPYTHONPATY (sys.path) を調整して作業を行うこともありますが、Python製アプリを利用するエンドユーザーには意識させるべきではないでしょう。 Commented 2015年7月10日 6:20