JSON-LD 格式详解：一段 Schema 代码逐行拆解与写法规范

2026-09-13 · 谷歌SEO

很多站长第一次看到 JSON-LD 会懵：一堆花括号、冒号、@ 符号，根本不敢动。其实 JSON-LD 的语法远比 HTML 简单——它就是一个"有约定的 JSON 对象"。这篇文章把一段真实完整的 Schema 代码逐行拆开讲，让你看完就能读懂、能改、能自查。想跳过手写直接用 Schema 结构化数据生成器也可以。

JSON-LD 是什么

JSON-LD（JSON for Linking Data）是把结构化数据写成 JSON 的一种格式，放在 <script type="application/ld+json"></script> 标签里。它是 Google 官方推荐的结构化数据格式（Google 开发者文档，查询时间 2026-09-13），相比 Microdata、RDFa 的最直观优势是不动正文 HTML。想全面比较三种格式，看JSON-LD vs Microdata vs RDFa。

一段完整代码逐行拆解

下面是一段 Article Schema，我们逐段看它的构成：

{
  "@context": "https://schema.org",        // 词汇表：告诉搜索引擎用哪套术语
  "@type": "Article",                        // 类型：这篇文章是什么
  "headline": "JSON-LD 格式详解",              // 标题属性
  "author": {
    "@type": "Person",
    "name": "解忧工具箱"
  },
  "datePublished": "2026-09-13",              // 发布日期（ISO 格式）
  "image": "https://www.cqqzx.com/og-cover.jpg",
  "description": "一段 JSON-LD 代码的逐行拆解"
}

注意 JSON 的几个硬规则：键和字符串用英文双引号、不能有尾逗号、注释不能出现在正式代码里（上面示例中的 // 仅为讲解）。这些规则细节出错是新手高发区， Schema 10 大常见错误里有完整排查。

@context：告诉搜索引擎词汇表

@context 固定写 "https://schema.org"，声明你用的是 schema.org 的词汇表。它通常放在最外层第一行。绝大多数情况下不需要自定义扩展，直接用标准值即可。任何一段合格 JSON-LD 都必须有它。

@type：关键的类型声明

@type 声明这段数据描述的对象类型：Article、Product、Organization、 FAQPage、BreadcrumbList 等——它决定搜索引擎按哪套规则来校验必填属性。选错类型是最常见的问题，比如 FAQ 内容没有用 FAQPage 类型而是用了 Article，就不会触发折叠面板富摘要（FAQ 正确配置见 FAQ Schema 教程）。

属性与嵌套：JSON-LD 的主体

JSON-LD 的属性就是"键值对"，值可以是字符串（如 "headline"）、数字、数组（[]）或嵌套对象（{}）。嵌套对象用于表达 "作者是一个人、人有名字"这样的层级关系。例如：

"offers": {
  "@type": "Offer",
  "price": "299.00",
  "priceCurrency": "CNY",
  "availability": "https://schema.org/InStock"
}

每个类型有自己的推荐属性和必填属性，Product 的价格、库存就是典型（见Product Schema 商品页指南）。

日期与 URL 的规范写法

日期要用 ISO 8601 格式（2026-09-13），URL 必须是完整绝对地址（https://域名/路径），不能用相对路径。有错别字和多写一个斜杠都会让校验不通过——这也是为什么推荐先用生成器或官方测试工具跑一遍（验证流程见Schema 验证完整流程）。

看懂了之后怎么快速产出

读懂语法是为了会检查、会改别人的代码；批量产出阶段，手写 6 种类型的 JSON-LD 纯属浪费生命。用生成器选类型、填字段，代码结构由程序保证正确：

1. 到页面选类型（Article/Product/FAQ/Organization/LocalBusiness/Breadcrumb）
2. 填必填与常用属性
3. 一键复制 JSON-LD 代码
4. 粘贴进网页，跑校验

立刻试一次： → 打开 Schema 生成器，选 Article 类型生成第一段规范 JSON-LD。

读懂报错：常见的三个语法陷阱

即使理解了结构，手写仍会踩三个高频坑：一是字符串里嵌了英文双引号没有转义（如描述里写"自助"却用英文引号括住）；二是多级嵌套漏了右花括号，导致整段报"意外结束"；三是URL 末尾多了斜杠或空格，字符级错误最难肉眼发现。

应对策略很简单：先写入代码后立刻复制到测试工具跑一遍（验证流程见Schema 验证全流程），报错行号会直接指到问题位置。如果反复在类似地方出错，说明手写不是你的最优解——改用生成器生成这类嵌套结构，一劳永逸。

最后记住一个习惯：任何手工改动 JSON-LD 之后，都重新验证再上线，不要因为"只改了一个字段"就跳过测试，语法错误往往藏在最小的改动里。

小结

JSON-LD 没那么神秘：@context 固定词汇表、@type 声明类型、属性表达事实，记住 JSON 三条硬规则就能读懂任何一段代码。生成交给工具、查错交给测试器，结构化数据 20 分钟就能上线： → 打开 Schema 结构化数据生成器开始配置。