本页速答
Claude怎么输出固定JSON(2026-11-09):在提示词中给出目标对象的字段表或 JSON Schema 风格描述,附上一个合法示例,写明「只输出一个JSON对象,不要解释」。生成后用 JSON 解析器和(如有)Schema 校验器检查。失败时把解析器报错原样贴回去,要求只修正格式。开发者请查阅官方 Structured outputs,而不是把聊天里的文本直接当生产 API。
| 要素 | 你要写清楚 | 不写会发生 |
|---|---|---|
| 字段名 | 英文键名、是否必填 | 同义词乱跳(title/name混用) |
| 类型 | string、number、boolean、array、null策略 | 数字被写成中文或字符串 |
| 枚举 | 允许取值列表 | 冒出未定义状态 |
| 示例 | 一条完整合法对象 | 结构漂移 |
| 输出边界 | 禁止额外散文、禁止注释 | 解析器直接报错 |
聊天里如何约束
网页对话没有必要假设存在一个叫做 JSON Mode 的永久按钮。把约束写进提示词本身:角色(你是数据格式化助手)、输入(原始文本或表格)、输出(单一对象或对象数组)、失败策略(缺信息时用null并在warnings数组说明,而不是编造)。
长文本提取时,先让它列出将要使用的字段,你确认后再要求正式输出,分两轮比一轮「又分析又生成」更稳。需要分析表格时,可先按 清洗 CSV 的思路整理列,再映射到JSON,避免在脏数据上直接嵌套三层对象。
如果界面把回复渲染成好看的卡片,你复制时要选择「原始文本」或代码块内容,以免复制到额外的UI字符。复制后立刻在本地解析一次,不要目测觉得「像JSON」就交给下游系统。
可复制提示词
你是数据格式化助手。根据我提供的原文,只输出一个可被JSON.parse解析的对象,不要Markdown围栏以外的任何文字,不要注释,不要尾随逗号。
Schema:
{
"title": string, // 必填,原文标题或一句话主题
"items": [ // 必填,可为空数组
{
"name": string,
"qty": number, // 阿拉伯数字,未知则 0
"status": "todo" | "doing" | "done",
"notes": string | null
}
],
"warnings": string[] // 信息不足或原文矛盾时写明,禁止编造业务事实
}
规则:
1. 不得发明原文没有的金额、日期或责任人。
2. 日期保持原文格式,不要擅自改时区。
3. 若原文明显不是这份结构能表达的内容,输出 items=[] 并在 warnings 说明原因。
原文:
{{在此粘贴}}
把 Schema 换成你们系统真正的字段即可。键名保持稳定,比追求「更文学的中文键名」重要得多。需要写产品文档时,JSON 只适合承接结构化需求条目;叙述性 PRD 请用 PRD 提示词,不要把两种体裁混在一次输出里。
如何校验
- 用语言自带的JSON解析器尝试解析;失败则把报错行号贴回对话。
- 再用 Schema 校验必填、类型和枚举(例如 ajv、pydantic 或你们内部的校验库)。
- 检查业务规则:数量不为负、状态落在允许集合、ID 不重复。
- 抽查三条记录是否和原文一致,防止「格式对了但事实被补全」。
- 校验通过后再交给下游。生产路径上应拒绝未通过校验的载荷,而不是手动改两个字符凑合入库。
自动化流水线里,把「解析失败 / Schema 失败 / 业务规则失败」分成三种回传话术,模型更容易对症修改。不要只说「再试一次」。
API 与聊天的差别
聊天适合草稿和人工驱动的转换。要把 JSON 当作系统间的合同,应使用官方开发者平台当前提供的结构化输出能力,并按文档提交 schema。文档入口在 platform.claude.com / docs.anthropic.com,字段名与限制(例如是否允许递归、哪些校验关键字可用)以页面实时说明为准,本文不把可能改版的请求体字段写成永远正确的抄作业。
API 密钥管理见 API 密钥 与 API 入门。不要把密钥写进提示词「让模型帮你调用自己」,也不要在前端仓库里硬编码密钥后再请求所谓的 JSON 模式。
常见失败
- 提示词既要求「先给分析再给JSON」,又要求「只输出JSON」——两句话互相打架。
- 允许自由发挥中文字段,导致下游系统找不到键。
- 把单引号、注释或尾随逗号当成JSON;标准JSON不接受这些。
- 原文矛盾时模型选择「补一个合理值」。必须明确禁止编造,并预留 warnings。
- 一次提取上百个嵌套对象却不分页,超出上下文后静默丢字段。应分块处理再合并,合并后重新校验。
出现失败不要立刻换模型碰运气。先收紧提示词、补示例、做校验回传。若仍不稳定,再考虑换一档模型或改走 API 的结构化输出。切换操作见 怎么切换模型。
非官方说明与核对习惯
本站是独立第三方中文指南,不是 Anthropic 官方网站,也不代订、代取消、代改绑、代开验证或代管任何密钥与账单。产品名称、菜单文案、套餐可用性、客户端下载渠道与计费规则,一律以 claude.ai、anthropic.com、Claude Help Center 与(如涉及开发者)官方文档当前页面为准。操作前建议固定三步:先截图账户状态(打码隐私)→ 再改设置或粘贴提示词 → 再做一次登录、账单或样例数据冒烟测试。遇到与本文不一致的界面,以你屏幕上的官方文案为准,而不是以第三方教程的旧截图为准。
若你的目标是更快用中文完成写作、分析或对话练习,可在读完官方设置与安全须知后,通过本站固定入口试用中文 AI 对话;那是第三方服务,请自行阅读其条款与隐私政策,勿把它理解成 Claude 官方镜像,也勿理解成「官方免费」或「免翻」承诺。本站文章中的提示词均为编辑示例,不构成对业务结果、查询正确性或账户操作成功的保证。
- 不向不明人员发送密码、验证码、备份码、发票原件中的完整账号信息或 API 密钥;本站也不收集这些信息。
- 不在公开仓库、截图、工单附件、群聊里粘贴未脱敏的合同、账单或客户数据。
- 财务、人事、医疗、法律、生产数据库变更等结论必须人工复核,并走你司既有审批。
- 企业场景先问清数据留存、区域与管理员策略,再把内部文件丢进对话、连接器或浏览器扩展。
- 核验日期见页眉;功能若已改版,以官方为准,并把「以当前界面为准」写进团队内部文档。
- 页面可访问、IndexNow 提交成功或部署完成,都不等于已被搜索引擎收录,更不等于排名提升。
相关基础阅读:Claude 怎么用、中文提示词、Pro 值不值得、关于与免责声明。若本文与官方 Help 冲突,以 Help 为准。
常见问题
为什么它经常在JSON前后加上说明文字?
因为提示词只说了「用JSON」,没有禁止额外解说。请明确写:不要Markdown代码围栏以外的文字,不要前言后语;若仍出现,让它只重发对象本身。
字段顺序或空值总是不稳定怎么办?
在schema里写清必填、类型和null策略,并给一个完整示例。对枚举值列出允许列表。不要指望模型自己猜你们内部的字段约定。
聊天里能保证百分之百合法JSON吗?
不能。聊天输出需要你本地校验;不通过就回传报错信息让它只修正格式。生产环境应走官方文档中的结构化输出能力,而不是裸解析一段聊天文本。
可以用它直接生成要写入数据库的JSON吗?
可以当草稿,但必须校验类型、范围和注入风险,并经人审后再入库。本站不保证生成结果可安全执行。
和CSV、SQL提示词有什么关系?
都是先约定结构再生成。JSON更强调嵌套和类型;CSV更强调列对齐。不要在同一条提示词里同时要求三种互相冲突的格式。