向 AI 求助报错前，先补齐它看不见的现场

作者：LiuNengAI 运营方

把“运行不了，帮我修一下”发给 AI，很容易得到一串值得尝试、却不知道从哪里开始的建议。提问前可以先做一件小事：把你已经知道的现场写下来。

用一个假设的报错来说明

假设你在编辑器里运行一个 Python 文件，看见 ModuleNotFoundError: No module named 'pandas'，但记得自己已经安装过 pandas。只给报错原文，还不能说明安装命令和运行程序是否用的是同一个环境。

可以这样写求助说明：

目标：用 pandas 读取一个本地 CSV。
环境：Windows，编辑器选择的解释器是 Python 3.12；安装命令对应的解释器暂不确定。
复现：在一个新文件中执行 import pandas，仍出现同一报错。
原始报错：ModuleNotFoundError: No module named 'pandas'。
已尝试：运行过安装命令，但没有核对它对应的解释器。
希望判断：怎样确认运行文件的 Python 和安装依赖的 Python 是同一个？

这段说明不预设原因，更没有把“安装成功”当作已经验证的事实。它把下一步需要核对的问题摆了出来。这个例子也不是通用修复方案；不同环境需要按实际信息判断。

不确定的信息，直接写“不确定”

可以按六项整理：预期结果、运行环境、最小复现步骤、实际结果和原始报错、已经尝试的方法及结果、希望对方帮忙判断的问题。没查过的版本不要猜，没运行过的建议不要写成已验证。对方提出修改后，一次只核对一个变化，并记录结果，继续提问时带上新的证据。

先删敏感内容，再复制

日志、代码和截图里可能夹有 API 密钥、Cookie、账号资料、内部地址或客户数据。先自行删除，必要时换成能保留问题的虚构样例。也不要把 AI 输出的命令直接当成已验证的解决办法：先读懂，再在适合的测试环境里核对。

一个免费整理入口

如果不想手工排版，可以用 LiuNengAI 报错整理器填写这六项，生成可复制或下载的 Markdown。它只整理你填写的内容，不执行代码、不调用 AI、不猜原因，也不自动脱敏。无需登录，输入不上传，不保存草稿；关闭或刷新前请自行复制。也可保存网页离线使用。

工具：https://liunenglabs.xyz/guides/debug-report/
MIT 源码：https://github.com/a941249849/liunengai-debug-report

利益披露：作者为 LiuNengAI 运营方，网站另经营付费 ChatGPT 个人订阅服务，属于独立商业服务方，非 OpenAI 官方。本文工具免费，不需要购买订阅。