できない.dev

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 で失敗する にある。