この記事で解決すること
pip install したらエラーが出た。何が起きているのか分からない。
この記事では、pip installでよく出るエラーを5つ取り上げて、それぞれの原因と解決方法を説明します。
エラー1: Permission denied（権限エラー）
ERROR: Could not install packages due to an EnvironmentError: [Errno 13] Permission denied
原因
システム全体のPythonにインストールしようとして、権限が足りない状態です。
解決方法
--user オプションをつけてインストールします。
pip install --user パッケージ名
もしくは、仮想環境を使うのが根本的な解決策です。
python -m venv .venv
.venv\Scripts\activate # Windowsの場合
pip install パッケージ名
仮想環境については別の記事で詳しく解説しています。
エラー2: No matching distribution found
ERROR: No matching distribution found for パッケージ名
原因
以下のどれかです。
- パッケージ名のスペルミス
- そのパッケージが自分のPythonバージョンに対応していない
- そのパッケージがOSに対応していない
解決方法
まずスペルを確認してください。大文字小文字やハイフンとアンダースコアの違いに注意。
# NG
pip install Requests
# OK
pip install requests
Pythonのバージョンを確認するには：
python --version
パッケージの対応バージョンはPyPI（https://pypi.org）で確認できます。
エラー3: Connection timeout（接続タイムアウト）
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
ERROR: Could not fetch URL https://pypi.org/...
原因
インターネット接続の問題か、会社のプロキシに阻まれています。
解決方法
まずインターネット接続を確認。接続できているなら、ミラーサーバーを使います。
pip install パッケージ名 --index-url https://pypi.tuna.tsinghua.edu.cn/simple
会社のプロキシ環境の場合：
pip install パッケージ名 --proxy http://プロキシアドレス:ポート番号
エラー4: ModuleNotFoundError（インストールしたのに見つからない）
ModuleNotFoundError: No module named 'requests'
原因
pip install したPythonと、python コマンドで動くPythonが別物です。PCに複数のPythonが入っている場合に起きます。
解決方法
python -m pip を使ってインストールします。
python -m pip install requests
これで「今動いているPython」に確実にインストールされます。
エラー5: Could not build wheels
ERROR: Could not build wheels for パッケージ名
原因
パッケージのビルドに必要なツール（C言語のコンパイラなど）がPCに入っていません。
解決方法
まず pip と setuptools を最新にします。
python -m pip install --upgrade pip setuptools wheel
それでもダメな場合は、ビルド済みのバージョンを指定してインストールします。
pip install パッケージ名==バージョン番号
まとめ
- Permission denied →
--userか仮想環境を使う - No matching distribution → スペルとPythonバージョンを確認
- Connection timeout → ネット接続確認、ミラーサーバーを使う
- ModuleNotFoundError →
python -m pip installを使う - Could not build wheels → pip/setuptools を更新
関連リソース
Pythonをもっと学びたい方へ：
リンク