这是一份 AI 排查程序报错检查清单，复制到笔记里，每次使用前过一遍。AI 排错是把报错信息、相关代码、运行环境和复现步骤交给 AI，让它分析可能的原因、给出排查顺序和修复建议。把 AI 接入日常工作流时，最重要的是明确哪一步由 AI 起草、哪一步由人把关。分工清楚，效率和质量才能兼顾。

什么时候拿出这份清单

  • 问题偶发，不知道从哪里开始查。
  • 修改了代码后出现意料之外的行为。

多说一句：AI 的价值在于帮你快速列出假设并设计验证方法，但真正的线索来自你在真实环境中观察到的结果。

使用前

  • 收集完整的错误信息，包括堆栈和日志片段。
  • 说明运行环境：语言版本、框架版本、操作系统。
  • 提供相关代码和最近的改动。
  • 确认材料中不包含服务器 IP、账号口令、证书私钥和内部拓扑，必要时先脱敏。

使用中

  • 描述复现步骤，以及预期行为和实际行为。
  • 让 AI 列出可能原因并按可能性排序，给出验证方法。
  • 贴完整堆栈，关键线索常在中间。
  • 先理解原因再修复，否则可能只是掩盖问题。

使用后

  • 逐个验证，把结果反馈给 AI，直到定位问题。
  • 先在测试环境验证，理解命令的作用和影响。
  • 已记录本次有效的写法，便于下次复用。
  • 运维工程师特别注意：让 AI 写的命令先在测试环境执行，并要求它说明每个参数的作用。

红线清单

  • 只说“程序报错了”
  • 只贴报错最后一行。
  • 让 AI 直接给修复代码。
  • 同时尝试多个修改。

配套模板

清单配合下面的模板使用效果更好：

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

按清单完成后，结果大致会是这样（虚构示例）：

示例（虚构）：一位开发者的程序在本地正常，部署后报“找不到模块”。AI 列出三个可能原因：依赖未安装、版本不一致、路径大小写问题，并给出对应的检查命令。第三个检查发现文件名大小写在服务器系统上不匹配，问题解决。

让清单更好用的两个习惯

  • 把“已经排除的原因”告诉 AI，避免它重复建议。
  • 把排查过程记录下来，形成团队的问题知识库。

清单之外

AI 给的原因不对怎么办？ 把验证结果反馈给它，说明哪个原因已排除，让它重新分析。

如何避免同样的问题再次出现？ 修复后补充测试、完善日志，并把原因和解决方法记录下来。

清单的使用建议

清单的意义在于把容易忘的动作固定下来。刚开始每一项都勾一遍，几次之后你会发现真正容易漏的只有两三项，把它们标红即可。如果你是运维工程师，处理“处理 2 起磁盘告警和 1 起证书过期隐患”这类工作前过一遍清单，最能体现价值。

相关阅读