张宗平
6d1895d696
- pitfall_stack_widget / pitfall_lambda_capture / pitfall_double_connect： 默认跑正确写法（离屏验证退出码 0），--crash / --dangle 开关课堂现场触发 真实崩溃/悬空访问 - table_widget：QTableWidget 单元格事件最小示例（新安排 Day4「表格事件」） - student_manager：Day5 综合案例参考实现，离屏自测覆盖 JSON round-trip 与 QThread 后台导入闭环 - 均接入 examples/CMakeLists.txt 的 add_teaching_example，手工维护区不影响生成器
坑点复现：重复 connect 导致槽触发多次 —— 教学补充示例
对应教案
OUTLINE_4DAY.mdDay2 下午 ★坑卡 「重复 connect 导致槽触发多次」。手工维护，非生成产物。
概念
connect 每调用一次就新增一条连接——Qt 不会去重。同一对信号槽连了两次，
信号一发槽就被调两次。典型事故现场：connect 写在会被多次执行的路径上
（每次打开对话框/每次刷新界面都跑一遍的「初始化」函数）。
现象非常有迷惑性：「点一次按钮弹两次框」——学员的第一反应是查按钮、查事件， 而根源在连接次数。
两种修复
- 把 connect 收拢到只执行一次的地方（构造函数）——首选，从结构上杜绝；
Qt::UniqueConnection——同一对（发送者,信号,接收者,槽）只允许一条连接。 注意它只对成员函数指针有效：lambda 没有可比较的身份，UniqueConnection 对 lambda 连接不起作用（这是它常被误用的点）。
验证方式
QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_pitfall_double_connect # 确定性输出：2 次 → 1 次，退出码 0
练习方向（供任务卡引用）
- 把
Popup::showOnce换成 lambda 再加Qt::UniqueConnection，验证「lambda 防不了重」； - 在
showOnce里打印sender()，观察两次调用来自同一发送者的两条连接。
参考
- 本仓库对照：
p03/ch04/custom_signal_slot.cpp - Qt 官方文档：
QObject::connect（Qt::ConnectionType一节，选读·需联网）