调试方法论与工具链（日志、仪器与调试器）
工具会过时，方法论不会。本文汇总星球答疑中的调试思维、仪器用法与调试器底层机制，按"方法论 → 日志 → 仪器 → 断点/Trace"四层展开。
一、方法论：分层、实验与可观测
排查软件问题的正确姿势是分层：先确认供电与时钟这些"底座"，再看外设波形和通信，最后看协议解析与业务状态机；比工具更重要的是"让问题可观测" ｜ Jack，Q3 平常如何排查软件问题？遇到不可复现的问题怎么办。Debug 的本质是设计实验：控制变量、对比验证，而不是盲改代码碰运气 ｜ Jack，嵌入式Debug时学会设计实验。星主在答疑中反复强调"不要去逐行读陌生代码，在调试中熟悉功能"——先了解产品功能，再顺着触发条件看哪些模块参与 ｜ Jack，大佬们，有个问题想请教一下，就是我目前在公司实习，然后领导让看公司的代码。
处理不可复现问题的三板斧：现场日志落盘、保存复位原因与异常栈、按概率假设验证（竞态/越界/超时）｜ Jack，Q3 平常如何排查软件问题？遇到不可复现的问题怎么办。量产级疑难 Bug 则需要工程化管理：定义影响面与复现概率、做劣化实验加速复现、多轮 DOE 排除变量、每日同步进展 ｜ Jason，很多工程师因为英文不好或者没有基础，读不懂外设的数据手册和 Soc 的芯片手册。
二、日志与观测点
打印日志最忌"粗糙"：推荐 SEGGER RTT 或 EasyLogger 这类方案替代裸 printf ｜ Jack，感觉大家打印运行时日志的方法太。但要注意 OS 环境下打 log 会丢、也不够准确，OS 调试束手无策时只能回到"可运行的基准版本"逐步增量加代码分析 ｜ Jack，关于基于OS的调试： OS本。多线程场景想确认事件确实被接收：打 log、或在 vTaskSwitchContext 里打印队列信息、或在 Tick 钩子里打印收发情况 ｜ Jack，多个线程的时候怎么调试，app里面发事件，但是调试怎么确定任务线程已经收到事件。
一个低成本的通用手段是 GPIO 插桩：在关键函数判断返回值后翻转一个 GPIO，用逻辑分析仪抓波形看运行轨迹 ｜ Jack，程序调试中的插桩： 在每个函；定位"程序慢在哪"也用它——每个节点翻转 GPIO，波形时间差就是耗时 ｜ Jack，有时候我们认为程序运行很慢，不知道哪里耗时很多，最简单的办法是什么。使用逻辑分析仪注意其输入阻抗可能拉低被测电平（实测能把上拉按键拉到 1.1V），接上后先量一下电平，必要时外接上拉电阻增强信号 ｜ Jack，老师我遇到个问题，我逻辑分析仪去测按键，按键是上拉。
三、断点与调试器：知其所以然
- 断点数量从哪来：调试器断点靠 FPB（Flash Patch and Breakpoint）单元实现，STM32F411 可设 6 个 FPB 断点；DWT 是观察点（监视某地址访问），可设 4 个——两者机制不同，别混为一谈 ｜ Jack，STM32F411接上调试器能够打断点的原理是什么？能打的断点数量是多少。
- Trace 与 DAP 的区别：Trace 走 ETM 内核单元（TRACEDx 数据口），可回溯多条执行路径、不占 CPU；单步/DAP 调试侵入式地占用 AHB 总线、只能跟踪一条路径且可能改变程序时序 ｜ Jack，Trace调试和DAP调试。侵入式调试适合调整某个功能，非侵入式适合不干扰运行的综合分析。
- SWD vs JTAG：SWD 是 ARM 专为自家内核设计的精简协议，去掉了兼容 8051 等其他架构的冗余，单位时间净荷反而更高；JTAG 更通用但为此付出了引脚与带宽代价 ｜ Jack，我想问一下，SWD调试是串口通行，可以输入可以输出，那他是半双工。JTAG 的上下拉阻值不是拍脑袋定的，要走线长与驱动能力用示波器确认，否则量产级联下载时 TDO 建立时间不够会连不上 ｜ Jack，JATG的上下拉电阻是必须的吗。
四、环境与手段清单
- 调试器中看不到变量/局部变量？局部变量在栈上，进入作用域才存在；若仍看不到，把优化等级降到 -O0 ｜ Jack，为什么调试器中看不到局部变量？map文件里也看不到、如果调试器中看不到变量地址，可以尝试优化等级关一下。O0。
- 怀疑宏没生效时，别信 IDE 的判断，直接看预编译输出 ｜ Jack，有的时候，若是不确定一个文件的某个宏是否真的打开（有时IDE无法准确判断。
- 完整的排查 checklist（栈大小、优化等级、HardFault 暂停、返回值/判空打印、OS 原生 API、序号 printf）见 bug调试的checklist ｜ Jack。
- OS 环境下可在轮询任务里放软件看门狗辅助定位卡死，用宏控制开关以免干扰调试 ｜ Jack，关于操作系统中的看门狗： 轮。
- 屏幕等外设不工作的排查次序：先读 ID/状态字确认通信链路，再写初始化并回读状态字，让排查闭环 ｜ Jack，老师，我写了屏幕的初始化代码，但是屏幕无法点亮，我应该怎么去排查问题？供电正常。
- 传感器类问题（如加速度计"昨天好今天坏"）先加复位指令清状态，并搭标定台架区分"采样不准"还是"算法问题" ｜ Jack，老师们，kxtj3这个加速度传感器有人用过吗？我昨天写的代码可以运动检测。
小结
星球调试答疑的底层逻辑可以压缩成一句话：先让问题可观测（日志/GPIO/Trace），再让实验可设计（分层/劣化/DOE），最后让工具可解释（FPB/DWT/Trace 的机制）。工具链的具体软件会换代，但这套次序在任何 MCU 项目上都适用。
来源笔记
- Q3 平常如何排查软件问题？遇到不可复现的问题怎么办 ｜ Jack
- 嵌入式Debug时学会设计实验 ｜ Jack
- 大佬们，有个问题想请教一下，就是我目前在公司实习，然后领导让看公司的代码 ｜ Jack
- 很多工程师因为英文不好或者没有基础，读不懂外设的数据手册和 Soc 的芯片手册 ｜ Jason
- 感觉大家打印运行时日志的方法太 ｜ Jack
- 关于基于OS的调试： OS本 ｜ Jack
- 多个线程的时候怎么调试，app里面发事件，但是调试怎么确定任务线程已经收到事件 ｜ Jack
- 程序调试中的插桩： 在每个函 ｜ Jack
- 有时候我们认为程序运行很慢，不知道哪里耗时很多，最简单的办法是什么 ｜ Jack
- 老师我遇到个问题，我逻辑分析仪去测按键，按键是上拉 ｜ Jack
- STM32F411接上调试器能够打断点的原理是什么？能打的断点数量是多少 ｜ Jack
- Trace调试和DAP调试 ｜ Jack
- 我想问一下，SWD调试是串口通行，可以输入可以输出，那他是半双工 ｜ Jack
- JATG的上下拉电阻是必须的吗 ｜ Jack
- 为什么调试器中看不到局部变量？map文件里也看不到 ｜ Jack
- 如果调试器中看不到变量地址，可以尝试优化等级关一下。O0 ｜ Jack
- 有的时候，若是不确定一个文件的某个宏是否真的打开（有时IDE无法准确判断 ｜ Jack
- bug调试的checklist ｜ Jack
- 关于操作系统中的看门狗： 轮 ｜ Jack
- 老师，我写了屏幕的初始化代码，但是屏幕无法点亮，我应该怎么去排查问题？供电正常 ｜ Jack
- 老师们，kxtj3这个加速度传感器有人用过吗？我昨天写的代码可以运动检测 ｜ Jack