本文目录导读：
这里整理了一份针对源码快速排错的实用技巧清单，按照定位问题到分析问题的逻辑顺序排列,适用于日常开发和代码审查。
第一阶段：快速定位（找到“罪魁祸首”）
二分法注释/屏蔽代码
- 技巧： 不断将代码范围一分为二，屏蔽掉一半,看问题是否复现。
- 做法： 如果某段逻辑导致错误，先注释掉后半部分，如果错误消失，说明错误在前半部分；否则在后半部分，反复此过程,能极快地锁定到几行代码。
- 适用： 大型函数、复杂的UI渲染、不确定触发源的回调。
console.log 与断点优先级
- 技巧： 不要漫无目的地打日志，先猜测错误发生的可能位置，在怀疑的入口和出口分别打日志。
- 区分：
- 快速验证值： 用
console.log+ 唯一标识符（如console.log('A-123:', variable)）避免混淆。 - 复杂逻辑分析： 直接用断点（
debugger;或IDE断点），观察调用栈（Call Stack）和变量值变化，断点效率远高于反复打印日志,尤其是处理异步问题时。
- 快速验证值： 用
利用“错误堆栈”反向追溯
- 技巧： 绝大多数编程语言（JS/Java/Python/Go）的异常都会打印调用栈（Call Stack）。永远先看堆栈的最顶部（由你编写的代码行），而不是底部,底部通常是库或框架的底层实现。
- 做法： 从堆栈顶部找到自己的代码行号,直接跳转过去。
git bisect — 查找历史“罪人”
- 技巧： 当代码最近一次提交后出错,但不知道是哪次提交改坏了。
- 做法：
git bisect start，标记一个好的提交（git bisect good <commit>）和坏的提交（git bisect bad [HEAD]），Git会自动二分跳转到中间提交，你测试后标记good或bad，重复几次就能锁定第一个引入 bug 的提交。 - 适用： 长期项目、多人协作、回归错误。
代码比较（Diff）
- 技巧： 当你在排查一个“昨天还能跑，今天不行”的问题时，不要读完整代码，直接比较最新版本和稳定版本的 Diff。
- 做法：
git diff HEAD~1 -- <file>或查看Git GUI中的文件对比,只看变更行。
第二阶段：深入分析（理解“为什么错”）
捕获“异常值”而非“逻辑流”
- 技巧： 不要假设程序走的是正确的分支，使用条件断点（Conditional Breakpoint）或
console.assert。 - 例子： 一个循环处理1000个元素，只有第500个元素会报错，在循环里打日志会刷屏，用条件断点
index === 500或assert(value > 0),只在预设条件成立时中断。
数据流追踪法
- 技巧： 对于数据驱动的问题（如状态管理、API响应），画出数据的输入 -> 处理 -> 输出链条。
- 做法： 在数据进入函数、经过关键变换、最终返回/渲染处分别打日志，标记为
rawInput、transformed、finalOutput，不要相信缓存或日志里的“看起来一样”的值（可能被toString()误导）。
最小化复现公式
- 技巧： 如果错误需要多个步骤触发,尝试精简触发条件。
- 做法： 尝试用最少的代码、最少的输入、最简洁的环境复现，这本身就能排除90%的外部依赖干扰，写一个独立的测试单元（Unit Test）是很好的方式。
检查“坏味道”模式
- 技巧： 很多问题有固定的模式，快速排查时优先检查这些区域：
- 异步竞态：
setTimeout/Promise/ajax中，是否在请求还没完成时就更新了状态？是否有闭包引用了过时的变量？ - 引用 vs 拷贝： 对象/数组是否被意外共享？
Array.sort()会修改原数组。 - 类型隐式转换：
'1' + 1(字符串拼接) 还是'1' - 1(数值运算)？特别是 JavaScript/TypeScript 中。 - 作用域污染： 忘了加
let/const导致全局变量？for循环中的var导致循环变量泄露？
- 异步竞态：
“打印出真相”的技巧（高级日志）
- 打印全部参数： 一个函数出错，不要只打印参数1，打印所有参数及
arguments对象。 - 打印堆栈：
console.trace()可以打印当前的调用栈，比console.log更能帮你看清是谁调用了这个函数。 - 打印对象全貌：
console.table(arrayOfObjects)可以清晰列出数组结构；console.dir(obj, {depth: null})可以展开对象的所有层级。 - 打印执行顺序： 在异步回调中，给每个回调一个编号
console.log('Callback #1 start'),看执行顺序是否符合预期。
IDE + 工具辅助（事倍功半）
- IntelliJ IDEA / VS Code：
- “Evaluate Expression”：在断点处可以运行任意表达式，即时查看
某个变量 + 某个函数的结果。 - Logpoint：VS Code 高级断点，你可以在不修改源代码的情况下，让 IDE 在遇到某行时自动打印日志（
{ variable }）,调试完删掉断点即可。 - Inspect Mode：悬停变量时按
F2可以查看其值在程序中所有被修改的历史记录。
- “Evaluate Expression”：在断点处可以运行任意表达式，即时查看
- 浏览器 DevTools：
- DOM Breakpoints：如果页面某个元素被意外修改或删除，可以右键该元素 -> Break on -> subtree modifications / attribute modifications / node removal。
- Network Tab：查看请求实际发出去的参数和响应内容，经常能发现“我以为发的是A，实际发的B”。
一个高效的排错逻辑流
- 看报错信息：读堆栈,找自己的代码行。
- 看变更：如果新改的，
git diff对比。 - 加日志：在怀疑的入口和出口打
console.log+ 唯一标签，验证输入/输出是否匹配。 - 最小化：尝试用最简形式复现。
- 查常见模式（异步、引用、类型）。
- 若仍无果：
git bisect找历史。 - 最后：休息一下，换个思路，或向同事复述问题（橡皮鸭调试法）。
掌握这些技巧后，90%的源码排错问题都能在几分钟内解决,而不是靠运气试错。
标签： 日志定位