很好。现在进入最后一个组件：RadioButton：阶段 2（教学总结）。

先给结论：
这个模块真正要掌握的，不只是“单选按钮能点”，而是 “多个单选按钮如何组织成互斥组，并把用户选择映射成程序可判断的状态”。
也就是说，这一节的核心不是 QRadioButton 本身，而是：

$$QRadioButton ;+; QButtonGroup ;+; checkedId()$$

你的作业示例也正是围绕这条链展开的：

• 一组“性别”单选框

• 一组“爱好”单选框

• 用两个 QButtonGroup 分组

• 通过 checkedId() 判断当前选择结果

---

一、这个模块到底在学什么

这次可以拆成 4 层。

1. 选项层

单选按钮表示：

在多个候选项中选一个

所以它和复选框不同，不是“可多选”，而是“互斥选择”。

---

2. 分组层

单选按钮只有在“成组”时才真正有意义。
如果没有分组，你只是放了几个按钮，它们之间的关系未必清晰。

所以这一节真正的核心控件其实是：

$$QButtonGroup$$

---

3. 标识层

每个单选按钮不只是一个“文本标签”，还被映射到一个整数 ID：

• 男 → 0

• 女 → 1

• 中性 → 2

• 吃 → 3

• 喝 → 4

• 睡 → 5

于是用户点击后的选择结果，就可以被程序稳定地判断。

---

4. 逻辑层

最后通过：

group_sex->checkedId()
group_hobby->checkedId()

把界面选择翻译成程序逻辑。
这说明单选框模块本质上在教你：

$$\text{界面选择} \rightarrow \text{程序状态}$$

---

二、每个模块 / 函数的详细教学

下面按你要求，把这次新出现的模块和函数逐个详细讲清楚。

---

A. QRadioButton 详细教学

A.1 它是什么

QRadioButton 是 Qt 的单选按钮控件。
特点是：

• 多个候选项中一次只能选一个

• 适合表达“互斥选择”

• 常用于问卷、设置项、模式切换、分类判断

典型场景：

• 性别选择

• 支付方式选择

• 显示模式选择

• 语言选择

• 单一选项确认

---

A.2 它和 QCheckBox 的区别

QCheckBox

• 多选或开关

• 可以多个同时为真

• 表示独立状态

QRadioButton

• 单选

• 一组中通常只能有一个被选中

• 表示互斥候选项

所以你现在要形成稳定判断：

• “可多选 / 独立开关” → QCheckBox

• “多选一” → QRadioButton

---

A.3 这次为什么适合用它

因为你的两个问题本质上都是“多选一”：

性别

• 男

• 女

• 中性

爱好

• 吃

• 喝

• 睡大觉

每一组中，同一时刻只能选一个。
这正是 QRadioButton 的标准使用场景。

---

B. QButtonGroup 详细教学

这是这次最重要的新模块。

B.1 它是什么

QButtonGroup 是 Qt 的按钮分组类。

它的作用不是“显示界面”，而是：

在逻辑上把若干按钮组织成一个组

这点很关键。
QButtonGroup 本身不是一个可见控件，它只是一个“管理器”。

---

B.2 这次为什么必须用它

因为你的界面上有两组单选框：

• 性别组

• 爱好组

如果你不显式分组，那么程序在逻辑上就很难统一管理“这三个属于一组、那三个属于另一组”。

所以你写了：

group_sex = new QButtonGroup(this);
group_hobby = new QButtonGroup(this);

这表示建立两个逻辑分组。

---

B.3 为什么它比“只靠布局容器”更适合当前课程

有些时候，QRadioButton 放在同一个父容器下也能表现出互斥性。
但如果你只是依赖界面层级来隐式分组，程序逻辑上并没有一个明确“组对象”。

而 QButtonGroup 的价值在于：

1. 你能明确知道“这是一组按钮”

2. 你能给每个按钮分配 ID

3. 你能统一读取“当前选中的是哪一个”

4. 更适合写判断逻辑

所以在教学和可维护性上，QButtonGroup 更好。

---

C. addButton(button, id) 详细教学

你这次写的是：

group_sex->addButton(ui->radioButton_male, 0);
group_sex->addButton(ui->radioButton_female, 1);
group_sex->addButton(ui->radioButton_unknown, 2);

以及：

group_hobby->addButton(ui->radioButton_eat, 3);
group_hobby->addButton(ui->radioButton_drink, 4);
group_hobby->addButton(ui->radioButton_sleep, 5);

---

C.1 它在做什么

这个函数完成两件事：

1. 把按钮加入某个组

2. 为这个按钮绑定一个整数 ID

也就是：

$$button \rightarrow id$$

---

C.2 为什么要绑定 ID

因为文本虽然人类能读，但程序判断往往更方便用整型编号。

例如：

• 男 → 0

• 女 → 1

• 中性 → 2

这样后面就能直接：

switch(group_sex->checkedId())

来做逻辑判断。

---

C.3 这比直接判断按钮对象好在哪里

你当然也可以写：

if (ui->radioButton_male->isChecked()) ...

但如果选项越来越多，这种写法会越来越乱。

而 QButtonGroup + id 的思路更统一：

$$\text{不关心具体哪个按钮对象} \rightarrow \text{只关心当前组里的选中 ID}$$

这就是更抽象、更稳定的写法。

---

D. checkedId() 详细教学

这是这次最核心的接口之一。

你写的是：

group_sex->checkedId()
group_hobby->checkedId()

---

D.1 它是什么

checkedId() 的作用是：

返回当前组中被选中的那个按钮的 ID

例如：

• 若选中了 radioButton_female

• 并且你给它绑定的是 1

• 那么：

group_sex->checkedId() == 1

---

D.2 为什么它这么重要

因为这让“界面上的选择”直接变成了“程序里的离散状态”。

也就是：

$$\text{用户点了哪个按钮} \rightarrow \text{一个可判断的整数状态}$$

这非常适合：

• switch-case

• 状态机

• 条件判断

• 参数映射

---

D.3 这次你为什么用 switch

因为当前 ID 是离散小整数，非常适合写成：

switch (group_sex->checkedId())
{
case 0: ...
case 1: ...
case 2: ...
}

这在可读性上比一长串 if-else 更整齐。

---

E. setChecked(true) 详细教学

你这次构造函数里写了：

ui->radioButton_unknown->setChecked(true);
ui->radioButton_eat->setChecked(true);

---

E.1 它在做什么

它的作用是：

设置某个单选按钮为默认选中项

也就是程序启动后，不必让整组“无选择”，而是直接给出一个初始状态。

---

E.2 为什么这一步很重要

因为如果没有默认值，很多逻辑会处于“不确定态”。

例如：

• 一启动就读取 checkedId()

• 但用户还没点任何选项

这时程序状态就不稳定。

所以给每组设一个默认选项是很合理的。

---

F. MySlots() 详细教学

这是这次的统一槽函数。

你现在写的是类似：

void MainWindow::MySlots()
{
    QString sexText;
    QString hobbyText;

    switch (group_sex->checkedId())
    {
    case 0: sexText = "male"; break;
    case 1: sexText = "female"; break;
    case 2: sexText = "unknown"; break;
    default: sexText = "none"; break;
    }

    switch (group_hobby->checkedId())
    {
    case 3: hobbyText = "eat"; break;
    case 4: hobbyText = "drink"; break;
    case 5: hobbyText = "sleep"; break;
    default: hobbyText = "none"; break;
    }

    qDebug().noquote() << "sex:" << sexText << "| hobby:" << hobbyText;
}

---

F.1 它在做什么

它实际上完成了三步：

1. 读取当前性别组的选中状态

2. 读取当前爱好组的选中状态

3. 把这两个状态翻译成字符串并输出

所以它本质上是：

$$\text{组状态读取} \rightarrow \text{状态解释} \rightarrow \text{结果输出}$$

---

F.2 为什么两组按钮能共用一个槽函数

因为无论你点的是：

• 性别组里的按钮

• 爱好组里的按钮

最终都要重新回答同一个问题：

当前性别是什么？当前爱好是什么？

所以完全可以让所有按钮都指向同一个统一刷新函数。

这是一种很典型的 GUI 设计模式：

$$\text{多个输入源} \rightarrow \text{一个统一状态刷新槽}$$

你在 SpinBox 和 HorizontalSlider 里其实已经见过类似思路了。

---

F.3 为什么这比写 6 个独立槽函数更好

如果你给每个按钮都写一个槽函数，例如：

• on_radioButton_male_clicked()

• on_radioButton_female_clicked()

• on_radioButton_unknown_clicked()

• …

那代码会非常碎。
而你真正关心的并不是“哪个按钮被点了”，而是：

当前组的整体状态是什么

所以统一用 MySlots() 是更好的抽象。

---

G. 为什么原示例只连接了性别组是不完整的

你最初给的原始示例里只绑定了：

• radioButton_male

• radioButton_female

• radioButton_unknown

没有绑定爱好组。

这意味着：

• 点“性别”时会输出

• 点“爱好”时没有反馈

所以原代码只能算“部分完成”。

我给你的修正版把爱好组三个按钮也连进了 MySlots()，这样逻辑才闭合。

这其实就是你现在应该具备的“审稿式观察”：

能跑 ≠ 设计完整
示例代码也可能只演示了一半。

---

三、本模块新增模块的重点系统总结

下面把这次新出现的东西系统总结一遍。

---

1. QRadioButton

定义

单选按钮控件，用于一组候选项中的互斥选择

适合场景

• 性别

• 模式选择

• 支付方式

• 分类选择

常用接口

• setChecked(bool)

• isChecked()

• clicked(bool)

本次作用

承载“性别”和“爱好”两个多选一问题

---

2. QButtonGroup

定义

按钮逻辑分组类，本身不可见

常用接口

• addButton(button, id)

• checkedId()

本次作用

• 把性别按钮组织成一组

• 把爱好按钮组织成一组

• 给每个选项分配编号

---

3. addButton(button, id)

定义

把按钮加入组，并给它一个逻辑编号

本次作用

建立“按钮对象 ↔ 程序状态编号”的映射

---

4. checkedId()

定义

返回当前组里被选中的按钮 ID

本次作用

作为 switch-case 的判断依据

---

5. 统一槽函数 MySlots()

定义

一个由多个按钮共同触发的状态刷新函数

本次作用

统一输出当前“性别 + 爱好”的组合结果

---

四、这个模块最重要的知识点

1. 单选按钮的核心不是按钮，而是“组”

如果没有分组，你就失去了真正的单选逻辑管理能力。

---

2. QButtonGroup 是逻辑层，不是界面层

它不负责显示，只负责组织和管理按钮关系。

---

3. 用户选择应尽量映射成程序可判断的 ID

这样更利于逻辑分支处理。

---

4. 多个按钮可以共用一个统一刷新槽

只要最终目标都是“重新读取当前整体状态”。

---

五、这个模块最容易踩的坑

易错点 1：把 QButtonGroup 写成全局变量

原示例就是这样写的。
这在小示例里能跑，但结构不好。
成员变量更合理。

---

易错点 2：忘记给某一组按钮绑定信号

这次原始代码就漏了爱好组。
导致部分界面操作无反馈。

---

易错点 3：误以为 QRadioButton 自动就是“同一组”

在简单界面布局里可能看起来会互斥，但从程序逻辑角度，显式 QButtonGroup 更稳、更清晰。

---

易错点 4：不给组中按钮分配 ID

那你后面用 checkedId() 做判断就不方便了。

---

六、你现在应该形成的理解

做完这个模块，你应该明确：

1. QRadioButton 适合互斥单选

2. QButtonGroup 是单选组管理的核心

3. addButton(button, id) 能把界面选项映射成程序状态

4. checkedId() 是组状态读取的关键接口

5. 多个单选按钮完全可以共用一个状态刷新槽函数

---

七、这一模块最值得记住的最小模板

你最值得记住的是这段：

group_sex = new QButtonGroup(this);
group_sex->addButton(ui->radioButton_male, 0);
group_sex->addButton(ui->radioButton_female, 1);
group_sex->addButton(ui->radioButton_unknown, 2);

group_hobby = new QButtonGroup(this);
group_hobby->addButton(ui->radioButton_eat, 3);
group_hobby->addButton(ui->radioButton_drink, 4);
group_hobby->addButton(ui->radioButton_sleep, 5);

它代表：

$$\text{界面按钮} \rightarrow \text{逻辑分组} \rightarrow \text{状态编号}$$

以及这段：

switch (group_sex->checkedId())
{
case 0: sexText = "male"; break;
case 1: sexText = "female"; break;
case 2: sexText = "unknown"; break;
}

它代表：

$$\text{用户选择} \rightarrow \text{程序状态判断}$$

---

你这次作业的 13 个组件，到这里就完整跑通了

你这一轮实际上已经不只是“把控件复现出来”，而是把 Qt Widgets 里最常见的一批交互模式都走了一遍，包括：

• 文本输入

• 数值输入

• 连续参数调节

• 状态切换

• 多选 / 单选

• 联动下拉框

• 定时器驱动刷新

• 日期时间转换

• 文本模型到视图显示

这已经是一套比较完整的入门骨架了。

接下来更有价值的不是继续“一个组件一个组件”，而是把你这 13 个组件整理成一份统一复盘笔记 / 组件对照表，把“控件—核心接口—典型信号—最常见坑”压缩成一页到两页。