debug-pro

系统化调试方法论及语言专属调试命令。

七步调试协议

1. 复现（Reproduce） — 确保能稳定复现问题。记录精确的操作步骤、输入数据和运行环境。
2. 隔离（Isolate） — 缩小问题范围。注释掉部分代码、使用二分法排查，或通过 git bisect 检查最近的提交。
3. 假设（Hypothesize） — 提出一个具体、可验证的关于根本原因的理论。
4. 注入（Instrument） — 添加有针对性的日志、断点或断言。
5. 验证（Verify） — 确认根本原因。若假设错误，则返回第 3 步重新提出假设。
6. 修复（Fix） — 应用最小且正确的修复。调试期间避免顺手重构。
7. 回归测试（Regression Test） — 编写一条能捕获该缺陷的测试用例，并确认其通过。

语言专属调试

JavaScript / TypeScript

# Node.js 调试器
node --inspect-brk app.js
# Chrome DevTools：chrome://inspect

# 控制台调试
console.log(JSON.stringify(obj, null, 2))
console.trace('Call stack here')
console.time('perf'); /* code */ console.timeEnd('perf')

# 内存泄漏检测
node --expose-gc --max-old-space-size=4096 app.js

Python

# 内置调试器
python -m pdb script.py

# 代码内设断点
breakpoint()  # Python 3.7+

# 详细追踪内存分配
python -X tracemalloc script.py

# 性能分析
python -m cProfile -s cumulative script.py

Swift

# LLDB 调试
lldb ./MyApp
(lldb) breakpoint set --name main
(lldb) run
(lldb) po myVariable

# Xcode：Product → Profile（Instruments）

CSS / 布局

/* 为所有元素添加轮廓 */
* { outline: 1px solid red !important; }

/* 调试特定元素 */
.debug { background: rgba(255,0,0,0.1) !important; }

网络

# HTTP 调试
curl -v https://api.example.com/endpoint
curl -w "@curl-format.txt" -o /dev/null -s https://example.com

# DNS 查询
dig example.com
nslookup example.com

# 端口检查
lsof -i :3000
netstat -tlnp

Git Bisect

git bisect start
git bisect bad              # 当前提交存在缺陷
git bisect good abc1234     # 已知正常的提交哈希
# Git 将检出中间提交 —— 测试后执行：
git bisect good  # 或 git bisect bad
# 重复上述过程，直至定位到引入缺陷的提交
git bisect reset

常见错误模式

快速诊断命令

# 查看哪个进程占用了某端口？
lsof -i :PORT

# 查看某进程当前行为？
ps aux | grep PROCESS

# 监听文件变更
fswatch -r ./src

# 查看磁盘空间
df -h

# 查看系统资源占用（仅输出前 10 行）
top -l 1 | head -10