PyQt信号槽机制实现松耦合通信：内置信号如clicked可直接连接槽，自定义信号需用pyqtSignal声明；自定义控件应继承QWidget并封装逻辑；跨线程需用QThread+pyqtSignal；调试需注意生命周期、拼写、参数匹配及lambda捕获问题。
信号槽机制：让控件“开口说话”
PyQt 的核心之一是信号（signal）与槽（slot）机制——它不是函数调用，而是一种对象间松耦合的通信方式。比如点击按钮时发出 clicked 信号，你只需连接一个函数（即“槽”）去响应，无需在按钮类里硬编码逻辑。
常见用法：
-
内置信号直接连：如
button.clicked.connect(self.on_click) -
自定义信号需声明：在类中用
pyqtSignal()定义，支持传参（如int、str、甚至自定义类型） - 槽可以是普通方法、lambda 或函数，但签名需匹配信号参数（或用 lambda 包装适配）
-
disconnect() 要谨慎：多次 connect 不会重复绑定，但手动断开时建议先检查是否已连接（可用
button.clicked.disconnect加 try 捕获）
自定义控件：从 QWidget 继承开始
真正复用 UI 逻辑，不能只靠布局嵌套，得封装成独立控件。最常用方式是继承 QWidget，重写 paintEvent 实现绘制，或组合多个标准控件并暴露统一接口。
一个实用例子：带清除按钮的搜索框（SearchLineEdit）
立即学习“Python免费学习笔记（深入）”；
- 内部包含 QLineEdit + QToolButton，用 QHBoxLayout 布局
- 重写
resizeEvent动态调整按钮大小和位置 - 发射自定义信号
textCleared和returnPressed，外部只关心“用户清空了”或“按了回车”，不关心按钮怎么画 - 提供
setPlaceholderText等代理方法，保持 API 兼容性
进阶技巧：信号跨线程与装饰器简化
多线程中不能直接 emit 信号到主线程控件——PyQt 要求信号必须在对象所属线程中处理。正确做法是：
- 用
QThread+moveToThread，而非 Python 原生 threading - 工作类定义 pyqtSignal，线程启动后 emit，UI 类提前 connect（自动跨线程排队）
- 避免在子线程中调用
widget.update()或修改属性——全走信号
还想写得更干净？试试信号装饰器：
def as_signal(func):
def wrapper(self, *args):
if hasattr(self, '_sig_' + func.__name__):
getattr(self, '_sig_' + func.__name__).emit(*args)
return func(self, *args)
return wrapper
配合类内声明 valueChanged = pyqtSignal(float)，就能在 setter 中用 @as_signal 自动触发，减少样板代码。
调试信号槽：别让连接“静默失败”
信号没响应？大概率是这几个原因：
- 信号对象和槽对象生命周期不一致（如局部变量创建的控件被回收）
- 信号名拼错、参数类型不匹配（PyQt6 严格校验，PyQt5 可能静默忽略）
- connect 写在 init 之后、但控件还没 show，某些信号（如 resize）可能已错过
- 用了 lambda 但捕获了会被销毁的变量（如
lambda: self.label.setText(...)中 self 已删）
快速验证：临时加一句 print("emitted") 在 emit 处；或用 QObject.receivers(signal) 查当前有几个接收者。
