代码收藏家技术教程 2024-12-16

Python：Building wheel for PyQt5-sip (pyproject.toml) did not run successfully解决方法

背景

我们在Windows平台安装PyQt5的过程中，会遇到error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/的报错，从而导致安装失败。

E:\test\pyQt5> pip install PyQt5

解决方法

本文通过两种方法解决这个问题。

方法一：安装Microsoft C++ Build Tools。

Windows平台安装过程中遇到这个错误，说明需要用到Microsoft C++ Build Tools。

大概步骤如下：

1. 下载Microsoft C++ Build Tools

a、访问微软开发工具官方下载网站：https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/

b、点击下载生成工具按钮，下载安装包。安装包只是个壳，很快就可以下载完成。

2. 安装Microsoft C++ Build Tools

运行安装包，如下图所示，点击继续按钮，进入安装界面之后，选择使用C++的桌面开发，然后点击右下角的安装，直至安装完成即可。

点击“继续”

等待安装结束。。。

3. 重新安装PyQt5

重新执行pyqt5安装命令，即可安装成功。

方法二：手动下载安装whl文件（推荐）

下载安装Microsoft C++ Build Tools，需要很长的时间，另外需要下载大量的文件，耗时费力。如果你不想那么费事，还可以手动下载whl文件，手动安装，以跳过这个错误。

1. 下载whl文件

whl下载地址：https://pypi.tuna.tsinghua.edu.cn/simple/pyqt5-sip/，比如我是Win11 64位(对应win_amd64)系统，python版本为3.13.0(对应cp313)，所以我选择了适配与我的系统和python版本的PyQt5_sip最新版本whl文件：PyQt5_sip-12.15.0-cp313-cp313-win_amd64.whl。