ツール
pip
Python 標準のパッケージインストーラ。PyPI から配布物(wheel / sdist)を取得し site-packages に依存パッケージを導入する。pip install の依存解決、requirements.txt による固定、仮想環境(venv)内外でのインストール先、PEP 668 の externally-managed-environment、C 拡張の wheel ビルド失敗、pip と pip3 の取り違えなど pip 固有の問題を扱い、言語仕様やスクリプト実行は Python 側が担当する。
問題一覧(8)
pip install で wheel のビルドに失敗する
wheel が公開されていない sdist は手元でビルドが走るため、C / Rust 拡張に必要なコンパイラやヘッダが揃っていないと失敗する。ビルドツールチェインを入れる、wheel が出ている Python に合わせる、setuptools / pip を更新するで切り分ける。
更新: 2026-10-03、タグ: wheel、build、c-extension
pip「command not found」「No module named pip」の原因と直し方
pip の command not found は、python -m pip で呼べば大半は回避できる。No module named pip なら pip 本体が無いので、ensurepip か OS パッケージで入れる。
更新: 2026-10-31、タグ: path、command-not-found、ensurepip
pip install が「error: externally-managed-environment」で失敗する(PEP 668)
error: externally-managed-environment は、OS 管理の Python に直接 pip install すると出る。venv を作って有効化するか、CLI ツールは pipx で入れれば直る。
更新: 2026-09-10、タグ: pep-668、venv、break-system-packages
pip install で「No matching distribution found」が出てインストールできない
No matching distribution found は、今の Python / OS / CPU に合う配布物が無いと出る。pip index versions で実在するバージョンを確かめ、合うものを指定し直せば直る。
更新: 2026-09-04、タグ: install、distribution、version
pip install が Permission denied で失敗する
システム Python のサイトパッケージは root 所有のため、ユーザ権限の pip install は書き込みに失敗する。venv を作るのが正攻法で、--user オプションや pipx も選択肢。sudo pip は環境破壊につながるため避ける。
更新: 2026-08-31、タグ: permission、venv、pipx
pip「Could not open requirements file」の原因と直し方
Could not open requirements file は、-r に渡したパスにファイルが無いと出る。ファイルのあるディレクトリへ移動するか、-r に正しいパスを渡せば直る。
更新: 2026-10-15、タグ: requirements、install、path
pip install が「SSL: CERTIFICATE_VERIFY_FAILED」でインストールできない
SSL: CERTIFICATE_VERIFY_FAILED は、pip が接続先の証明書を検証できないと出る。社内 CA を --cert や pip config で渡すか、pip を 24.2 以降に上げれば直る。
更新: 2026-10-15、タグ: ssl、certificate、proxy
pip をアップグレードできない(pip install --upgrade pip が失敗する)
Windows では pip.exe が自分自身を上書きできず Access is denied で失敗するのが定番。python -m pip install --upgrade pip と python -m 経由で実行する。権限エラーや PEP 668 の拒否は venv 内で行うのが基本。
更新: 2026-10-12、タグ: upgrade、windows、permission