如何在Python 3.11环境中安装pyqt5-tools及解决安装报错？

问题背景 #

执行pip install pyqt5-tools时触发元数据生成失败，报错核心信息包括：

AttributeError: module 'sipbuild.api' has no attribute 'prepare_metadata_for_build_wheel'
sipbuild.pyproject.PyProjectOptionException

该问题源于pyqt5-tools官方未适配Python 3.9及以上版本，以下是三种可行解决办法：

解决办法 #

1. 改用PyQt6-tools（推荐） #

PyQt6的配套工具包完全支持Python 3.9+，安装命令：

pip install pyqt6-tools

安装完成后，直接通过以下命令启动Qt Designer：

pyqt6-tools designer

2. 降级Python到3.8/3.9版本 #

如果必须使用PyQt5：

• 安装Python 3.8或3.9版本（pyqt5-tools支持的最高兼容版本）
• 建议用虚拟环境隔离，避免干扰现有项目：

  # 创建虚拟环境
  python -m venv pyqt5_env
  # 激活虚拟环境（Windows）
  pyqt5_env\Scripts\activate
  # 安装pyqt5-tools
  pip install pyqt5-tools
  

3. 手动调用PyQt5自带的Qt Designer #

即使不安装pyqt5-tools，PyQt5本身也附带Qt Designer：

1. 先安装PyQt5核心库：

   pip install pyqt5
   

2. 找到designer.exe的路径：
   通常在Python安装目录的Lib\site-packages\PyQt5\Qt\bin下，例如：

   C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Lib\site-packages\PyQt5\Qt\bin\designer.exe
   

3. 直接双击运行该程序即可。

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