用 Claude Code 秒级破译晦涩的错误信息

与错误信息搏斗是开发者的日常仪式。TypeScript 泛型推断报错和分布式系统的堆栈跟踪能吃掉数小时。把它们交给 Claude Code，根因和修复方案几秒内就会到手。

1. 概括海量的堆栈跟踪

第一步：用一句话理解”到底发生了什么”。

npm test 2>&1 | claude -p "
请将这段错误输出总结为：
- 1 行摘要
- 根因（最可能的推测）
- 修复方向
- 需要排查类似模式的地方
"

200 行的堆栈跟踪会变成”未处理的 Promise rejection。第 42 行缺少 await。“

2. 把 TypeScript 类型错误翻译成大白话

TS 错误信息密度太高，反而难以利用。

claude -p "
请用非工程师也能理解的语言解释这个 TypeScript 错误。
然后列出 3 种可能的错误模式，并给出修复示例。

---
$(npx tsc --noEmit 2>&1 | head -50)
---
"

一个嵌套泛型的 ‘Type X is not assignable to Y’ 就会变成”User 对象缺少 id 字段”。

3. 驯服 Rust 借用检查器的报错

借用检查器不再是你的敌人。

cargo build 2>&1 | claude -p "
针对这个 Rust borrow 错误：

1. 为什么是错的（从 lifetime 角度）
2. 三种修复模式：
   - 克隆该值
   - 调整引用的 lifetime
   - 重新设计 ownership
3. 每种方式的权衡
"

4. Docker / Kubernetes 日志之谜

Pod 崩溃的原因五花八门。

kubectl logs pod-name --previous | claude -p "
请从这段日志中识别崩溃原因。

检查：
- OOMKilled 还是应用错误？
- init container 失败？
- 缺失 env vars？
- Readiness probe 失败？

对每种可能性，建议下一条用于确认的 kubectl 命令。
"

它告诉你 下一步该跑什么——不只是告诉你出了什么问题。

5. 对构建错误进行分类

Webpack / Vite / esbuild 的错误跨越多个类别。

npm run build 2>&1 | claude -p "
请将这个构建错误归入：

A. 类型定义不匹配
B. 模块解析失败
C. 语法错误
D. 配置文件错误
E. 依赖版本冲突

然后给出该类别的典型解决模式。
"

6. 提取预防模式

别只是修复——防止复发。

claude -p "
关于我们刚刚修复的 bug（src/payments/webhook.ts 中缺失的 signature check）：

1. 为什么会出现这个 bug（根因分析）？
2. 为什么代码评审没发现？
3. 三层预防：
   - 用于检测的自动化测试
   - 禁止该模式的 lint 规则
   - 让其不可能发生的类型编码
4. 作为 checklist 项要加入 CLAUDE.md 的内容
"

一次修复产出 三层防御。

7. 在生产日志中发现反复出现的错误

按频率和影响排序优先级。

claude -p "
分析 logs/error-2026-04.log：

1. 按频率排名的前 10 个错误模式
2. 每个模式的频率和受影响用户数
3. 可能的根因
4. 优先级排序（频率 × 影响）

输出到 docs/error-analysis.md。
"

原本 1 小时的工程师工作变成 2 分钟。

用 Hooks 自动化错误分析

测试失败时自动运行错误分析。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash(npm test*)",
        "hooks": [
          {
            "type": "command",
            "command": "if [ $? -ne 0 ]; then echo 'Test failed. Ask Claude to analyze.'; fi"
          }
        ]
      }
    ]
  }
}

详见 Hooks 指南。

反模式

❌ 截断堆栈跟踪

“我只粘最后 3 行”——真正的原因往往埋在栈中部。把整段发过去。

❌ 没有上下文的错误文本

不说明你当时想做什么，就会得到错误的建议。

❌ 不看就采用修复方案

尤其当心 TS 建议里的 as any 逃避式写法。接受前务必审阅。

结语

• 让 Claude Code 概括庞大的堆栈跟踪
• 将 TS / Rust 错误翻译成清晰语言
• 从 K8s / Docker 日志中提取原因与下一步命令
• 将构建错误归入已知类别
• 把每次修复都扩展为 3 层预防
• 从生产日志中挖掘反复出现的模式

与错误搏斗的时间大约减少 10 倍。

相关：错误诊断 / 调试 / 日志与监控

官方文档：Anthropic Claude Code