debug-master（调试大师）

Debug Master

AI调试大师，让Bug无处遁形。

核心升级

触发词

当用户说以下内容时激活：

• "报错"、"出错了"、"bug"
• "debug"、"帮我看看"
• "代码有问题"、"程序崩溃"
• "修复bug"、"这个错误"
• "为什么不行"、"怎么回事"

7步调试法 + AI增强

Step 1: 复现问题

❌ 不要：直接猜测原因
✅ 要：精确复现错误

复现命令：
node --trace-errors app.js
python -v debug script.py

Step 2: 捕获错误信息

错误类型识别：
├── SyntaxError → 语法错误（最容易修）
├── TypeError → 类型错误（检查变量类型）
├── ReferenceError → 引用错误（检查是否定义）
├── NetworkError → 网络错误（检查API/连接）
└── RuntimeError → 运行时错误（需要详细分析）

Step 3: AI根因分析（新增）

分析错误不只是表象，要找根本原因

Why-Tree 分析法：
Why: 报错 "Cannot read property 'map' of undefined"
  → Why: data变量是undefined
    → Why: API返回数据为空
      → Why: 接口超时未处理
        → 根本原因：缺少空值判断和超时处理

Step 4: 定位代码

// 错误定位技巧
const debug = require('debug')('app:*');

// 添加断点日志
console.log('🔍 DEBUG: 变量值', { variable: value });

// 使用source map
source-map /path/to/bundle.js.map

Step 5: 修复方案

修复优先级：
1. 立即止血（try-catch包裹）
2. 找到根本原因
3. 系统性修复（防止复发）
4. 添加测试用例

Step 6: 验证修复

# 自动测试
npm test
# 集成测试
npm run test:integration
# 端到端测试
npm run test:e2e

Step 7: 预防复发

添加到错误模式库
记录：错误类型 + 根本原因 + 修复方案 + 预防措施

支持语言

错误模式库

模式1: JavaScript类型错误

症状: "Cannot read property 'x' of undefined"
原因: 访问undefined/null的属性
修复:
  // ❌ 错误
  data.items.map(x => x.name)

  // ✅ 正确
  data?.items?.map(x => x.name) || []

模式2: Python导入错误

症状: "ModuleNotFoundError: No module named 'xxx'"
原因: 模块未安装或路径错误
修复:
  pip install xxx
  # 或检查 PYTHONPATH

模式3: 异步错误

症状: "UnhandledPromiseRejection"
原因: Promise错误未被捕获
修复:
  // 添加错误处理
  promise.catch(err => console.error(err))
  // 或使用 try-await
  try { await asyncFn() } catch (err) {}

模式4: 并发竞争

症状: 数据不一致 / 状态错乱
原因: 多线程同时修改同一数据
修复:
  // 使用锁或原子操作
  // Go: sync.Mutex
  // Python: threading.Lock
  // JS: async-await + 状态管理

自动测试生成

根据错误生成测试用例

当修复一个bug时，自动生成防止复发的测试：

原始错误：
TypeError: Cannot read property 'name' of undefined

自动生成测试：
test('should handle undefined user gracefully', () => {
  const result = getUserName(undefined);
  expect(result).toBe('Guest');
});

调试工具箱

// 通用调试工具
const debug = {
  log: (...args) => console.log('[DEBUG]', ...args),
  error: (...args) => console.error('[ERROR]', ...args),
  warn: (...args) => console.warn('[WARN]', ...args),
};

// 检查变量
const inspect = (obj) => JSON.stringify(obj, null, 2);

// 性能分析
console.time('operation');
// ... operation ...
console.timeEnd('operation');

常见场景解决方案

场景1: API调用失败

排查步骤：
1. 检查网络请求（F12 Network）
2. 查看请求头/参数
3. 检查CORS配置
4. 验证API Key/Token
5. 测试API直接访问

常见修复：
- 添加超时处理
- 添加重试逻辑
- 添加错误边界

场景2: 内存泄漏

排查工具：
- Chrome DevTools Memory
- Node: node --inspect

特征：
- 内存持续增长
- 页面越来越卡
- 定时任务越来越慢

常见原因：
- 事件监听未移除
- 全局变量累积
- 闭包引用未释放

场景3: 性能问题

排查工具：
- Chrome DevTools Performance
- Lighthouse
- Web Vitals

优化方向：
- 减少重排重绘
- 代码分割懒加载
- 优化数据库查询
- 使用缓存

调试报告模板

# Bug调试报告

## 问题描述
[简短描述]

## 错误信息

[粘贴错误日志]

## 复现步骤
1. [步骤1]
2. [步骤2]

## 根因分析
**直接原因**: [表象]
**根本原因**: [深层原因]

## 修复方案

[修复代码]

## 预防措施
- [ ] 添加测试用例
- [ ] 增加空值判断
- [ ] 添加日志监控

## 验证结果
[测试通过截图/日志]