pip install skillspector 找不到包（No matching distribution）

你会遇到什么

pip install skillspector==2.10.0 直接报 Could not find a version that satisfies the requirement ... (from versions: none) 和 No matching distribution found。

你以为镜像源坏了，换清华、换官方都一个样——因为这个包根本不在 PyPI 上。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

skillspector 的发行渠道是 GitHub Release（wheel + sdist 资产），不是 PyPI。按 PyPI 方式安装必然失败；这是国内教程最常见的坑（部分教程写 pip install git+... 也是绕行做法）。

pip install <名字> 的背后是一次渠道寻址：pip 按名字去你配置的 index（默认 PyPI）查询，PyPI 上不存在这个名字就返回“找不到版本”。关键是渠道不是全局的——同一个软件可以选择只发布在 GitHub Release 上，而 pip 默认不认识 GitHub Release 这个渠道。

所以“换镜像源没用”是必然的：清华、官方、阿里都是 PyPI 的镜像，镜像的是同一个渠道，渠道里没有的东西镜像里也不会有。正确的做法是换渠道而不是换镜像：从 GitHub Release 下载 wheel 文件，再 pip install <文件>——这时 pip 不再按名字寻址，而是直接安装本地文件，依赖仍从 PyPI 拉（所以配国内镜像装依赖）。

这个机制还解释了三个现象：pip install git+... 能行（pip 支持直接从 git 渠道装源码）；wheel 文件名不能改（pip 从文件名解析包名/版本/平台，格式不对直接拒绝）；(from versions: none) 里的 none 意味着“该渠道没有任何版本”，是渠道问题的特征信号。

一步步来

1. 确认渠道 — 必做

pip index versions skillspector 报 No matching distribution = PyPI 无此包，别再试 PyPI 了。

2. 下载 release wheel — 必做

curl -sL -o skillspector-2.10.0-py3-none-any.whl https://gh-proxy.com/https://github.com/NVIDIA/SkillSpector/releases/download/v2.10.0/skillspector-2.10.0-py3-none-any.whl

gh-proxy 国内加速；直连 GitHub 不稳时必用。

3. pip 安装 wheel — 必做

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple skillspector-2.10.0-py3-none-any.whl

依赖走清华镜像，wheel 本体来自 GitHub Release。

4. 验证命令面 — 必做

skillspector --version

预期输出 SkillSpector v2.10.0（实测）。

怎么确认修好了

版本命令输出正确（实测输出）：

skillspector --version
→ SkillSpector v2.10.0

安装日志以 install exit=0 结束（实测闭环：wheel 下载 468K → 依赖全部安装成功）。

其它环境的表现

症状

pip install skillspector==2.10.0 报：

ERROR: Could not find a version that satisfies the requirement skillspector==2.10.0 (from versions: none)
ERROR: No matching distribution found for skillspector==2.10.0

原因

skillspector 不在 PyPI 上——发行渠道 = GitHub Release（wheel + sdist 资产）。按 PyPI 方式安装必然失败；这是国内教程最常见的坑（部分教程写 pip install git+... 也是绕行做法）。

解法

1. 正确姿势（本市场实测）：下载 release wheel 后 pip 安装：

   curl -sL -o skillspector-2.10.0-py3-none-any.whl https://gh-proxy.com/https://github.com/NVIDIA/SkillSpector/releases/download/v2.10.0/skillspector-2.10.0-py3-none-any.whl
   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple skillspector-2.10.0-py3-none-any.whl

1. 注意 wheel 文件名必须保持原样（pip 校验文件名格式，改短会报 Invalid wheel filename）。
2. 也可 pip install git+https://github.com/NVIDIA/SkillSpector.git（源码方式，国内直连不稳）。