pip No matching distribution foundの直し方

ERROR: No matching distribution found for pandas==3.0.0 は、pip が、指定された名前・版で、今の Python と OS に入れられるパッケージを見つけられなかったときのエラーです。 直前の行の (from versions: ...) が、原因を見分ける手がかりです。

確認環境：pip 26.2.1、Python 3.10・3.14（Linux）（確認日 2026年10月11日）。

原因1：import の名前と、pip の名前が違う

$ pip install cv2
ERROR: Could not find a version that satisfies the requirement cv2 (from versions: none)
ERROR: No matching distribution found for cv2

プログラムに書く import cv2 の名前と、pip で入れるときの名前が違うライブラリがあります。

確認環境で、pip の名前で取得した wheel の中身を見ると、opencv-python には cv2、Pillow には PIL、PyYAML には yaml、PyJWT には jwt のフォルダーが入っていました。

注意が必要なのは、エラーにならないものです。pip install jwt で入ったのは、PyJWT ではなく、同じく import jwt で使える別のライブラリでした。サンプルコードと使い方が違うので、AttributeError などの別のエラーになります。pip の名前は、ライブラリの公式ドキュメントのインストール手順で確かめます。

原因2：Python の版が合わない

（Python 3.10 で）
$ pip install pandas==3.0.0
ERROR: Ignored the following versions that require a different python version: 3.0.0 Requires-Python >=3.11; ...
ERROR: Could not find a version that satisfies the requirement pandas==3.0.0 (from versions: 0.1, 0.2, ...)
ERROR: No matching distribution found for pandas==3.0.0

Requires-Python >=3.11：pandas 3.0.0 は Python 3.11 以上が必要で、3.10 では入れられませんでした。パッケージは、使える Python の版を情報として持っていて、pip は合わない版を候補から外します（Python Packaging User Guide）。

$ pip index versions pandas            （Python 3.10 で）
pandas (2.3.3)
Available versions: 2.3.3, 2.3.2, 2.3.1, ...

pip index versions は、今の Python で入れられる版だけを表示しました（3.10 では 2.3.3 が最新）。

逆に、Python が新しすぎる場合も同じエラーになります。出たばかりの Python の版では、ライブラリ側の対応が追いついていないことがあるので、pip index versions で入れられる版があるか確かめます。

別の Python の版で入るか、先に確かめる

pip download --no-deps --only-binary=:all: --python-version 3.12 pandas==3.0.0 -d /tmp/x

確認環境（Python 3.10）でも、--python-version 3.12 を付けると、3.12 用の wheel（pandas-3.0.0-cp312-...whl）が取得できました。 Python を入れ替える前に、その版なら入るかを確かめられます。

原因3：その OS 用のパッケージが無い

（Linux で）
$ pip install pywin32
ERROR: Could not find a version that satisfies the requirement pywin32 (from versions: none)

pywin32 は Windows 用のパッケージで、Linux では from versions: none になりました。 Windows で作った requirements.txt を、Linux のサーバーや Docker で使うと出ます。OS ごとに必要なものは、requirements.txt に条件を付けて書き分けます（pywin32; sys_platform == "win32"）。

原因4：パッケージの置き場所につながらない

$ pip install --index-url http://127.0.0.1:9/simple requests
Looking in indexes: http://127.0.0.1:9/simple
ERROR: Could not find a version that satisfies the requirement requests (from versions: none)
ERROR: No matching distribution found for requests

つながらないときも、最後は同じ from versions: none でした。 requests のように確実にある名前でも none なら、ネットワークを疑います。

確認の手順（チェックリスト）

よくある質問

Q. pip を新しくすれば直りますか。 A. 名前・Python の版・OS が原因なら、pip を新しくしても直りません。上の表で原因を確かめます。

Q. externally-managed-environment というエラーが出ます。 A. OS の Python に直接入れようとしたときの別のエラーです。関連記事の「externally-managed-environmentの直し方｜pip」で扱っています。

まとめ

• pip が入れられるパッケージを見つけられなかったエラー。from versions: で原因を見分ける
• import の名前と pip の名前が違う（cv2 → opencv-python、PIL → Pillow、yaml → PyYAML）
• jwt などは、エラーにならず別のライブラリが入る
• Requires-Python は Python の版が合わない。pip index versions で入れられる版を見る
• none は、名前・OS・ネットワークのどれか

参考・出典

確認日はいずれも 2026年10月11日です。

• pip documentation「pip index」：https://pip.pypa.io/en/stable/cli/pip_index/
• Python Packaging User Guide「Dropping support for older Python versions」：https://packaging.python.org/en/latest/guides/dropping-older-python-versions/

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。