debug-pro

系统化的调试方法论及特定语言的调试命令。

七步调试法

1. 复现— 让问题稳定复现。记录确切的步骤、输入和环境。
2. 隔离— 缩小范围。注释代码，使用二分法，用git bisect检查最近的提交。
3. 假设— 对根本原因形成一个具体、可测试的假设。
4. 探查— 添加有针对性的日志记录、断点或断言。
5. 验证— 确认根本原因。如果假设错误，返回步骤3。
6. 修复— 应用最小且正确的修复。调试时克制重构的冲动。
7. 回归测试— 编写一个能捕获此错误的测试。验证其通过。

特定语言调试

JavaScript / TypeScript

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

# 控制台调试
console.log(JSON.stringify(obj, null, 2))
console.trace('调用堆栈在此')
console.time('perf'); /* 代码 */ 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 :端口号 # 这个进程在做什么？ ps aux | grep 进程名 # 监控文件变化 fswatch -r ./src # 磁盘空间 df -h # 系统资源使用情况 top -l 1 | head -10

# What's using this port?
lsof -i :PORT

# What's this process doing?
ps aux | grep PROCESS

# Watch file changes
fswatch -r ./src

# Disk space
df -h

# System resource usage
top -l 1 | head -10