Windows下PyPy安装psycopg2报UnicodeDecodeError问题求助

该报错是两层问题叠加导致：

• psycopg2 2.9.x及更早版本的setup.py脚本硬编码使用ASCII编码解码pg_config命令的返回结果，只要PostgreSQL安装路径、系统临时目录、当前用户名里存在非ASCII字符（比如中文、带重音的西文字符，你报错里的0xe9就是字符é的Latin-1编码），就会直接触发UnicodeDecodeError，和PyPy版本、pip缓存无关，这也是安装psycopg2-binary也触发相同错误的核心原因。
• 你手动下载的psycopg2-2.9.3-cp38-cp38-win_amd64.whl是为CPython 3.8编译的包，PyPy的ABI标识为pp38/pp39，和CPython不兼容，因此会提示平台不支持。

方案1：临时强制Python使用UTF-8编码执行安装 #

无需修改系统配置，在当前终端会话先设置编码环境变量再执行安装即可：

• 若使用CMD终端：

set PYTHONUTF8=1
pip install psycopg2-binary

• 若使用PowerShell终端：

$env:PYTHONUTF8=1
pip install psycopg2-binary

如果执行后仍报错，可打开「控制面板-区域-管理-更改系统区域设置」，勾选Beta版：使用Unicode UTF-8提供全球语言支持，重启系统后重新执行安装命令即可。

方案2：安装适配PyPy的预编译wheel包 #

跳过本地编译流程从根源避免setup.py的编码问题：

• 下载标签为pp38/pp39、适配win_amd64平台的psycopg2-binary离线wheel包（不要下载cp开头的CPython版本包）
• 进入wheel包所在目录执行安装：

pip install 下载的wheel包全名.whl

方案3：直接替换为原生支持异步的psycopg3 #

你提到当前环境可以正常安装psycopg（即psycopg3），该版本从设计上原生支持asyncio异步调用，无需依赖aiopg作为中间层，API写法和aiopg差异极小，性能优于psycopg2+aiopg的组合，且官方对PyPy的适配更完善，是长期维护的正式方案，完全可以覆盖使用需求。

方案4：修复asyncpg编译环境 #

asyncpg安装时C扩展编译失败，是因为Windows下缺少PyPy对应的C编译环境，安装Visual Studio 2019/2022生成工具，勾选使用C++的桌面开发组件，安装完成后重启终端再执行pip install asyncpg即可正常编译安装。

• 清空pip缓存、切换PyPy 3.8/3.9版本：没有解决setup.py硬编码ASCII解码的核心问题，因此报错完全一致
• 安装低版本psycopg2：低版本psycopg2没有提供适配PyPy Windows版本的安装包，自然会触发兼容性错误
• 安装CPython版本的wheel包：PyPy和CPython ABI不兼容，无法混用

内容的提问来源于stack exchange，提问作者Charles L.