Pip Error Reference in Japanese｜pip エラー対応表

できること

• エラーの英文をそのまま検索して、該当する項目を見つけられます
• どの項目も、仮想環境を使うなど環境を壊さない直し方を先に書いています
• sudo pip や --break-system-packages などは「注意」として分けています
• 各項目に pip 公式ドキュメントの URL を付けています
• 同梱の repro.py で、手元の pip でも文言を確かめ直せます
• check.py で、表の形と直し方の安全さを確かめられます

できないこと

• pip 25.1.1 以外では、文言が少し違うことがあります
• OS の Python・root・Windows でだけ出る3件は、再現していません（表に明記）
• 確かめたのは Linux だけです。Windows と macOS では試していません
• conda・poetry・uv など、ほかの道具のエラーは入っていません
• すべての場面に合う直し方ではありません

サンプル

サンプル（errors.md の項目をそのまま写したものです）

resolution-impossible

ERROR: Cannot install appa==1.0 and appb==1.0 because these package versions have conflicting dependencies.
ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts

• 起きるとき：同時に入れる2つが、同じ依存先の別々の版を求めるとき
• 原因：The conflict is caused by の行にある通り、両方を満たす版が無い
• 安全な直し方：版の指定をゆるめるか、片方を別の仮想環境に分ける

python -m pip install appa
python -m venv .venv-appb

• 再現：再現済み（pip 25.1.1）
• 公式ドキュメント：https://pip.pypa.io/en/stable/topics/dependency-resolution/
• 確認日：2026-10-28

hash-mismatch

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.

• 起きるとき：requirements に書いたハッシュと、取ってきたファイルのハッシュが違うとき
• 原因：版を上げたのにハッシュを直していないか、ファイルが書き換えられた
• 安全な直し方：まず配布元を確かめ、正しいファイルのハッシュを書き直す

python -m pip hash ./demo-1.0-py3-none-any.whl

• 再現：再現済み（pip 25.1.1）
• 公式ドキュメント：https://pip.pypa.io/en/stable/topics/secure-installs/
• 確認日：2026-10-28

permission-denied

ERROR: Could not install packages due to an OSError: [Errno 13] Permission denied: '<TMP>/venv/lib/python3.13/site-packages/demo'
Check the permissions.

• 起きるとき：入れる先のフォルダに書き込む権限が無いとき
• 原因：Python が置かれた場所が、今のユーザーでは書き込めない
• 安全な直し方：自分のフォルダに仮想環境を作り、その中に入れる

python3 -m venv .venv
.venv/bin/python -m pip install demo

• 注意：sudo pip は OS の Python を書き換え、OS の道具を壊しうる

sudo pip install demo

• 再現：再現済み（pip 25.1.1）
• 公式ドキュメント：https://pip.pypa.io/en/stable/cli/pip_install/
• 確認日：2026-10-28

出どころ

確認済み

• メッセージ：pip 25.1.1（Python 3.13.5、Linux）が実際に出した文言。repro.py で再現（2026-10-28）
• 再現なしの3件：pip 25.1.1 のソースにある文言を確かめました
• 直し方の根拠：pip 公式ドキュメント（https://pip.pypa.io/en/stable/）の10ページ
  • pip install、依存関係の解決、安全なインストール、HTTPS 証明書、要件の書き方、requirements ファイル、ビルドの仕組み、pip uninstall、pip check、ユーザーガイド
  • 取得 2026-10-28 00:41 JST。URL と sha256 は src/SOURCE.txt にあります
• この商品には、ドキュメントの本文を入れていません
• 説明文は、すべて自前で書いた日本語です