Ubuntu 20.04下pip拒绝安装wheel包故障排查求助

1. pip拒绝安装wheel包的具体原因 #

核心原因是系统1的Python运行环境为PyPy，而非标准CPython实现。你尝试安装的所有二进制wheel包命名中带cp36标记，仅适配CPython 3.6版本，不兼容PyPy运行时。
补充验证：系统1的python --version输出明确标注[PyPy 7.3.1 with GCC 7.3.1 ...]，而安装成功的系统2使用的是标准CPython 3.6.15，和wheel包的cp36标记完全匹配。
另外你提到的系统1虚拟环境默认自带的cffi、greenlet包也是PyPy运行环境的默认依赖，进一步验证了运行环境的差异。

2. 输出pip拒绝安装的具体不匹配原因的方法 #

执行安装命令时添加-vvv（三重verbose）参数即可输出完整的匹配校验过程，会明确打印当前pip支持的平台标签列表、以及待安装wheel的标签不匹配的具体原因：

pip install -vvv --no-cache-dir --only-binary :all: <包名或wheel路径>

另外也可以直接执行pip debug --verbose命令，直接打印当前pip环境支持的所有合法wheel标签，和待安装wheel的命名标签做对比即可快速定位差异。

3. 问题排查与解决方法 #

排查步骤 #

• 首先确认当前Python实现类型，执行以下命令即可明确：

python -c "import platform; print(platform.python_implementation())"

输出为CPython则是标准实现，输出为PyPy则为PyPy实现。

• 执行pip debug --verbose查看支持的标签列表，和待安装wheel的标签做对比，确认不匹配项。

解决方法 #

根据你的使用场景二选一即可：

• 方法1：切换为标准CPython 3.6环境。用pyenv安装官方CPython 3.6版本，重新创建虚拟环境后再执行安装操作，和系统2保持一致即可直接安装对应cp36标记的二进制包。
• 方法2：适配当前PyPy环境。可以移除安装命令中的--only-binary :all:参数，允许pip从源码编译安装对应包（需要提前安装gcc、python-dev等编译依赖）；也可以手动查找对应PyPy版本的预编译二进制wheel包进行安装。

内容的提问来源于stack exchange，提问作者blueFast