站点与 SEO 开发

JSON-LD 结构化数据验证先在本地排查

编辑原始代码，同时查看排版结果、词汇提示和当前输入中的实体关系。

自动检查

JSON-LD 输入

格式化结果

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebSite",
      "@id": "https://example.com/#site",
      "name": "Example",
      "url": "https://example.com/"
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/#page",
      "name": "About",
      "isPartOf": {
        "@id": "https://example.com/#site"
      }
    }
  ]
}

JSON-LD 只在当前浏览器标签页处理；不会抓取网址或远程上下文。

选项

Schema.org 词汇快照 30.1

仅查严格 JSON、当前输入中的节点及词项存在性，不判断 Google 资格。

2 个节点 · 0 条提示

诊断结果

已对照 Schema.org 30.1 词汇。

未发现问题。

当前输入中的节点

已显示 2 / 2

/@graph/0 · 类型: WebSite · 标识: https://example.com/#site
/@graph/1 · 类型: WebPage · 标识: https://example.com/#page

1 条明确引用

https://example.com/#page · isPartOf → https://example.com/#site · 目标在本段中

打开 Schema.org 官方验证器打开 Google 富媒体搜索结果测试

模板输出的 JSON 虽然可能通过语法解析，但属性拼错、实体缺类型或 @id 关系看不清，发布后仍然难查。JSON-LD 结构化数据验证把这些不同层次的问题分开列在原文旁边。

这款 JSON-LD 检查工具的 Schema 标记验证仅对照固定的 Schema.org 词表；要判断 Google 是否支持某种富媒体搜索结果，还需使用官方测试。

为什么用 JSON-LD 结构化数据验证

让代码排版、词项提示和输入内关系各自说清自己的范围。

看见实体如何相连

JSON-LD 结构化数据验证会列出顶层数组、嵌套对象和 @graph 中的节点，并显示明确写出的 @id 引用。目标未出现在粘贴片段里，只标记为“本段未见”，不判为无效。

查看限制

把拼写提示与搜索资格分开

Schema.org 30.1 词汇快照能提示未收录的类型或属性。遇到其他 @context 时跳过词汇判断，也不会把本地提示冒充 Google 的判定。

发布前先查粘贴的代码片段

保留原始输入

粘贴 JSON-LD 正文；支持顶层数组与 @graph。本页不会从 HTML 自动提取脚本，也不会请求 URL，请先复制脚本标签内部的代码。

示例含两个通过 @id 相连的节点，载入时不发网络请求。

分层阅读报告

默认在停顿 350 毫秒后自动检查，输出两空格排版、语法问题、结构摘要和 Schema.org 30.1 词项提示。关闭自动检查后可按 Ctrl/Cmd+Enter 手动运行。

“词表未收录”只是快照提示；其他上下文不做词项判断。

到官方工具复核

只有结果仍与当前输入一致，复制和下载才可用。需要通用 Schema 检查或 Google 富媒体搜索结果测试时，分别打开官方工具并自行提供代码。

官方链接为空白入口，不会携带此处的 JSON-LD。

语法、词汇与输入内图结构

定位严格 JSON 错误

重复键和错误标点会按行列定位并高亮输入行。格式化保留数值原貌与属性顺序，不把修复内容写回原文。

有版本号的词汇对照

词汇检查只对明确处于 Schema.org 上下文的类型和属性核对 30.1 当前词项。自定义映射和其他远程上下文不据此判错。

有限的节点与引用清单

图结构列出来源路径、@type、@id 和明确的引用目标。它便于追踪眼前这段代码，不是完整的 RDF 展开或规范化结果。

本地报告不能证明的事

不判定 Google 富结果资格: JSON-LD 结构化数据验证不执行 Google 专项规则，也不渲染线上页面；语法通过不能保证收录、排名或富媒体搜索结果。
只读取粘贴的 JSON-LD: 本页不抓取 URL，不抽取 HTML 脚本，也不解析 Microdata 与 RDFa。点击官方空白链接不会自动发送草稿。
词表是固定快照: Schema.org 30.1 未收录的名称只产生提示，不能证明自定义扩展或未来版本无效；domainIncludes 和 rangeIncludes 也不是本页的硬错误规则。
引用只在本段中查找: 某个 @id 目标可能定义在另一脚本或文档中，重复 @id 也可能是在描述同一实体，因此本页不会因此把整段标记为无效。

JSON-LD 结构化数据验证常见问题

JSON-LD 与 Microdata、RDFa 有什么区别？

JSON-LD 以独立 JSON 脚本表达结构化数据，后两者把标记放进 HTML 属性。本页只检查粘贴的 JSON-LD，不解析另两种格式。

设置结构化数据能提升 SEO 排名吗？

不能凭这段代码保证排名。JSON-LD 结构化数据验证只查本地语法和有限词汇；富媒体展示还取决于 Google 的规则与实际页面。

为什么 acceptedAnswer.text 会报错？

先看是 JSON 语法错误还是官方工具给出的类型要求。本页不会把 Google 的 FAQ 专项规则写成通用 Schema.org 硬约束；可到官方测试查看具体说明。

可以在同一个页面中放置多种结构化数据吗？

可以用多个 JSON-LD 脚本，也可以用数组或 @graph。本页只分析当前粘贴的片段，不会自动读取页面上其他脚本。

怎么确认 Google 识别了已实现的结构化数据？

把正式发布的 URL 放进 Google 富媒体搜索结果测试，并查看 Search Console。本地通过不能证明 Google 已抓取或展示。

遇到未覆盖的情况？

现在试试 JSON-LD 结构化数据验证

先用双节点示例理解报告，再把自己的标记交给 JSON-LD 结构化数据验证；确认结果未过期后，再到官方工具复核。

返回工具浏览全部工具

JSON-LD 结构化数据验证先在本地排查