Windows 10下PyCharm配置PyPy解释器遇虚拟环境创建及NumPy安装失败
Windows 10 + PyCharm 2020.3 配置PyPy解释器的可落地解决步骤
第一步:解决PyPy虚拟环境创建失败(报ensurepip返回非零退出码2)
这个报错的本质是PyCharm 2020.3版本对Windows版PyPy的虚拟环境创建逻辑存在适配缺陷,自动调用的ensurepip命令在PyPy环境下执行权限不足或模块路径不匹配,并非PyPy本身或用户操作的问题。对应操作:
- 绕开PyCharm的自动创建流程,手动通过PyPy自带的venv模块创建虚拟环境。打开系统命令提示符,执行命令时替换为你自己的实际路径:
C:\你的PyPy安装路径\pypy3.exe -m venv 项目目录下要存放虚拟环境的文件夹路径 - 手动激活刚创建的虚拟环境,升级包管理工具的基础版本,避免后续安装包出现兼容性问题:
执行虚拟环境目录下Scripts文件夹中的activate.bat激活脚本,再运行:pypy3 -m pip install --upgrade pip setuptools wheel - 回到PyCharm的解释器配置界面,选择「Existing virtualenv environment」选项,导航到刚才手动创建的虚拟环境目录下
Scripts文件夹中的pypy3.exe作为解释器即可。 - 注:网络上“PyPy在PyCharm中仅能作为系统解释器使用”的说法是旧版本PyCharm的过时结论,只要手动完成虚拟环境创建流程,PyCharm可以正常识别PyPy的独立虚拟环境,不需要强制绑定系统路径下的PyPy可执行文件。
第二步:解决PyPy安装第三方包耗时过长、编译失败(如NumPy安装时报setup.py执行错误)
这类报错的核心原因是默认配置下pip会自动拉取源码包进行全量编译,Windows版PyPy没有内置C扩展编译环境时就会直接执行失败;加上源码编译本身耗时极长,很容易触发PyCharm的安装超时阈值。对应操作:
- 安装包时强制pip仅拉取预编译的PyPy专用wheel包,避免触发源码编译流程,命令格式为:
pypy3 -m pip install 包名 --only-binary :all:
比如安装NumPy时就执行pypy3 -m pip install numpy --only-binary :all: - 预编译包和PyPy版本存在严格对应关系,不要盲目安装最新版第三方包:PyPy3.7版本适配NumPy 1.23.x系列的预编译包,PyPy3.6版本适配NumPy 1.20.x系列的预编译包,硬装最新版包时会因为没有匹配的预编译文件触发源码编译,最终失败。
- 如果确需安装无预编译包的小众第三方包,提前在PyCharm中拉长pip安装的超时阈值:进入解释器配置的编辑界面,将默认30秒的超时时间调整为300秒,避免编译过程未完成就被PyCharm中断。
配置校验
- 解释器选中PyPy后,在PyCharm内置Python控制台执行
import sys; print(sys.version),确认输出的版本信息包含PyPy标识,没有指向CPython路径即配置正确。 - 执行
import numpy; print(numpy.__version__),包可正常导入无报错,即完成全流程配置。
内容的提问来源于stack exchange,提问作者wingedNorthropi
相关产品推荐
相关产品推荐

