pip install で「No matching distribution found」が出てインストールできない

要約

ERROR: Could not find a version that satisfies the requirement No matching distribution found は、pip が ターゲット環境に合う配布物（wheel / sdist）を見つけられなかった ことを意味する。
バージョン指定の誤り、Python / OS / アーキ向け wheel の不在、ミラーの同期遅れ、を順に切り分ける。

よくある原因

1. バージョン誤指定: ==1.99.0 のように存在しないバージョンを指定している、または yank された版を要求している
2. プラットフォーム不一致: 現在の Python マイナーバージョン / OS / アーキ向けの wheel が公開されていない（M1 Mac で x86_64 のみ、など）
3. ミラーの同期遅れ: 社内 PyPI に新版がまだ届いていない
4. sdist のみ: wheel が無く .tar.gz だけのパッケージで、コンパイラ不在のためビルドできない

解決策

1. 公開バージョンを確認

pip index versions requests
# requests (2.32.3)
# Available versions: 2.32.3, 2.32.2, ...

pip index versions で実在バージョンを取得できる（公式 pip install ドキュメント 参照）。
誤指定なら直す。

2. ターゲット tag を確認

pip debug --verbose
# Compatible tags: ...
# cp311-cp311-manylinux2014_x86_64
# ...

ここに出る tag に合致する wheel が PyPI 上に無ければ、現在の Python では入らない。
Python のマイナーバージョンを wheel が出ているものに揃える。
詳細は pip debug の公式ドキュメント を参照。

3. 本家 PyPI で再検証

pip install --index-url https://pypi.org/simple <pkg>

社内ミラー経由で失敗するときは本家を直接叩いてみる。
本家で成功すれば ミラー側の同期遅れ と切り分けられる。

4. sdist しか無いパッケージ

# C 拡張を含むなら
sudo apt-get install build-essential python3-dev
# Rust 拡張なら
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pip install <pkg>

No matching distribution の代わりに途中まで進んでビルド失敗に変わる場合は、必要なツールチェインを入れる。