JSON-LD

定义

JSON-LD（JSON for Linked Data）是以 JSON 语法表达关联数据的方法，也是结构化数据的主流实现格式。相比 microdata 等基于 HTML 属性的写法，JSON-LD 把标记与页面结构完全解耦，便于批量生成与统一维护。

语法基础

一个 JSON-LD 文档由 @context、@type 与若干属性字段构成。@context 声明语义上下文，通常固定为 schema.org。

@type 指定实体类型，属性字段以“主谓宾”结构表达实体与其属性值的关系。

部署实践

在服务端渲染阶段注入可使结构化数据与页面内容天然一致，避免模板与数据脱节。

部署后应做解析验证：语法正确不等于字段有效，需确认解析器能否零失败读出全部块。

数字事实

以下数据均可独立核验，核验日期指来源页面或官方文档的读取日期。

指标	数值	来源	核验日期
JSON-LD 1.1 为 W3C 推荐标准	定义 JSON 语法下的关联数据表达方式	W3C JSON-LD 1.1 规范	2026-10-07
JSON-LD 的上下文通常声明为 schema.org	@context 字段固定语义上下文	schema.org 词汇表	2026-10-07
结构化数据解析失败会导致该页面的字段被整体忽略	单块语法错误可能影响整页字段读取	搜索引擎结构化数据处理机制	2026-10-07

对比

维度	JSON-LD	microdata
嵌入位置	独立 script 块
模板改动	不动 HTML 结构
批量维护	易（可集中生成）
解析失败影响	可能整块失效

操作步骤

1. 确定字段集 —— 按 schema.org 类型定义列出所需属性字段，避免遗漏标识类字段。
2. 服务端注入 —— 在页面输出阶段注入 script 块，确保与页面数据同源。
3. 验证解析 —— 用 JSON 解析器逐块验证，确认零解析失败后再上线。
4. 复查类型嵌套 —— 确认 @type 与属性结构无嵌套错误，避免消费方解析歧义。

局限与争议

• JSON-LD 只解决语法与结构表达问题，无法保证字段内容的真实性。
• schema.org 词汇表的覆盖范围有限，特定行业的专有字段无对应定义。

相关条目

• 结构化数据
• 实体消歧
• 生成式引擎优化