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: 修复方案

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

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调用失败

排查步骤：
检查网络请求（F12 Network）
查看请求头/参数
检查CORS配置
验证API Key/Token
测试API直接访问
常见修复：
添加超时处理
添加重试逻辑
添加错误边界

场景2: 内存泄漏

排查工具：
Chrome DevTools Memory
Node: node --inspect
特征：
内存持续增长
页面越来越卡
定时任务越来越慢
常见原因：
事件监听未移除
全局变量累积
闭包引用未释放

场景3: 性能问题

排查工具：
Chrome DevTools Performance
Lighthouse
Web Vitals
优化方向：
减少重排重绘
代码分割懒加载
优化数据库查询
使用缓存

调试报告模板

# Bug调试报告
问题描述
[简短描述]
错误信息

复现步骤
[步骤1]
[步骤2]
根因分析
直接原因: [表象]
根本原因: [深层原因]
修复方案

预防措施
[ ] 添加测试用例
[ ] 增加空值判断
[ ] 添加日志监控
验证结果
[测试通过截图/日志]