调试与排错的系统方法论
掌握专业开发者的调试思维，能独立定位和解决复杂问题
- 建立科学的调试方法论
- 掌握错误信息阅读技巧
- 学会最小复现和二分定位
- 了解生产环境问题排查思路
调试是工程师最重要的能力
写代码的时间可能只占20%，调试排错占80%。资深工程师不是不写Bug，而是能快速定位和修复Bug。调试能力的差距，就是工程师水平的差距。
调试不是改改试试，是科学方法：观察→假设→预测→验证→结论。每次只改一个变量，否则不知道是什么修复了问题。
第一步：读错误信息
绝大多数 Bug，错误信息已经告诉你答案了。新手看到红色报错就慌，高手会逐行读：
一个典型的错误信息
Traceback (most recent call last): File "app.py", line 42, in <module> result = calculate(data) File "app.py", line 28, in calculate total = sum(order["total"] for order in orders) File "app.py", line 28, in <genexpr> total = sum(order["total"] for order in orders)KeyError: 'total'怎么读：从下往上读：最后一行是错误类型和原因 -> KeyError: 'total' 说明字典里没有 "total" 这个键往上看：错误发生在第 28 行 -> order["total"]，某个 order 字典没有 "total" 键再往上：第 42 行调用了 calculate(data) -> 是 data 里的某个订单数据有问题结论：数据里有订单缺少 total 字段，可能是旧数据或接口变更修复不是简单加个 try-except，而是：为什么数据缺少 total？数据源变了吗？应该用 order.get("total", 0) 还是应该在数据入口校验？其他地方会不会也有这个问题？
SyntaxError: 语法错误（少括号/缩进/引号）；NameError: 变量未定义；TypeError: 类型不对（传了str给需要int的地方）；ValueError: 值不合法（int("abc")）；IndexError: 列表越界；KeyError: 字典没有这个键；AttributeError: 对象没有这个方法；ImportError: 模块不存在。看到错误名就知道大概方向。
第二步：最小复现
能稳定复现的Bug已经修了一半。如果Bug只在特定情况下出现，你需要找到最小复现条件：
从完整流程开始，逐步删减删到不能再删，Bug 还在 -> 这就是最小复现最小复现帮你排除无关因素 示例：报告说「用户管理页面偶尔崩溃」先确认：是所有用户还是特定用户？-> 某个用户是所有操作还是特定操作？-> 点击编辑时是所有数据还是特定数据？-> 用户名为空时最小复现：编辑用户名为空的用户 -> 崩溃根因：代码假设用户名非空，没做空值校验修复：加校验 + 数据库层 NOT NULL 约束
第三步：二分定位
不知道 Bug 在哪段代码时，用二分法快速缩小范围。
代码二分：在中间位置加 print/断点 如果中间值正确 -> Bug 在后半段 如果中间值错误 -> Bug 在前半段 每次排除一半，log2(N) 次就能定位 版本二分（git bisect）： 知道上周能跑，这周不能跑 git bisect start git bisect bad HEAD git bisect good abc1234 # 上周的提交 Git 自动切到中间提交，你测试后标记 good/bad 几次就能找到引入 Bug 的具体提交 数据二分：处理1000条数据第500条出错 先试前500条 -> 再试250条 -> 定位到具体数据
生产环境调试
生产环境没有调试器，不能加断点。你需要不同的工具：
日志是你的眼睛 不要用 print，用 logging 关键路径记录：输入、输出、耗时、异常 出问题时日志是唯一的线索 监控和告警 错误率突增 -> 告警 响应变慢 -> 性能问题 资源（CPU/内存/磁盘）异常 复现生产环境 用相同的数据和配置在本地复现 如果复现不了，说明是环境差异（版本/配置/数据） 热修复 vs 根因修复 线上挂了：先回滚或热修复止血 然后再找根因，写测试，彻底修复 不要在生产环境直接改代码试！
不要同时改多个地方——你不知道哪个起了作用；不要忽略错误信息——它在告诉你答案；不要用 try-except 吞掉异常——那是在隐藏问题不是解决问题；不要假设——用打印/日志/调试器验证你的假设。
资深工程师加餐
底层原理 · 大厂视角 · 工程经验，点卡片展开
底层是大量、快速、稳定的单元测试（优先覆盖纯函数与边界/异常路径），中间是少量集成测试（验证模块协作），顶端是少量端到端测试（慢且脆）。测试最大的价值是当「安全网」：有它你才敢放心重构。没测试兜底的重构，本质是在赌博。写用例先想正常、边界、异常三类。
挑战任务
调试实战
以下代码有 Bug，用系统方法定位：一个函数在某些输入下返回错误结果但不报错。写出你的调试过程。
课后作业
复盘一个你遇到的Bug
回忆你最近遇到的一个难调的Bug，按「现象→假设→验证→根因→修复→预防」的结构写一份调试报告。