# JSON schema

> 对JSON文档结构的正式描述——键、类型、必填字段、允许的值——用于约束和验证模型的输出。

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

## 含义

- 定义：JSON Schema是一套描述JSON的标准词汇：有哪些键、它们的类型、哪些是必填项、枚举值、最小值和匹配模式。
- 为什么重要：它是模型和你的代码之间的契约。即使只在提示词中贴一个简化的schema（键加类型），输出也会稳定得多。
- 如何应用：在提示词中给出schema，说明“只返回JSON”，并说明缺失值如何处理（用null，而不是猜测）。如果提供商支持结构化输出，就把schema传到那里，让格式在生成时就被强制执行。
- 在生产环境中，务必用schema验证结果，失败时重试或拒绝；永远不要以为JSON有效就代表内容正确。

## 示例

```text
从文本中提取订单。只返回符合以下schema的JSON：
{"orderId":"string","items":[{"sku":"string","qty":"number"}],"notes":"string|null"}
如果文本中缺少某个字段，用null。不要猜测。

文本：
"""[粘贴你的文本]"""
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E4%BB%8E%E6%96%87%E6%9C%AC%E4%B8%AD%E6%8F%90%E5%8F%96%E8%AE%A2%E5%8D%95%E3%80%82%E5%8F%AA%E8%BF%94%E5%9B%9E%E7%AC%A6%E5%90%88%E4%BB%A5%E4%B8%8Bschema%E7%9A%84JSON%EF%BC%9A%0A%7B%22orderId%22%3A%22string%22%2C%22items%22%3A%5B%7B%22sku%22%3A%22string%22%2C%22qty%22%3A%22number%22%7D%5D%2C%22notes%22%3A%22string%7Cnull%22%7D%0A%E5%A6%82%E6%9E%9C%E6%96%87%E6%9C%AC%E4%B8%AD%E7%BC%BA%E5%B0%91%E6%9F%90%E4%B8%AA%E5%AD%97%E6%AE%B5%EF%BC%8C%E7%94%A8null%E3%80%82%E4%B8%8D%E8%A6%81%E7%8C%9C%E6%B5%8B%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%E4%BD%A0%E7%9A%84%E6%96%87%E6%9C%AC%5D%22%22%22&purpose=data&target=gpt)

## 常见问题

### 在提示词里写上schema，就足以保证JSON有效吗？

它只能让有效JSON的可能性更高，并不能确保。要想有保证，就在提供商支持时使用其结构化输出功能，并在代码中验证结果。

### 要不要让它在JSON外面加Markdown代码块？

如果由程序读取，就不要：写明“只返回JSON，不要Markdown”，这样输出可以直接解析。

## 相关内容

- [如何强制输出有效的JSON（不带markdown）](https://www.promptea.me/zh/guides/json-output)
- [Structured output prompting: how to get reliable JSON, tables, and lists from any AI](https://www.promptea.me/zh/guides/structured-output-prompting)
- [Few-shot prompting: how to show examples instead of just explaining](https://www.promptea.me/zh/guides/few-shot-prompting)
- [结构化输出（Structured output）](https://www.promptea.me/zh/glossary/structured-output)
- [少样本提示（Few-shot prompting）](https://www.promptea.me/zh/glossary/few-shot)
