PyQt5.QtWidgets模块导入最佳实践

PyQt5 没有强制的统一导入标准，但结合PEP8规范、主流开源PyQt项目的通用写法、可维护性与编码效率的平衡，有两种经过大量项目验证的规范写法，可以替代冗余的多行导入，同时规避通配符导入的命名污染问题。

方案1：命名空间导入（中大型项目首选） #

这是Spyder、QGIS等大型PyQt开源项目采用的主流写法，直接导入子模块作为命名空间，不需要逐个枚举用到的控件类：

from PyQt5 import QtWidgets, QtCore, QtGui
import pyqtgraph as pg

使用时通过模块前缀调用对应对象即可，比如：

app = QtWidgets.QApplication([])
window = QtWidgets.QMainWindow()
btn = QtWidgets.QPushButton("确认")

这种写法的优势：

• 零冗余导入，新增控件时不需要反复回头修改导入列表
• 所有Qt相关调用都带模块前缀，一眼就能区分对象来源，完全避免自定义类、其他第三方库与Qt类同名导致的命名冲突
• 完全符合PEP8要求，静态检查工具可以正常识别所有对象

补充：从pyqtgraph.Qt导入QtGui的写法没有必要，直接从PyQt5导入对应模块即可，pyqtgraph会自动适配当前环境的Qt绑定，不会出现版本兼容问题。

方案2：同模块合并导入（单文件小脚本首选） #

如果你不想每次调用控件都写模块前缀，不需要把同一个子模块的导入拆成多行，用PEP8推荐的括号包裹格式，把同模块下的所有导入类合并到同一个导入语句下即可：

from PyQt5.QtWidgets import (
    QApplication, QMainWindow, QStatusBar, QTextEdit, QFileDialog,
    QLabel, QWidget, QHBoxLayout, QPushButton, QLineEdit,
    QRadioButton, QGridLayout, QFormLayout, QAction
)
from PyQt5.QtCore import Qt
from PyQt5 import QtGui
import pyqtgraph as pg

这种写法保留了直接调用类名的便捷性，同时把重复的导入语句合并到一起，可读性远高于拆分多行的同模块导入，也不存在通配符导入的命名污染问题。

明确不推荐的写法 #

• 禁止使用from PyQt5.xxx import *通配符导入：会一次性向当前命名空间注入数百个Qt类，极易和自定义业务类、其他第三方库的同名对象冲突，且静态检查工具无法识别未定义名称，大幅提升bug排查成本。
• 不建议随意给Qt模块起自定义短别名，比如import QtWidgets as qtw这类写法，个人项目使用没有问题，但团队协作时其他开发者需要额外记忆别名映射，反而降低代码可读性，Qt官方的子模块名本身已经足够简短，不需要额外缩写。

两种方案可以根据项目规模选择：多文件协作的中大型项目优先选命名空间导入，单文件小型工具选合并导入即可。

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