# 结构化输出（Structured output）

> 让模型以固定的、机器可读的格式作答——JSON、表格、带标签的字段——而不是自由行文。

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

## 含义

- 定义：结构化输出是指回答遵循预先定义的形式，程序（或赶时间的读者）可以放心依赖。JSON最常见，但固定的标题列表或表格也算。
- 为什么重要：自由文本难以解析，每次运行的结果也不一样。固定的结构让下游代码更简单，结果也可以相互比较。
- 如何应用：描述确切的形式（键和类型，或列名），说明缺失值如何处理，并写明“只返回这种格式”。如果模型或API有原生的结构化输出模式，就用它——这比在文字里提要求更可靠。
- 务必验证。回答可能格式正确但内容错误，所以使用前要检查类型、取值范围和必填字段。

## 示例

```text
对每张客服工单进行分类。只返回一个JSON数组；每张工单一个对象：
{"id":"string","category":"billing|bug|feature_request|other","urgency":"low|medium|high","summary":"最多15字"}
如果某张工单内容不清楚，category用"other"，urgency用"low"。不要Markdown，不要评论。

工单：
"""[粘贴工单]"""
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E5%AF%B9%E6%AF%8F%E5%BC%A0%E5%AE%A2%E6%9C%8D%E5%B7%A5%E5%8D%95%E8%BF%9B%E8%A1%8C%E5%88%86%E7%B1%BB%E3%80%82%E5%8F%AA%E8%BF%94%E5%9B%9E%E4%B8%80%E4%B8%AAJSON%E6%95%B0%E7%BB%84%EF%BC%9B%E6%AF%8F%E5%BC%A0%E5%B7%A5%E5%8D%95%E4%B8%80%E4%B8%AA%E5%AF%B9%E8%B1%A1%EF%BC%9A%0A%7B%22id%22%3A%22string%22%2C%22category%22%3A%22billing%7Cbug%7Cfeature_request%7Cother%22%2C%22urgency%22%3A%22low%7Cmedium%7Chigh%22%2C%22summary%22%3A%22%E6%9C%80%E5%A4%9A15%E5%AD%97%22%7D%0A%E5%A6%82%E6%9E%9C%E6%9F%90%E5%BC%A0%E5%B7%A5%E5%8D%95%E5%86%85%E5%AE%B9%E4%B8%8D%E6%B8%85%E6%A5%9A%EF%BC%8Ccategory%E7%94%A8%22other%22%EF%BC%8Curgency%E7%94%A8%22low%22%E3%80%82%E4%B8%8D%E8%A6%81Markdown%EF%BC%8C%E4%B8%8D%E8%A6%81%E8%AF%84%E8%AE%BA%E3%80%82%0A%0A%E5%B7%A5%E5%8D%95%EF%BC%9A%0A%22%22%22%5B%E7%B2%98%E8%B4%B4%E5%B7%A5%E5%8D%95%5D%22%22%22&purpose=data&target=gemini)

## 常见问题

### 当前所有模型都支持原生结构化输出吗？

不是。这取决于模型和API。Promptea的模型页面会针对每个现行模型，显示提供商文档是否列出了结构化输出，并附上核实日期。

### 如果模型在JSON前后加了文字怎么办？

写明“只返回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)
- [JSON schema](https://www.promptea.me/zh/glossary/json-schema)
- [少样本提示（Few-shot prompting）](https://www.promptea.me/zh/glossary/few-shot)
