Debug

---
name: debug
description: 系统化定位并修复 bug、报错、崩溃或行为异常。当用户贴出报错信息、说"报错了/跑不起来/结果不对/帮我调试"时使用。
---

# 调试

用系统化方法定位根因，而不是瞎猜乱改。

## 步骤
1. **复现与读错误**：完整读报错栈/日志，定位最先出错的那一行（最底层的根因，不是最外层的表象）。
2. **形成假设**：根据错误信息提出 1~3 个最可能的原因，按概率排序。
3. **验证假设**：
   - 读相关代码确认逻辑。
   - 必要时加临时日志/打印，或用最小用例复现。
4. **修复根因**：改最小、最贴近根因的地方，不要为掩盖症状打补丁。
5. **验证**：重新运行复现步骤或相关测试，确认问题消失且没引入新问题。
6. **说明**：用中文简述根因是什么、为什么会发生、改了什么。

## 原则
- 一次只验证一个变量。
- 改完一定要实际运行验证，别只凭推断说"应该好了"。
- 临时加的调试代码记得清理。