site-packages
別名: site-packages ディレクトリ / user site / USER_SITE
site-packages は、pip で入れたサードパーティのパッケージが置かれる Python のディレクトリである。
起動時に site モジュールが sys.path に足すので、ここにあるパッケージを import できる。
公開:
定義
site-packages は、pip install で入れたサードパーティのパッケージが置かれる Python のディレクトリである。
Python は起動時に標準ライブラリの site モジュールを読み、存在する site-packages を sys.path の末尾に足す。
そのため、ここに入ったパッケージは import で読み込める。
詳細
場所は Python のインストール先で決まる。
Unix と macOS では sys.prefix の下の lib/pythonX.Y/site-packages、Windows では lib/site-packages になる。
ユーザーごとの置き場所(user site)もあり、Linux では ~/.local/lib/pythonX.Y/site-packages が使われる。pip install --user はこちらに入れ、環境変数 PYTHONNOUSERSITE を設定すると user site は読まれなくなる。
仮想環境を有効にすると、その環境の中の site-packages が使われる。pyvenv.cfg の include-system-site-packages が true でなければ、システム側の site-packages は探されない。python -m site を打つと、いまの sys.path と user site の場所を確かめられる。
よくある誤解
- pip の
Permission deniedは pip の不具合と思われがちだが、root が所有するシステム側の site-packages に一般ユーザーが書き込もうとして起きる。 - パッケージを入れた Python と実行する Python が違うと、site-packages も別の場所になる。
python -m pipで入れれば、そのコマンドの Python の site-packages に入る。
関連
読み込み先の一覧は sys.path、システム側への書き込みを止める仕組みは externally-managed-environment で説明している。
書き込みで失敗する例は pip install が Permission denied で失敗する にある。