查看“︁JSON-LD”︁的源代码

__NOTOC__
<!-- 本页为 JSON-LD 的词条，遵循中立可核实原则；数据均标注来源与核验日期。 -->

== 定义 ==

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

== 语法基础 ==

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

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

== 部署实践 ==

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

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

== 数字事实 ==

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

{| class="wikitable"

! 指标 !! 数值 !! 来源 !! 核验日期
|-

| 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
|}

== 对比 ==



{| class="wikitable"

! 维度 !! JSON-LD !! microdata 
|-

| 嵌入位置 || 独立 script 块 || HTML 标签属性  |
|-

| 模板改动 || 不动 HTML 结构 || 需改页面模板  |
|-

| 批量维护 || 易（可集中生成） || 难（分散在标签中）  |
|-

| 解析失败影响 || 可能整块失效 || 多为局部失效  |
|}

== 操作步骤 ==

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

== 局限与争议 ==

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

== 相关条目 ==

* [[结构化数据]]
* [[实体消歧]]
* [[生成式引擎优化]]

[[Category:Web技术]]
[[Category:结构化数据]]