Python3.10环境下PyQt6 Designer安装失败求助

问题根源 #

你遇到的报错AttributeError: module 'sipbuild.api' has no attribute 'prepare_metadata_for_build_wheel'，本质是pyqt6-tools旧版本强制依赖的PyQt6 6.0.2不兼容Python3.10，且对应版本的sip工具缺少必要的元数据生成接口，导致安装流程中断。

解决方案 #

方案一：修复pip并安装兼容版本的pyqt6-tools #

1. 先卸载冲突的旧包，清理环境：

pip uninstall -y pyqt6 pyqt6-tools sip

2. 更新pip到最新版，避免版本兼容问题：

python -m pip install --upgrade pip

3. 直接安装适配Python3.10的pyqt6-tools新版本：

pip install pyqt6-tools --upgrade

如果需要和已安装的PyQt6版本严格匹配，比如你当前PyQt6是6.6.0，可指定对应版本：

pip install pyqt6-tools==6.6.0.3.3

方案二：使用Qt官方Designer（更稳定） #

如果pyqt6-tools安装仍有问题，可直接用PyQt6自带的官方Designer：

1. 确保已安装pyqt6-qt6包（通常安装PyQt6时会自动附带，若没有则手动安装）：

pip install pyqt6-qt6

2. 在虚拟环境路径中找到Designer：
   Windows下路径示例：venv\Lib\site-packages\PyQt6\Qt6\bin\designer.exe
3. 直接运行该exe，或在IDE（如PyCharm）中配置为外部工具，方便后续调用。

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