Windows 11环境下安装psycopg2时wheel构建失败求助

问题背景 #

环境信息：

• Django==4.1.2
• Python==3.11.0
• PIP==22.3
• OS==Win11

执行pip install psycopg2或pip install psycopg2-binary时均报错：

ERROR: Failed building wheel for psycopg2
Running setup.py clean for psycopg2
Failed to build psycopg2
Installing collected packages: psycopg2
Running setup.py install for psycopg2 ... error
note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

已尝试升级wheel/setuptools、使用python -m pip安装、安装Microsoft C++ Build Tools，但问题未解决。

针对性解决方案 #

1. 指定兼容Python3.11的psycopg2-binary版本 #

psycopg2-binary从2.9.5版本开始正式支持Python3.11，直接安装该版本或更高兼容版本：

pip install psycopg2-binary==2.9.5

2. 手动下载对应whl文件本地安装 #

1. 找到匹配Python3.11、Win11 64位的psycopg2-binary whl文件（文件名格式类似psycopg2_binary-2.9.5-cp311-cp311-win_amd64.whl）
2. 在虚拟环境中执行本地安装命令：

pip install 下载的whl文件完整路径

3. 确认Microsoft C++ Build Tools组件安装完整 #

若选择编译安装原生psycopg2而非binary版本，需确保Build Tools安装了以下组件：

• 勾选**Desktop development with C++**工作负载
• 包含MSVC v142+ 生成工具、Windows 11 SDK组件
  安装完成后重启终端或电脑，再尝试执行pip install psycopg2

4. 验证虚拟环境Python版本 #

确认当前虚拟环境使用的是Python3.11：

python --version

若版本不符，需重新创建基于Python3.11的虚拟环境后再尝试安装。

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