JSON-LD结构化数据应置于head末尾或body开头，使用<script type="application/ld+json">标签，内容为纯JSON；Article类型须含headline、datePublished、author等必填字段，且值需严格匹配页面文本与格式要求。
直接往 <head> 或 <body> 顶部塞一个 <script type="application/ld+json">，内容是纯 JSON、字段对得上 schema.org 类型定义——这是目前唯一被 Google 明确推荐、解析成功率最高、维护成本最低的落地方式。其他写法，90% 会报“无法解析结构化数据”。
JSON-LD 的 script 标签必须写对类型和位置
不是随便放个 <script> 就行。必须用 <script type="application/ld+json">，且内容只能是纯 JSON：不能有 JS 变量声明（比如 const data = { ... }），不能有注释（// 或 /* */），不能用单引号，不能有尾逗号，所有字符串和键名必须用英文双引号。
它可放在 <head> 末尾或 <body> 开头，但不能嵌在另一个 <script> 里，也不能被 <div> 或 HTML 注释包裹。Googlebot 不执行 JS，2026 年仍如此，所以客户端动态插入（如 useEffect 或 document.createElement('script')）完全无效。
Article 类型必须含 headline、datePublished、author 才被识别
只写 "@type": "Article" 没用，Google 会直接忽略。以下字段缺一不可：
立即学习“前端免费学习笔记（深入）”；
-
headline：必须是字符串，且与页面<h1>文本逐字一致 -
datePublished：必须是 ISO 8601 格式，推荐带时区，如"2026-05-10T12:00:00+08:00"；只写"2026-05-10"虽然能过基础校验，但部分解析器会降权 -
author：不能是字符串（如"张三"），必须是对象，且至少含"@type"和"name"；机构作者要设"@type": "Organization" -
image：值必须是绝对 URL 数组，每个地址需返回 HTTP 200；相对路径（如"./logo.png"）或需登录访问的链接会被静默丢弃
@graph 多实体声明比嵌套更稳
一个页面常同时描述文章、作者、网站、面包屑——别试图塞进一个对象里，也别用多段独立 <script>。Google 支持 @graph 数组，把不同实体平级列出，关系靠 @id 和 mainEntityOfPage 等字段维系。
例如，博客页同时声明 BlogPosting、Person 和 WebSite：
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "BlogPosting",
"headline": "HTML JSON-LD怎么实现",
"datePublished": "2026-05-07T10:00:00+08:00",
"author": { "@id": "#author" },
"mainEntityOfPage": { "@id": "#page" }
},
{
"@id": "#author",
"@type": "Person",
"name": "张三"
},
{
"@id": "#page",
"@type": "WebSite",
"url": "https://example.com/"
}
]
}这种写法避免字段冲突，也方便复用 @id 关联，比层层嵌套更易维护、更少出错。
验证必须用 Google URL Inspection Tool，不能只看源码
浏览器“查看源代码”只能确认代码存在，不能判断语义是否合法。必须用 Google 的 URL Inspection Tool（已整合 Rich Results Test）粘贴完整 HTML 源码或 URL，它会实时定位具体哪一行、哪个字段出错，比如 "datePublished is not a valid date" 或 "author.name is missing"。
注意：<script type="application/ld+json"> 块若多个并存，工具默认只校验第一个；多类型共存时需手动展开每个块检查。本地测试务必关掉广告屏蔽或隐私类插件，它们可能过滤掉 <script> 标签。
最常被忽略的是字段值与页面可见文本的字符级一致性——比如 HowToStep 的 text 字段，差一个全角空格、一个中文句号，富摘要就会消失。这不是容错场景，而是硬性匹配要求。
