3、单步调试与断点管理：设置/取消断点、条件断点、单步执行、步入/步过/步出
调试器连上了，芯片也停住了。接下来干什么？
说白了，就是让代码按你的意愿跑。想停就停，想一步一步看就看。这就是断点管理和单步执行的核心。
我刚开始用RISC-V内核调试时，总觉得跟ARM差不多。后来发现，有些细节还真不一样。尤其是CH32V203这颗芯片，它的调试模块设计得挺巧妙，但用不对地方，反而会踩坑。
3.1 断点：让代码停在你想停的地方
断点分两种：硬件断点和软件断点。CH32V203的RISC-V内核支持2个硬件断点，软件断点则不受数量限制。
| 断点类型 | 原理 | 数量限制 | 适用场景 |
|---|---|---|---|
| 硬件断点 | 利用CPU调试寄存器，地址匹配时触发暂停 | 2个（RISC-V标准） | ROM/Flash中执行代码、中断服务函数入口 |
| 软件断点 | 将目标指令替换为ebreak指令，执行时触发异常 | 无限制 | RAM中执行代码、普通函数调试 |
关键点：CH32V203的Flash是只读的，软件断点无法写入。所以Flash中的代码只能用硬件断点。RAM中的代码两种都支持。
3.2 设置与取消断点
在MounRiver Studio里，操作很简单。双击行号左侧的灰色区域，就能设置或取消断点。
但我建议你记住快捷键：Ctrl+Shift+B。调试时手不离键盘，效率高很多。
设置断点后，你会看到一个小蓝点。实心蓝点表示断点已生效，空心蓝点表示断点被禁用。
我的习惯：调试复杂逻辑时，我会先在所有可能的分支入口都打上断点。然后根据实际执行路径，逐个禁用不需要的断点。这样不用反复设置，省时间。
3.3 条件断点：只在满足条件时停下
普通断点每次执行到都会停。但有时候，我只想在特定条件下停。比如循环执行100次时，或者某个变量等于特定值时。
这就是条件断点的用武之地。
在MounRiver Studio中，右键点击断点，选择"Breakpoint Properties"，就能设置条件。
// 示例：只在i等于50时停下
条件表达式：i == 50我曾经踩过的坑：条件断点会消耗额外的CPU周期。在时间敏感的中断服务函数里，条件断点可能导致时序偏移。有一次我调试一个PWM波形，加了条件断点后波形直接变了。排查了半天才发现是断点导致的。
所以，条件断点尽量用在主循环或非实时任务中。
3.4 单步执行：一步一步看代码怎么跑
单步执行有四种模式：单步跳过、单步进入、单步跳出、运行到光标处。
| 操作 | 快捷键 | 行为 | 我常用的场景 |
|---|---|---|---|
| 单步跳过 (Step Over) | F6 | 执行当前行，不进入函数内部 | 确认函数返回值是否正确，不想看内部实现 |
| 单步进入 (Step Into) | F5 | 进入函数内部，逐行执行 | 怀疑函数内部逻辑有bug，需要深入排查 |
| 单步跳出 (Step Return) | F7 | 执行完当前函数剩余代码，返回到调用处 | 确认函数没问题，快速跳出 |
| 运行到光标 (Run to Line) | Ctrl+R | 全速执行到光标所在行 | 跳过一大段无关代码，直接到目标位置 |
嗯，这里要注意。单步进入时，如果遇到库函数或系统调用，可能会跳进汇编代码里。这时候别慌，用单步跳出就能回来。
3.5 步入/步过/步出的实战技巧
这三种操作是调试的"三件套"。我总结了一套自己的使用策略：
- 先步过，快速定位问题范围。用F6跳过函数调用，观察变量变化。如果发现某个函数返回值异常，再进入。
- 再步入，深入问题内部。用F5进入可疑函数，逐行检查逻辑。重点关注条件判断和循环边界。
- 最后步出，确认修复效果。用F7跳出函数，继续后续流程。
避坑指南：我曾经在调试一个状态机时，连续按了十几次F6，结果发现状态跳转完全不对。后来才意识到，步过操作会执行完整个函数，如果函数内部修改了全局状态，步过是看不到中间过程的。
所以，涉及全局状态修改的函数，建议用步入而不是步过。
3.6 断点与单步的协同工作流
光有断点或光有单步，都不够。两者配合才能发挥最大威力。
我常用的调试流程是这样的：
- 在关键路径上设置2-3个断点（硬件断点优先用在Flash代码上）
- 全速运行到第一个断点，检查上下文
- 切换到单步模式，逐行观察关键逻辑
- 发现问题后，修改变量值或跳过某段代码继续执行
- 用"运行到光标"快速跳过无关区域
你想想看，如果每次都要从头全速运行，那得浪费多少时间？
我的小技巧：调试时打开"表达式"窗口，把关键变量拖进去。单步执行时，变量的变化一目了然。比每次悬停鼠标看值方便多了。
3.7 断点管理：别让断点成为负担
断点多了，反而容易乱。我见过有人打了十几个断点，结果每次运行都停，根本分不清哪个是哪个。
我的管理原则：
- 断点不超过3个。超过3个，说明你对代码流程还不够清晰。
- 用禁用代替删除。暂时不需要的断点，右键禁用。下次可能还用得上。
- 给断点加注释。MounRiver Studio支持断点注释。右键断点，添加说明文字。比如"检查DMA传输完成标志"。
嗯，这里有个细节。CH32V203的硬件断点只有2个。如果你在Flash代码中设置了3个断点，第3个会自动变成软件断点，但不会生效。调试器会报错"Failed to set breakpoint"。
重要提醒：调试结束后，记得清除所有断点。否则下次打开工程，断点还在。我有一次忘了清，结果同事打开工程，一运行就停，还以为芯片坏了。
3.8 知识体系总览
下面这张图，把断点管理和单步执行的核心逻辑串起来了。你可以对照着看，心里有个全局框架。
这张图把断点和单步的关系理清楚了。左边是断点管理，右边是单步执行，底部是推荐的工作流。你调试时，就按这个框架来，不会乱。
好了，断点和单步的内容就这些。记住，调试不是碰运气，而是有方法、有步骤的。用好这些工具，bug自然无处藏身。