VS Code中使用pip安装PyQt5报preparing wheel metadata错误如何修复

问题根因 #

你安装的Microsoft C++ Build Tools无异常，本次报错是两个核心兼容问题导致：

• 当前尝试安装的PyQt5 5.14.1版本不支持Python 3.10，该版本最高兼容Python 3.8，低版本PyQt5在高版本Python环境下无法通过源码编译生成wheel
• 自行下载的wheel文件和当前Python版本、操作系统架构（32/64位）不匹配，因此提示平台不支持

修复步骤 #

1. 先升级pip、setuptools、wheel到最新版本
   打开VS Code终端执行命令：
   python -m pip install --upgrade pip setuptools wheel
2. 安装适配Python3.10的高版本PyQt5
   直接执行命令即可自动拉取适配版本：
   pip install PyQt5>=5.15.4
   如需固定版本，可使用指定版本命令：
   pip install PyQt5==5.15.10
3. 若仍需手动安装wheel包
   先执行以下命令确认当前Python的版本和架构：
   python --version
python -c "import platform;print(platform.architecture()[0])"
   手动下载wheel时需选择文件名同时包含cp310（对应Python3.10）和win_amd64（对应64位Windows系统，32位选win32）的安装包，再执行命令安装：
   pip install 你下载的wheel文件完整路径.whl
4. 若必须使用PyQt5 5.14.1版本
   需要将Python版本降级到3.8及以下，再执行安装命令即可正常完成安装。

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