纯手写 PyQt 界面，几十个控件的对齐和布局就能耗掉一整个下午。Qt Designer 的价值在于——把界面搭建这件事从代码里剥离出来，用拖拽完成，再通过 .ui 文件和 Python 逻辑对接。界面归界面，逻辑归逻辑，改布局不用动一行 Python。
Qt Designer 做了什么
Qt Designer 是 Qt 自带的可视化界面编辑器，核心能力有三项：
- 拖拽布局：从 Widget Box 拖控件到画布，用水平/垂直/网格等 Layout 自动排列，不用手动算坐标。
- 信号与槽连接：在 Edit Signals/Slots 模式下，拖线连接两个控件的信号和槽，比如按钮的
clicked()连到窗口的close()，Designer 会把映射写入.ui。 - 属性编辑：Property Editor 里直接改控件尺寸、字体、样式表、对象名等，比在代码里逐行
setWindowTitle()快得多。
最终产物是一个 .ui 文件——本质是 XML，记录了所有控件的类名、属性、布局关系和信号槽映射。
.ui 文件到 Python 的两条路
.ui 文件不能直接运行，必须和 Python 代码桥接。两种主流方式各有适用场景：
方式一：运行时动态加载
用 uic.loadUi() 在程序启动时直接加载 .ui，不需要预编译，改了 .ui 立刻生效：
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5.uic import loadUi
class MainWindow(QMainWindow):
def __init__(self):
super().__init__()
loadUi("main_window.ui", self) # .ui 文件路径
# 控件通过对象名直接访问
self.pushButton.clicked.connect(self.on_click)
def on_click(self):
self.label.setText("按钮被点击了")
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())
适合快速迭代、界面频繁调整的阶段。缺点是 IDE 无法对 self.pushButton 做类型提示和静态检查。
方式二：用 pyuic 预编译成 Python 类
先用命令行工具把 .ui 转成 .py，再在业务代码里继承：
# PyQt5
pyuic5 main_window.ui -o ui_main_window.py
# PyQt6 对应工具
pyuic6 main_window.ui -o ui_main_window.py
生成的 ui_main_window.py 里有一个 Ui_MainWindow 类，包含所有控件的创建和布局代码。业务代码继承它：
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from ui_main_window import Ui_MainWindow # pyuic 生成的文件
class MainWindow(QMainWindow, Ui_MainWindow):
def __init__(self):
super().__init__()
self.setupUi(self) # 初始化界面
self.pushButton.clicked.connect(self.on_click)
def on_click(self):
self.label.setText("按钮被点击了")
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())
好处是 IDE 能识别控件类型，自动补全和跳转都正常。代价是每次改 .ui 都要重新跑 pyuic，适合界面稳定后转入维护期的项目。
信号槽：Designer 连线 vs 代码绑定
Designer 的信号槽编辑器能可视化连线，但实际项目中更推荐在 Python 代码里手动 connect，原因很具体：
- Designer 连线只能匹配 Qt 内置信号和内置槽，自定义逻辑函数无法接入。
- 连线关系藏在 XML 里，读代码时看不到调用链，排查问题要两头翻。
- 代码里
connect可以接 lambda、部分参数绑定、跨对象连接，灵活度远超 Designer。
Designer 连线适合简单场景（按钮关窗口、滑块改数值），复杂交互一律交给 Python。
实战：搭一个带输入验证的登录窗口
下面是一个完整可运行的小项目，演示从 Designer 出 .ui 到 Python 接逻辑的全流程。
第一步：在 Qt Designer 里画界面
新建 Dialog without Buttons，拖入以下控件并命名（在 Property Editor 的 objectName 里改）：
| 控件类型 | objectName | 用途 |
|---|---|---|
| QLineEdit | username_input | 用户名输入 |
| QLineEdit | password_input | 密码输入 |
| QLabel | error_label | 错误提示 |
| QPushButton | login_button | 登录按钮 |
对 password_input 在属性里勾选 echoMode → Password。保存为 login_dialog.ui。
第二步：转换并编写逻辑
pyuic5 login_dialog.ui -o ui_login_dialog.py
第三步：写业务代码 app.py
import sys
from PyQt5.QtWidgets import QApplication, QDialog
from ui_login_dialog import Ui_LoginDialog
class LoginDialog(QDialog, Ui_LoginDialog):
def __init__(self):
super().__init__()
self.setupUi(self)
self.setWindowTitle("登录")
# 初始状态：错误标签隐藏
self.error_label.setText("")
self.error_label.setStyleSheet("color: red;")
# 信号绑定
self.login_button.clicked.connect(self.handle_login)
def handle_login(self):
username = self.username_input.text().strip()
password = self.password_input.text().strip()
if not username or not password:
self.error_label.setText("用户名和密码不能为空")
return
# 这里替换成真实验证逻辑
if username == "admin" and password == "1234":
self.error_label.setText("")
self.error_label.setStyleSheet("color: green;")
self.error_label.setText("登录成功")
self.accept() # 关闭对话框，返回 Accepted
else:
self.error_label.setText("用户名或密码错误")
if __name__ == "__main__":
app = QApplication(sys.argv)
dialog = LoginDialog()
result = dialog.exec_()
print(f"对话框结果: {result}") # 1=Accepted, 0=Rejected
sys.exit(0)
运行：
python app.py
输入 admin / 1234 看到绿色"登录成功"，空输入或错误组合看到红色提示。改界面布局只需回到 Designer 调整，重新 pyuic5，逻辑代码不动。
什么时候该用，什么时候不该用
适合用 Designer 的场景：
- 界面控件多、布局复杂（表单、设置面板、多列数据展示）。
- 团队里有人专职做界面，有人写逻辑，Designer 让分工清晰。
- 需要快速出原型演示。
不需要 Designer 的场景：
- 界面极简（一个按钮、一个标签），手写代码比走 Designer 流程更快。
- 动态生成界面——控件数量和类型运行时才确定，
.ui是静态的，帮不上忙。 - 自绘控件为主的项目，Designer 的标准控件库覆盖不到。
接入 Checklist：
- Designer 里给每个需要交互的控件设好
objectName，这是 Python 侧访问控件的唯一钥匙。 - 选定加载方式：迭代期用
loadUi，稳定期转pyuic。 - 信号槽一律在 Python 里
connect，Designer 连线只用于纯 UI 联动（如滑块驱动进度条）。 .ui文件纳入版本控制，pyuic生成的.py可以不入库，构建脚本自动生成即可。- 样式表（QSS）优先在 Designer 的
styleSheet属性里写，比代码里散落setStyleSheet更集中、可复用。
Qt Designer 不是万能的，但它把"排控件"这件最耗时间的体力活从代码编辑器搬到了可视化工具里，剩下的逻辑绑定、数据流转、异常处理仍然在 Python 里完成。界面和逻辑各干各的，改布局不用翻代码，改逻辑不用重画界面——这才是它真正的效率来源。