Windows下Python3.7虚拟环境安装pycryptodome指定版本构建wheel失败
pycryptodome指定版本安装构建报错解决方案
报错核心原因
- 本次构建中断本质是pycryptodome 3.3.x系列早期版本,并未为Windows平台Python3.7提供官方预编译wheel包,pip默认拉取源码包发起本地编译时,3.3.1版本的构建脚本对Python3.7的C扩展编译流程存在兼容缺陷,因此在build_ext步骤直接异常退出,和项目依赖约束本身没有冲突。
可落地解决路径
- 优先尝试版本范围内兼容性更优的补丁版本
满足3.3.1 <= 版本 <3.4.0约束的前提下,3.3.5是3.3.x线的最后一个补丁版本,相比初始发布的3.3.1已经修复了对Python3.7的构建逻辑兼容问题,可直接执行命令验证:pip install pycryptodome==3.3.5
绝大多数场景下,这个版本可以在Python3.7 win-amd64环境下正常完成安装,不需要额外配置编译环境。 - 绕开本地编译流程,直接匹配对应预编译wheel安装
如果必须严格安装3.3.1版本,无需在本地折腾C编译环境,可直接获取和当前环境完全匹配(win-amd64、CPython 3.7版本)的pycryptodome 3.3.1预编译wheel文件,存放到本地独立目录后执行安装命令,强制pip跳过源码编译步骤:pip install --no-index --find-links=本地wheel文件存放目录 pycryptodome==3.3.1
这种方式会直接把wheel文件解压到Python对应site-packages目录,完全不会触发build_ext编译流程,从根源避开报错节点。 - 配置本地编译环境完成源码安装
如果必须从源码安装3.3.1版本,需要提前补全编译依赖:- 安装适配Python3.7要求的Visual C++ 14.0版本构建工具链,不要使用更高版本的编译工具,避免出现ABI兼容异常
- 提前在本地Python环境安装好适配老版本的构建依赖:
pip install setuptools==39.0.1 wheel==0.31.1,再禁用pip的构建隔离模式发起安装:pip install pycryptodome==3.3.1 --no-build-isolation
安装过程中如果卡在原生扩展编译,可额外加参数跳过非必要的GMP库依赖编译,进一步降低构建失败概率:pip install pycryptodome==3.3.1 --no-build-isolation --global-option=build_ext --global-option=--without-libgmp
安装前置注意事项
- 安装目标版本前,必须把环境内现存的高版本pycryptodome、旧版pycrypto包完全卸载,避免出现模块文件路径冲突,执行清理命令:
pip uninstall pycryptodome pycrypto -y
内容的提问来源于stack exchange,提问作者Robert Riley
相关产品推荐
相关产品推荐

