QRadioButton实现“多选一”的关键是正确分组：同一父控件下自动互斥，多组并存需用QButtonGroup并设autoExclusive为false；应连接toggled(bool)而非clicked()；默认不支持全不选中，需用QButtonGroup::setExclusive(false)手动管理或添加兜底项。
QRadioButton默认就支持“多选一”，但真正用对的关键不在怎么创建，而在于**是否被正确分组**。没分好组，点一个变多个取消；分得太死，又没法实现“无默认选项”或“跨区域互斥”。下面直说实操要点。
同一父控件下自动互斥，但容易误踩 autoExclusive
只要所有 QRadioButton 构造时传入同一个 parent（比如都传 this 或同个 QGroupBox），它们就会自动互斥——这是 autoExclusive 属性默认为 true 的效果。
常见错误现象：
- 把按钮放在不同布局（如一个在
QVBoxLayout，另一个在QHBoxLayout），但父控件仍是同一个窗口 → 它们仍互斥，不是你想要的“两组独立单选” - 手动调用
setAutoExclusive(false)后发现按钮完全不互斥了，且toggled()信号行为异常 → 这是因为你破坏了默认逻辑，却没用QButtonGroup补位
建议做法：
- 简单场景（如性别、模式选择）：直接共用父控件，不碰
autoExclusive - 需要多组并存（如“输入源”和“输出格式”两个独立单选区）：显式用
QButtonGroup管理，同时把按钮的autoExclusive设为false避免干扰
信号选 toggled(bool)，别用 clicked()
clicked() 只在用户点击时触发，且不带状态参数；而 toggled(bool) 在**任何方式导致状态变化时都触发**（包括代码调用 setChecked(true)、用户点击、甚至其他按钮联动取消它）。
典型问题：
- 用
clicked()连接槽函数后，程序里调用radio->setChecked(false)不会触发该槽 → 逻辑断层 - 想区分“刚被选中”和“刚被取消”，必须靠
toggled(checked)的checked参数判断
示例写法：
connect(radio1, &QRadioButton::toggled, [=](bool checked) {
if (checked) {
qDebug() <h3>如何实现“全都不选中”的初始状态</h3><p>Qt 默认不支持“一组里无任何选中项”，哪怕你新建后全调 <code>setChecked(false)</code>，第一个被点击的按钮也会立刻让其他按钮取消——因为互斥逻辑强制“有且仅有一个”。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><p>解决路径只有两个：</p>
- 用
QButtonGroup并设置setExclusive(false)，然后自己管理选中逻辑（需手动在toggled里清空其他按钮） - 加一个“无偏好”或“不适用”选项作为兜底项，让用户主动选它来达成“视觉上无选中”
注意：setAutoExclusive(false) 单独使用不能实现“全不选”，它只是关闭自动互斥，不提供选中状态协调能力。
动态创建时别漏掉 QButtonGroup::addButton()
用循环创建一堆 QRadioButton 后，如果要用 QButtonGroup 管理，必须显式调用 addButton()，否则按钮不会被纳入分组逻辑。
容易忽略的点：
- 按钮创建后未加入 group →
group->checkedButton()返回nullptr，即使界面上看着像互斥 - 按钮加入 group 后又被
delete，但没从 group 中移除 →group->buttons()返回悬垂指针，后续访问崩溃 - 想获取当前选中按钮文本，别遍历所有按钮查
isChecked()，直接用group->checkedButton()->text()
安全写法：
QButtonGroup *group = new QButtonGroup(this);
for (int i = 0; i addWidget(rb);
group->addButton(rb); // 必须这一步
}
// 获取当前选中项
QAbstractButton *checked = group->checkedButton();
if (checked) qDebug() text();
真实项目里最常出问题的，不是不会写 new QRadioButton，而是分组边界模糊、信号连错、以及误以为“没调 setChecked(true) 就等于初始无选中”。这些地方一旦出错，调试时信号不触发、状态错乱、UI 和数据不一致，比逻辑 bug 更难定位。
