Python新手将PyQt5的.ui文件转为.py后编辑器报大量错误如何解决

开发者阿泽

2026-9-24

问题解决方案

核心原因

你遇到的报错绝大多数情况是Qt资源文件未编译导致的，代码末尾导入的*_rc格式模块是Qt资源配置文件（.qrc后缀）编译后的Python文件，你仅完成了.ui窗体文件的编译，没有处理资源文件，所以编辑器会报导入缺失类错误。

首先找到你项目中所有后缀为.qrc的资源配置文件，使用pyrcc5工具编译为对应_rc.py文件，命令格式如下：
```
pyrcc5 资源文件名.qrc -o 对应_rc文件名.py
```
比如你代码中导入了BGHD_rc，就需要找到BGHD.qrc执行pyrcc5 BGHD.qrc -o BGHD_rc.py，其余Logo_rc、mmenu_rc等导入项同理处理，所有编译生成的_rc.py文件要和你ui转出来的主py文件放在同一目录下。
若还有Qt相关基础模块导入报错，检查PyQt5依赖是否完整安装，执行安装命令：
```
pip install pyqt5 pyqt5-tools
```
确认你转换.ui文件时使用的是对应PyQt5的pyuic5工具，转换命令格式如下：
```
pyuic5 你的窗体文件.ui -o 输出的Python文件.py
```
不要使用对应PyQt6的pyuic6工具编译，否则会出现版本不兼容报错。