每天写业务代码、修线上问题、参加评审的后端或全栈开发，日常工作里真正写代码的时间常被排查问题、写文档和同步进度挤占，很多重复性的文字和样板代码其实可以交给 AI 起草。排查报错时，大部分时间花在理解错误信息和缩小范围上，而这恰好是 AI 擅长的。本文给出程序员用 AI 排查代码报错的一套可直接照抄的做法：把完整报错、相关代码、运行环境和你已经尝试过的方法一起交给 AI，让它先列出可能原因和验证步骤，而不是直接改代码。

场景：程序员为什么需要 AI 排查代码报错

程序员在处理“修复支付回调偶发超时问题”相关的工作时，程序突然报错，错误信息一大串，搜索引擎上的答案五花八门。时间紧，需要尽快定位问题。现实中，程序员还得兼顾“补齐用户模块的单元测试”等日常事务，所以更需要一套拿来就能用的方法。

用什么工具

可以用编程助手（GitHub Copilot Chat、Cursor、通义灵码、CodeGeeX 等）在编辑器里直接提问，它能看到相关代码；也可以把信息整理好贴给 ChatGPT、Claude、DeepSeek 等对话助手。

一个虚构的例子

下面这个例子是虚构的：晓雯遇到的难题是“依赖的第三方支付 SDK 下周升级，可能需要适配”。为了不让它拖慢“修复支付回调偶发超时问题”的进度，晓雯决定借助 AI 排查代码报错。第一次只写了一句简单的要求，结果很空泛；第二次把对象（技术负责人）、目的和限制条件都写清楚，输出就可用多了。这也是本文提示词模板要把背景写全的原因。

分步操作

  1. 复制完整的报错信息和堆栈，不要只截一行
  2. 附上出错位置的代码和相关的配置
  3. 写明运行环境：语言版本、框架版本、操作系统
  4. 说明你已经尝试过什么、结果如何
  5. 让 AI 给出可能原因和逐步验证方法，再动手修改

提示词示例

把方括号和括号里的内容换成你自己的信息即可：

【背景】最近在处理“修复支付回调偶发超时问题”，同时要准备“上线订单服务灰度”。
我在运行一个 Python 3.11 脚本时报错，请帮我分析。

背景：这是程序员用来处理“接口调用记录”数据的脚本，读取 CSV 后按服务名汇总耗时毫秒。
报错信息：

Traceback (most recent call last): File “report.py”, line 18, in total = df.groupby(“category”)[“amount”].sum() KeyError: ‘amount’

相关代码：
```python
df = pd.read_csv("data.csv")
total = df.groupby("category")["amount"].sum()

我已经确认 CSV 文件里有“amount”这一列。

请：

  1. 列出最可能的 3 个原因，按可能性排序
  2. 给出每个原因的验证方法（具体代码）
  3. 给出修复后的代码

## AI 输出示例（示意）

以下是一段示意性的输出，内容基于虚构的工作记录，仅用于展示格式和思路，实际结果会因工具和输入不同而变化：

> **可能原因**
> 1. 列名带有空格或不可见字符（例如“amount ”或 BOM 头）——最常见
> 2. CSV 分隔符不是逗号，整行被读成了一列
> 3. 文件编码问题导致表头解析异常
>
> **验证方法**
> ```python
> print(df.columns.tolist())   # 查看真实列名
> print(df.shape)              # 列数为 1 说明分隔符不对
> ```
>
> **修复**
> ```python
> df = pd.read_csv("data.csv", encoding="utf-8-sig")
> df.columns = df.columns.str.strip()
> total = df.groupby("category")["amount"].sum()
> ```

注意示例中所有内容都是虚构的。实际使用时，AI 的输出质量取决于你提供的材料是否完整、要求是否具体。

## 避坑指南

- 让 AI 先给验证方法而不是直接改代码，避免越改越乱。
- 密钥、连接串和密钥、内网地址、数据库连接串和用户数据要替换成占位符再提问。

### 给程序员的特别提醒

让 AI 先解释思路再给代码，便于你判断方向对不对。另外，AI 生成的代码必须经过本地运行、测试和代码评审，不要直接合入主干。

## 还可以这样用

- 性能问题：附上耗时数据，让 AI 找出瓶颈。
- 依赖冲突：把安装报错交给 AI，分析版本兼容问题。

## 相关阅读

- [程序员用 AI 写 SQL 查询：提示词与 SQL 示例](/posts/2026-10-16-programmer-sql-query/)
- [程序员用 AI 写科普文章：提示词与科普示例](/posts/2026-10-16-programmer-science-article/)
- [测试工程师用 AI 排查代码报错：正确提问让 AI 定位问题](/posts/2026-10-16-qa-engineer-debug-error/)
- 延伸：[编码 Agent 工作流：从需求拆解到合并请求的人机协作模式](/posts/2026-07-18-coding-agent-workflow/)
- 更多场景：[AI 使用示例合集](/categories/ai-examples/)，或按标签浏览[#程序员](/tags/程序员/)、[#排查报错](/tags/排查报错/)