使用pyuic5转换Qt Designer的.ui文件出现语法错误求助

问题根源 #

核心原因是Qt Designer的版本与你使用的pyuic工具版本不匹配：

• Qt 5对应的转换工具是pyuic5，Qt 6对应的是pyuic6
• 如果你用Qt 6的Designer创建.ui文件，却用pyuic5（Qt 5的工具）转换，工具无法正确解析Qt 6的枚举命名空间，就会直接输出C++风格的::语法，而非Python需要的.语法。

解决步骤 #

1. 确认版本匹配

   • 打开Qt Designer，通过「帮助」→「关于」查看Qt版本号（比如Qt 5.15.2或Qt 6.5.0）
   • 在终端执行对应命令查看工具版本：
     • Qt 5：pyuic5 --version
     • Qt 6：pyuic6 --version
   • 确保两者的大版本号一致（都是5.x或都是6.x）

2. 使用对应版本的转换工具

   • 如果是Qt 5的Designer，继续用pyuic5：

     pyuic5 -x MainMenu.ui -o MainMenu.py
     

   • 如果是Qt 6的Designer，替换为pyuic6：

     pyuic6 -x MainMenu.ui -o MainMenu.py
     

3. 检查Python环境依赖

   • 如果你用虚拟环境，确保环境中安装的是对应版本的PyQt库：
     • Qt 5：pip install pyqt5
     • Qt 6：pip install pyqt6
   • 避免同一环境中同时安装PyQt5和PyQt6，防止工具调用混乱

4. 验证.ui文件（可选）

   • 用文本编辑器打开.ui文件，搜索是否存在::字符，如果有，说明Designer保存时使用了C++风格的枚举值，这大概率还是版本不匹配导致的，解决版本问题后重新保存.ui文件即可。

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