这是一份 AI 排查程序报错速查表,适合收藏后随用随查。AI 排错是把报错信息、相关代码、运行环境和复现步骤交给 AI,让它分析可能的原因、给出排查顺序和修复建议。

一句话理解

AI 排错 = 它适合代码报错、软件故障、配置问题和数据异常等场景。原理:AI 见过大量常见错误及其解决方法,能根据报错信息和上下文快速缩小可能原因的范围,并帮你制定有条理的排查步骤。

场景速查

场景推荐做法
程序报错,但看不懂错误信息把“已经排除的原因”告诉 AI,避免它重复建议
问题偶发,不知道从哪里开始查要求 AI 解释它的推理,你更容易判断方向是否正确
部署、配置、环境相关的问题对偶发问题,先让 AI 建议加日志,再收集更多信息
修改了代码后出现意料之外的行为修复后让 AI 帮你写一个能复现原问题的测试

操作要点

  • 第 1 步:收集完整的错误信息,包括堆栈和日志片段。
  • 第 3 步:提供相关代码和最近的改动。
  • 第 4 步:描述复现步骤,以及预期行为和实际行为。
  • 第 6 步:逐个验证,把结果反馈给 AI,直到定位问题。

模板速取

示例场景:财务准备费用分析报告。

我遇到一个问题,请帮我排查。
- 现象:[描述]
- 完整报错:[粘贴报错和堆栈]
- 环境:[语言/框架/系统版本]
- 最近的改动:[描述]
- 复现步骤:[步骤]
- 预期结果 vs 实际结果:[描述]
请:
1. 解释报错的含义;
2. 列出 3-5 个可能原因,按可能性排序;
3. 对每个原因给出验证方法(我该看什么、运行什么);
4. 先不要直接给修复代码,等我反馈验证结果。

错误写法对照

错误写法正确做法
只说“程序报错了”提供完整报错、环境、代码和复现步骤,信息越完整定位越快
只贴报错最后一行贴完整堆栈,关键线索常在中间
让 AI 直接给修复代码先理解原因再修复,否则可能只是掩盖问题
同时尝试多个修改一次只改一处并验证,否则不知道哪个修改起了作用
在生产环境直接执行 AI 给的命令先在测试环境验证,理解命令的作用和影响

速答

  • 报错信息里有敏感信息怎么办? 替换掉路径中的用户名、内网地址、密钥等,再提交。
  • AI 给的原因不对怎么办? 把验证结果反馈给它,说明哪个原因已排除,让它重新分析。

速记:AI 排错的第一步是“收集完整的错误信息”,结果一定要人工复核。把 AI 接入日常工作流时,最重要的是明确哪一步由 AI 起草、哪一步由人把关。分工清楚,效率和质量才能兼顾。

适合谁

这份速查表适合已经接触过 AI 工具、想把 AI 排错用得更规范的读者,例如需要经常处理费用分析报告的财务。完全没用过的话,建议先看入门教程再回来查表。

相关阅读