QCheckBox核心在于正确管理状态与信号：初始状态需调用setChecked()或setCheckState()单独设置；响应状态变化必须连接stateChanged信号（传int枚举值），而非clicked（仅响应鼠标点击）；三态模式需显式启用setTristate(true)，读取状态应使用checkState()而非isChecked()以防误判。
QCheckBox 用对了就是个布尔开关，用错了会卡住信号、状态不同步、甚至 UI 假死——核心就两点：别直接改 isChecked() 返回值，信号连的是 stateChanged 而不是 clicked。
怎么设置初始状态和响应点击
构造时传字符串是显示文本，状态得单独设；想响应“勾选变化”必须连 stateChanged，连 clicked 只捕获鼠标点击（忽略键盘空格、API 设置等触发）。
-
QCheckBox *cb = new QCheckBox("启用日志");—— 文本设好了，但默认是未勾选 -
cb->setCheckState(Qt::Checked);或cb->setChecked(true);都行，后者更常用 connect(cb, &QCheckBox::stateChanged, [=](int state) { qDebug() ——state是Qt::Unchecked/Qt::PartiallyChecked/Qt::Checked，不是 bool
三态模式（tristate）怎么开和读
默认是两态（只有勾/不勾），要支持“半勾”（比如父子项不完全一致），必须显式开启三态，且读取时不能用 isChecked()。
-
cb->setTristate(true);—— 开启后，点击会循环：未勾 → 半勾 → 已勾 → 未勾 -
cb->checkState()返回Qt::CheckState枚举，isChecked()在半勾时也返回true，容易误判 - 判断是否“真正启用”，应写
cb->checkState() == Qt::Checked，而不是cb->isChecked()
为什么 setChecked(true) 不触发 stateChanged 信号
这是 Qt 的设计：状态由用户交互触发信号，程序调用 setChecked() / setCheckState() 属于“静默设置”，不发信号——避免自循环或重复处理。
- 需要同步更新其他控件？手动补逻辑，比如
cb->setChecked(true); updateOtherWidgets(); - 真要强制发信号？可以用
cb->blockSignals(true); cb->setChecked(true); cb->blockSignals(false);然后自己 emit，但通常没必要 - 注意：如果连了
clicked，setChecked()完全不会触发它
QCheckBox 和 QButtonGroup 怎么配合
QButtonGroup 一般用于 QRadioButton 互斥，但也能管 QCheckBox——不过它只负责管理“选中状态归零”，不改变行为逻辑。
QButtonGroup *group = new QButtonGroup(this); group->addButton(cb1); group->addButton(cb2);- 调用
group->setExclusive(true)后，多个QCheckBox就变成单选了（点一个，其他自动取消） - 此时
stateChanged仍正常发出，但要注意：被 group 自动取消的那个 checkbox，它的信号也会来，别漏处理 - 不推荐混用——语义冲突，UI 设计上复选框就该多选，强行变单选不如换
QRadioButton
最常踩的坑是把 isChecked() 当万能状态读取，尤其开了三态之后；还有就是信号连错，以为 clicked 能覆盖所有勾选变化。实际项目里，只要记住“状态看 checkState()，变化监听 stateChanged”，基本不出事。
