PyPy3导入模块遇UnicodeDecodeError及NumPy安装失败求助

我之前在PyPy3的老版本上踩过几乎一模一样的坑！这个错误本质是Windows系统默认编码（GBK）和PyPy3默认UTF-8编码的冲突，加上你下载的NumPy包源码里藏了GBK编码的字符，单纯转文件编码或者改sys.setdefaultencoding根本没用，试试下面亲测有效的步骤：

第一步：彻底清理安装残留 #

• 删除之前下载解压的NumPy文件夹
• 检查PyPy3的site-packages目录，把所有带numpy的文件夹/文件全部删掉
• 打开CMD执行pypy -m pip uninstall numpy，确保没有残留的半安装状态

第二步：修改源码文件的编码声明 #

重新下载NumPy包并解压，找到这两个核心文件：

1. numpy/version.py
2. setup.py

用Notepad++打开每个文件，在最顶部第一行添加编码声明：

# -*- coding: gbk -*-

然后选择「编码」→「转为GBK编码」，保存文件（千万不要选UTF-8！）。这一步是直接告诉PyPy用GBK解码文件里的特殊字节（就是报错里的0xcd），从根源避免解码失败。

第三步：指定编码环境变量后安装 #

打开CMD，先设置系统环境变量强制编码：

set PYTHONIOENCODING=gbk

然后进入NumPy的解压目录，执行PyPy的pip安装命令：

pypy -m pip install .

第四步：验证安装 #

打开PyPy3的控制台，直接测试导入：

import numpy
print(numpy.__version__)

如果能正常打印版本号，说明问题解决了，其他模块导入也不会再触发解码错误。

为什么之前的方法没用？ #

• Python3（包括PyPy3）已经废弃了sys.setdefaultencoding，执行这个命令其实不会生效，只是自我安慰而已
• 你把文件转成UTF-8时，原本的GBK字节0xcd会被转成乱码字符，PyPy用UTF-8解码时还是会失败，反而把问题复杂化了

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