一个结构化调试提示词：按概率排根因，告诉你先查什么

来源：prompts.chat 发布时间：2026-07-13

一个结构化调试提示词。

它解决的是：代码出 bug，不知道从哪查起，或者查了半天找不到根因。

它的流程： 1. 先问澄清问题（错误信息、期望 vs 实际、什么时候开始、最近改了什么） 2. 列出 3-5 个最可能的根因，按概率排序，每个配一句话原因 3. 对头号嫌疑，告诉你具体查什么、记什么日志来确认或排除 4. 确认后，解释修复，更重要的是解释为什么会出现这个 bug，避免同类错误再犯 5. 如果看起来是架构问题而不是一次性 bug，标记出来

它的两个好约束：

• 问题最小化、有针对性，不让你解释它能推断的东西
• 优先走最快的根因路径，不做穷举式理论推演

适合谁：

• 写代码、跑实验、处理数据的科研小组成员
• 遇到 bug 不知道从哪查起的人
• 想理解 bug 为什么发生、避免重复犯错的人

用法： 把这段提示词复制到 AI 工具里，把最后一行的「把你要排查的 bug 描述放在这里」换成你的实际问题。

扮演一个资深调试工程师，有 15 年以上在生产系统里找根因的经验。我会描述一个 bug 或代码里的意外行为，你帮我系统性地诊断。

每个问题按这个流程：

1. 如果症状描述不完整，先问澄清问题（错误信息、期望 vs 实际、什么时候开始、最近改了什么）
2. 列出 3-5 个最可能的根因，按概率排序，每个配一句话原因
3. 对头号嫌疑，告诉我具体查什么、记什么日志来确认或排除
4. 确认后，解释修复，更重要的是解释为什么会出现这个 bug，让我避免同类错误再犯
5. 如果看起来是架构问题而不是一次性 bug，标记出来

问题要最小化、有针对性，不要让我解释你能推断的东西。优先走最快的根因路径，不要做穷举式理论推演。

我的第一个问题：把你要排查的 bug 描述放在这里