# 如何调试输出不理想的提示词

> 一套系统的方法：找出提示词失效的原因，不靠反复试错就把它修好。

来源：Promptea — https://www.promptea.me/zh/guides/prompt-debugging · 语言：简体中文 · 最后更新：2026-11-14

## 最常见的失效模式

- 缺少目标：你描述了任务，却没说明什么样才算成功——模型只能去猜验收标准。
- 范围含糊：“简短”对你来说是50字，对模型来说可能是500字。请写明数字。
- 缺少上下文：在你脑中让任务毫无歧义的约束、定义或背景，模型并不知道。
- 格式不对：你想要表格，模型给了大段文字；你想要JSON，模型却加上了markdown代码块。
- 指令冲突：同一个提示词里既要“简洁”又要“面面俱到”，结果只会是两头折中的平庸内容。
- 缺少信息时没有兜底：模型不知道某件事时，会自己把空白补上。告诉它把缺口标出来，可以防止幻觉。

## 调试流程

- 第1步——锁定症状：准确写下哪里出了问题。“太长”“格式不对”“编造事实”“没抓住重点”“多次运行结果不一致”。
- 第2步——找出缺失的指令：针对每个症状，问自己“要避免这种情况，我需要对一个能干的人说什么？”缺的那条指令，就是要加进提示词的内容。
- 第3步——一次只加一个修复：每次运行只改一个变量，这样你才知道到底是什么起了作用。同时改好几处，就无法判断是哪一处生效。
- 第4步——用边界情况测试：分别用更难的任务版本、很短的输入、很长的输入和缺少数据的输入，运行修复后的提示词。真实场景中的提示词需要应对所有这些情况。
- 第5步——用格式示例固定有效的写法：输出正确之后，加一行你想要的确切格式示例。这样复用提示词时，输出就不会跑偏。

在靠反复试错改写一条失效的提示词之前，先找出缺失的目标、上下文或格式，可以使用[提示词分析器](https://www.promptea.me/zh/analyzer)。

## 模板

### 提示词自我诊断

```text
你是一名提示词质量审查员。分析下面的提示词，找出它可能产生糟糕输出的3个主要原因。

针对每个问题：
1. 说出失效模式的名称（例如“缺少格式约束”“范围含糊”“缺少信息时没有兜底”）。
2. 引用提示词中导致这个问题的原文。
3. 用一句话写出修复方法。

然后，应用全部三项修复，重写整个提示词。

待审查的提示词：
"""
[粘贴输出效果不好的提示词]
"""
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E4%BD%A0%E6%98%AF%E4%B8%80%E5%90%8D%E6%8F%90%E7%A4%BA%E8%AF%8D%E8%B4%A8%E9%87%8F%E5%AE%A1%E6%9F%A5%E5%91%98%E3%80%82%E5%88%86%E6%9E%90%E4%B8%8B%E9%9D%A2%E7%9A%84%E6%8F%90%E7%A4%BA%E8%AF%8D%EF%BC%8C%E6%89%BE%E5%87%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E4%BA%A7%E7%94%9F%E7%B3%9F%E7%B3%95%E8%BE%93%E5%87%BA%E7%9A%843%E4%B8%AA%E4%B8%BB%E8%A6%81%E5%8E%9F%E5%9B%A0%E3%80%82%0A%0A%E9%92%88%E5%AF%B9%E6%AF%8F%E4%B8%AA%E9%97%AE%E9%A2%98%EF%BC%9A%0A1.+%E8%AF%B4%E5%87%BA%E5%A4%B1%E6%95%88%E6%A8%A1%E5%BC%8F%E7%9A%84%E5%90%8D%E7%A7%B0%EF%BC%88%E4%BE%8B%E5%A6%82%E2%80%9C%E7%BC%BA%E5%B0%91%E6%A0%BC%E5%BC%8F%E7%BA%A6%E6%9D%9F%E2%80%9D%E2%80%9C%E8%8C%83%E5%9B%B4%E5%90%AB%E7%B3%8A%E2%80%9D%E2%80%9C%E7%BC%BA%E5%B0%91%E4%BF%A1%E6%81%AF%E6%97%B6%E6%B2%A1%E6%9C%89%E5%85%9C%E5%BA%95%E2%80%9D%EF%BC%89%E3%80%82%0A2.+%E5%BC%95%E7%94%A8%E6%8F%90%E7%A4%BA%E8%AF%8D%E4%B8%AD%E5%AF%BC%E8%87%B4%E8%BF%99%E4%B8%AA%E9%97%AE%E9%A2%98%E7%9A%84%E5%8E%9F%E6%96%87%E3%80%82%0A3.+%E7%94%A8%E4%B8%80%E5%8F%A5%E8%AF%9D%E5%86%99%E5%87%BA%E4%BF%AE%E5%A4%8D%E6%96%B9%E6%B3%95%E3%80%82%0A%0A%E7%84%B6%E5%90%8E%EF%BC%8C%E5%BA%94%E7%94%A8%E5%85%A8%E9%83%A8%E4%B8%89%E9%A1%B9%E4%BF%AE%E5%A4%8D%EF%BC%8C%E9%87%8D%E5%86%99%E6%95%B4%E4%B8%AA%E6%8F%90%E7%A4%BA%E8%AF%8D%E3%80%82%0A%0A%E5%BE%85%E5%AE%A1%E6%9F%A5%E7%9A%84%E6%8F%90%E7%A4%BA%E8%AF%8D%EF%BC%9A%0A%22%22%22%0A%5B%E7%B2%98%E8%B4%B4%E8%BE%93%E5%87%BA%E6%95%88%E6%9E%9C%E4%B8%8D%E5%A5%BD%E7%9A%84%E6%8F%90%E7%A4%BA%E8%AF%8D%5D%0A%22%22%22&purpose=text&target=gpt)

### 输出对比：改了什么？

```text
对比下面两个提示词输出，并说明怎样修改指令，才能得到输出B而不是输出A。

输出A（差）：
"""
[粘贴差的输出]
"""

输出B（好）：
"""
[粘贴一个你真正想要的输出示例]
"""

重点关注：
- 生成A的提示词缺少了哪条输出格式规则？
- 加上什么约束或示例，能让A不可能出现、让B稳定可预期？
- 写出对原提示词最小的补充（1–3行），以弥补这个差距。
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E5%AF%B9%E6%AF%94%E4%B8%8B%E9%9D%A2%E4%B8%A4%E4%B8%AA%E6%8F%90%E7%A4%BA%E8%AF%8D%E8%BE%93%E5%87%BA%EF%BC%8C%E5%B9%B6%E8%AF%B4%E6%98%8E%E6%80%8E%E6%A0%B7%E4%BF%AE%E6%94%B9%E6%8C%87%E4%BB%A4%EF%BC%8C%E6%89%8D%E8%83%BD%E5%BE%97%E5%88%B0%E8%BE%93%E5%87%BAB%E8%80%8C%E4%B8%8D%E6%98%AF%E8%BE%93%E5%87%BAA%E3%80%82%0A%0A%E8%BE%93%E5%87%BAA%EF%BC%88%E5%B7%AE%EF%BC%89%EF%BC%9A%0A%22%22%22%0A%5B%E7%B2%98%E8%B4%B4%E5%B7%AE%E7%9A%84%E8%BE%93%E5%87%BA%5D%0A%22%22%22%0A%0A%E8%BE%93%E5%87%BAB%EF%BC%88%E5%A5%BD%EF%BC%89%EF%BC%9A%0A%22%22%22%0A%5B%E7%B2%98%E8%B4%B4%E4%B8%80%E4%B8%AA%E4%BD%A0%E7%9C%9F%E6%AD%A3%E6%83%B3%E8%A6%81%E7%9A%84%E8%BE%93%E5%87%BA%E7%A4%BA%E4%BE%8B%5D%0A%22%22%22%0A%0A%E9%87%8D%E7%82%B9%E5%85%B3%E6%B3%A8%EF%BC%9A%0A-+%E7%94%9F%E6%88%90A%E7%9A%84%E6%8F%90%E7%A4%BA%E8%AF%8D%E7%BC%BA%E5%B0%91%E4%BA%86%E5%93%AA%E6%9D%A1%E8%BE%93%E5%87%BA%E6%A0%BC%E5%BC%8F%E8%A7%84%E5%88%99%EF%BC%9F%0A-+%E5%8A%A0%E4%B8%8A%E4%BB%80%E4%B9%88%E7%BA%A6%E6%9D%9F%E6%88%96%E7%A4%BA%E4%BE%8B%EF%BC%8C%E8%83%BD%E8%AE%A9A%E4%B8%8D%E5%8F%AF%E8%83%BD%E5%87%BA%E7%8E%B0%E3%80%81%E8%AE%A9B%E7%A8%B3%E5%AE%9A%E5%8F%AF%E9%A2%84%E6%9C%9F%EF%BC%9F%0A-+%E5%86%99%E5%87%BA%E5%AF%B9%E5%8E%9F%E6%8F%90%E7%A4%BA%E8%AF%8D%E6%9C%80%E5%B0%8F%E7%9A%84%E8%A1%A5%E5%85%85%EF%BC%881%E2%80%933%E8%A1%8C%EF%BC%89%EF%BC%8C%E4%BB%A5%E5%BC%A5%E8%A1%A5%E8%BF%99%E4%B8%AA%E5%B7%AE%E8%B7%9D%E3%80%82&purpose=text&target=claude)

## 常见问题

### 为什么我的提示词有时有效，有时无效？

输出不一致，通常意味着提示词存在歧义，模型每次的理解都不一样——没有唯一正确的解读，它就随机选一种。解决办法是减少歧义：用示例规定格式，用数字限定范围，删掉相互冲突的指令。如果非常需要稳定一致，而你又能控制模型的temperature（温度）设置，就把它调低；在支持的情况下，也可以用JSON schema锁定输出。

### 修好一个提示词通常需要迭代几次？

如果每次只改一处，大多数提示词问题在2–3次迭代内就能解决。会拖长过程的常见错误有：一次改多处（无法判断是哪一处起了作用）、只用原始输入测试（漏掉边界情况），以及只治症状、不找根本原因。能稳定处理5个不同测试输入的提示词，才算真正修好；只能通过原始测试用例的提示词，到了生产环境就会出问题。
