PyQt5如何让Qt Designer/pyuic5不生成自定义部件的导入语句？

针对你遇到的「自定义部件类与主代码同文件，pyuic5自动生成多余导入语句导致问题」的情况，以下是几种无需大规模重构的可行方案：

方案一：使用动态加载ui文件替代预生成代码 #

直接在主文件中用uic.loadUiType加载.ui源文件，跳过pyuic5生成中间代码的步骤，这样uic会自动识别当前模块中的自定义类，不会生成多余导入语句：

from PyQt5 import uic
from PyQt5.QtWidgets import QMainWindow, QTableView

# 自定义部件类（与主代码同文件）
class CustomTableView(QTableView):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 自定义逻辑
        ...

# 加载ui文件，自动关联当前模块的自定义类
Ui_MainWindow, _ = uic.loadUiType("mainwindow.ui")

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)

if __name__ == "__main__":
    import sys
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

方案二：用虚拟模块规避循环导入 #

在Qt Designer提升部件时，将「头文件」字段填为一个自定义的虚拟模块名（比如dummy_custom），类名保持CustomTableView。之后在主文件导入ui代码前，创建这个虚拟模块并注入自定义类：

import sys
import types
from PyQt5.QtWidgets import QMainWindow, QTableView

# 自定义部件类
class CustomTableView(QTableView):
    ...

# 创建虚拟模块并注入自定义类
dummy_module = types.ModuleType('dummy_custom')
dummy_module.CustomTableView = CustomTableView
sys.modules['dummy_custom'] = dummy_module

# 此时导入ui文件不会报错，因为虚拟模块已存在
from ui_mainwindow import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)

pyuic5生成的导入语句会是from dummy_custom import CustomTableView，而虚拟模块已经包含了你的自定义类，既不用修改生成代码，也避免了循环导入问题。

方案三：自动清理多余导入语句 #

写一个简单的脚本，在pyuic5生成代码后自动删除指定的导入语句，可将其整合到构建流程中：

import fileinput

# 配置参数
ui_generated_file = "ui_mainwindow.py"
target_import_line = "from customTableView import CustomTableView"

# 清理多余导入
with fileinput.FileInput(ui_generated_file, inplace=True, backup='.bak') as f:
    for line in f:
        if line.strip() != target_import_line:
            print(line, end='')

使用时先运行pyuic5 mainwindow.ui -o ui_mainwindow.py，再执行这个脚本即可自动移除多余导入。

方案四：修改pyuic5的模板文件（全局生效） #

找到PyQt5安装目录下的uic模板文件（通常在Python安装路径/site-packages/PyQt5/uic/templates/python/），备份widgets.py或mainwindow.py模板后，修改其中生成导入语句的逻辑，移除自动添加自定义部件导入的代码。注意此方法会影响所有使用pyuic5的项目，需谨慎操作。

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