# 如何强制输出有效的JSON（不带markdown）

> 把数据提取并转换成严格JSON的提示词模板：写明字段、类型、null规则和校验步骤，让输出可以直接解析。

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

## 有效的规则

- 告诉它：“只输出JSON”，并禁止任何多余的文字。
- 定义一个schema（键、类型、允许的取值）。
- 说明缺少字段时怎么办（用null还是省略）。
- 要求再检查一遍：校验并修正JSON。

## 改写前→改写后：从“给我JSON”到一份契约

- 改写前：“把这封邮件里的联系人信息以JSON格式给我。”典型结果：一句开场白、一个markdown代码块，而且每次运行的键都不一样。
- 改写后：“提取联系人信息。只返回有效的JSON，不要markdown。Schema：{name: string, email: string|null, phone: string|null}。缺少的信息一律用null；不要猜测。”
- 改了什么：输出变成了一个确定的schema，规定了缺失值的处理方式，并禁止多余的文字，所以同一个提示词每次都会给出相同的结构。

## 用代码校验，别靠运气

- 使用之前，先用真正的JSON解析器解析响应，并对照schema检查（必填键、类型、允许的取值）。
- 校验失败时，附上错误信息重试一次：“你之前的输出没有通过校验：[错误]。只返回修正后的JSON。”
- 如果模型或API提供原生的结构化输出模式，就使用它：这样格式会在生成时被强制执行，而不是靠文字去请求。Promptea的模型页面会标明当前哪些模型提供这一模式。
- 有效的JSON不等于内容正确。要对照原文抽查取值，尤其是数字和日期。

想在运行前确认JSON提示词写明了字段、类型和null规则，请使用[提示词分析器](https://www.promptea.me/zh/analyzer)。

## 模板

### 提取结构化JSON

```text
从下面的文本中提取数据。
只返回有效的JSON（不要markdown，不要注释）。

Schema：
{
  "people": [
    {
      "name": "string",
      "role": "string|null",
      "email": "string|null"
    }
  ],
  "dates": ["YYYY-MM-DD"]
}

规则：
- 如果缺少信息，使用null（不要编造）。
- 如果日期有歧义，就省略它。

文本：
"""[粘贴到这里]"""

最终输出之前，校验输出是有效的JSON，并且符合schema。
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E4%BB%8E%E4%B8%8B%E9%9D%A2%E7%9A%84%E6%96%87%E6%9C%AC%E4%B8%AD%E6%8F%90%E5%8F%96%E6%95%B0%E6%8D%AE%E3%80%82%0A%E5%8F%AA%E8%BF%94%E5%9B%9E%E6%9C%89%E6%95%88%E7%9A%84JSON%EF%BC%88%E4%B8%8D%E8%A6%81markdown%EF%BC%8C%E4%B8%8D%E8%A6%81%E6%B3%A8%E9%87%8A%EF%BC%89%E3%80%82%0A%0ASchema%EF%BC%9A%0A%7B%0A++%22people%22%3A+%5B%0A++++%7B%0A++++++%22name%22%3A+%22string%22%2C%0A++++++%22role%22%3A+%22string%7Cnull%22%2C%0A++++++%22email%22%3A+%22string%7Cnull%22%0A++++%7D%0A++%5D%2C%0A++%22dates%22%3A+%5B%22YYYY-MM-DD%22%5D%0A%7D%0A%0A%E8%A7%84%E5%88%99%EF%BC%9A%0A-+%E5%A6%82%E6%9E%9C%E7%BC%BA%E5%B0%91%E4%BF%A1%E6%81%AF%EF%BC%8C%E4%BD%BF%E7%94%A8null%EF%BC%88%E4%B8%8D%E8%A6%81%E7%BC%96%E9%80%A0%EF%BC%89%E3%80%82%0A-+%E5%A6%82%E6%9E%9C%E6%97%A5%E6%9C%9F%E6%9C%89%E6%AD%A7%E4%B9%89%EF%BC%8C%E5%B0%B1%E7%9C%81%E7%95%A5%E5%AE%83%E3%80%82%0A%0A%E6%96%87%E6%9C%AC%EF%BC%9A%0A%22%22%22%5B%E7%B2%98%E8%B4%B4%E5%88%B0%E8%BF%99%E9%87%8C%5D%22%22%22%0A%0A%E6%9C%80%E7%BB%88%E8%BE%93%E5%87%BA%E4%B9%8B%E5%89%8D%EF%BC%8C%E6%A0%A1%E9%AA%8C%E8%BE%93%E5%87%BA%E6%98%AF%E6%9C%89%E6%95%88%E7%9A%84JSON%EF%BC%8C%E5%B9%B6%E4%B8%94%E7%AC%A6%E5%90%88schema%E3%80%82&purpose=data&target=gpt)

### 把JSON转换成新的schema

```text
你会收到JSON输入。把它转换成下面的输出schema。
只返回有效的JSON。

输入JSON：
"""[粘贴JSON]"""

输出schema：
{
  "items": [
    { "id": "string", "title": "string", "tags": ["string"] }
  ]
}

规则：
- 保留原意；不要编造新的条目。
- 如果某个输入字段无法对应，就忽略它。
- 确保tags全部为小写。

输出之前先校验JSON。
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E4%BD%A0%E4%BC%9A%E6%94%B6%E5%88%B0JSON%E8%BE%93%E5%85%A5%E3%80%82%E6%8A%8A%E5%AE%83%E8%BD%AC%E6%8D%A2%E6%88%90%E4%B8%8B%E9%9D%A2%E7%9A%84%E8%BE%93%E5%87%BAschema%E3%80%82%0A%E5%8F%AA%E8%BF%94%E5%9B%9E%E6%9C%89%E6%95%88%E7%9A%84JSON%E3%80%82%0A%0A%E8%BE%93%E5%85%A5JSON%EF%BC%9A%0A%22%22%22%5B%E7%B2%98%E8%B4%B4JSON%5D%22%22%22%0A%0A%E8%BE%93%E5%87%BAschema%EF%BC%9A%0A%7B%0A++%22items%22%3A+%5B%0A++++%7B+%22id%22%3A+%22string%22%2C+%22title%22%3A+%22string%22%2C+%22tags%22%3A+%5B%22string%22%5D+%7D%0A++%5D%0A%7D%0A%0A%E8%A7%84%E5%88%99%EF%BC%9A%0A-+%E4%BF%9D%E7%95%99%E5%8E%9F%E6%84%8F%EF%BC%9B%E4%B8%8D%E8%A6%81%E7%BC%96%E9%80%A0%E6%96%B0%E7%9A%84%E6%9D%A1%E7%9B%AE%E3%80%82%0A-+%E5%A6%82%E6%9E%9C%E6%9F%90%E4%B8%AA%E8%BE%93%E5%85%A5%E5%AD%97%E6%AE%B5%E6%97%A0%E6%B3%95%E5%AF%B9%E5%BA%94%EF%BC%8C%E5%B0%B1%E5%BF%BD%E7%95%A5%E5%AE%83%E3%80%82%0A-+%E7%A1%AE%E4%BF%9Dtags%E5%85%A8%E9%83%A8%E4%B8%BA%E5%B0%8F%E5%86%99%E3%80%82%0A%0A%E8%BE%93%E5%87%BA%E4%B9%8B%E5%89%8D%E5%85%88%E6%A0%A1%E9%AA%8CJSON%E3%80%82&purpose=data&target=gemini)

## 常见问题

### 为什么模型还是会加上多余的文字？

因为这条约束对它来说分量还不够。重复这条约束，提供schema，并要求它校验。

### 我应该用JSON Schema吗？

如果是严格的系统集成，应该用。即使是简化的schema（键+类型）也很有帮助。

### 值缺失时，模型应该返回什么？

选定一条规则并写明：缺失的值用null，或者省略这个键。两种混用，会迫使你的代码同时处理两种情况。还要告诉它不要猜测。

### 可以在同一个回答里同时要JSON和解释吗？

把两者分开：把解释放进一个专门的键，例如"notes"，或者另发一次请求。JSON之外的文字会导致解析失败。
