结构化数据接入教程:为网站添加 Article 和 FAQ Schema
结构化数据接入教程:教你用 JSON-LD 为 Next.js 或静态站添加 Article、FAQPage 结构化数据,含代码示例与富媒体结果校验方法。
这篇教程做什么
结构化数据(Schema 标记)用一套约定好的格式,把页面信息告诉搜索引擎:这是文章、标题是什么、作者是谁、发布日期哪一天,或者这是一组问答。搜索引擎拿到后,可能把页面展示成更丰富的搜索结果。本教程教你在 Next.js 或静态站上用 JSON-LD 添加 Article 和 FAQPage。想先理解概念,看 结构化数据是什么。
JSON-LD 怎么放
JSON-LD 是一段由 包裹的 JSON,放在页面 区域。静态站最直接的做法是把脚本写进页面模板。这种格式的好处是独立于页面正文,搜索引擎和 AI 工具都能直接解析,想加新类型只需要新增一个 script 标签。
一个最小可用的 Article 示例:
在 Next.js 里,可以在页面或布局组件中用 按需输出这段 JSON。要注意的是,JSON 里的字符串需要转义,直接拼模板容易出错,建议用 JSON.stringify 生成。
Article Schema 的常用字段
| 字段 | 说明 | 建议 |
|---|---|---|
| headline | 文章标题 | 与页面 title 保持一致 |
| datePublished | 发布日期 | 使用 ISO 8601 格式 |
| dateModified | 修改日期 | 与页面 lastUpdated 一致 |
| author | 作者 | 可以是 Person 或 Organization |
| image | 配图地址 | 有配图就填,没有可以不填 |
字段必须与页面真实内容一致。搜索引擎会校验一致性,虚假标记会被视为垃圾内容处理。另外 mainEntityOfPage 可以指向文章本身的 URL,用来明确"这段标记描述的是这个页面"。
FAQPage Schema
FAQPage 把页面上的问答对标记出来,有被展示成富媒体结果的可能。一个最小示例:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "结构化数据能让排名更高吗?",
"acceptedAnswer": {
"@type": "Answer",
"text": "不一定。结构化数据主要影响搜索结果展示形式,不直接改变排名。"
}
}
]
}
关键约束:FAQPage 只应标记页面上真实可见的问答内容,并且每条 FAQ 要和页面实际展示的问答一一对应。如果你的页面渲染层本来就把 faq 字段渲染成可见问答块,直接复用同一份数据生成标记最稳妥。
多个标记类型共存
一个页面可以同时挂多个 JSON-LD 标记,比如 Article 加 FAQPage、再加 BreadcrumbList(面包屑导航)。它们互不冲突,搜索引擎会按类型分别解析。建议把同一页面的标记集中维护,或者按类型拆成多个 script 标签,但保持结构清晰、字段完整。
给整站统一加标记时,可以用一个工具函数生成 JSON-LD:输入文章的标题、日期、作者和 FAQ 列表,输出对应的 JSON 对象,再在构建时注入模板。这样能避免每个页面手写标记带来的漏字段问题,也方便以后统一调整字段结构。
校验方法
- 用结构化数据测试工具检查 JSON 是否合法、字段是否符合 Schema.org 规范。
- 查看站点 HTML 源代码,确认
application/ld+json脚本真的被输出到了页面。 - 修改模板后重新构建,避免本地调试正常、线上却没有生效。
- 检查每个
@type的必填字段是否齐全,缺字段会导致标记无法被识别。
校验时最常见的错误是 JSON 语法错误和字段类型不对,比如把 datePublished 写成了数组。先用 JSON 解析工具过一遍语法,再按 Schema.org 的字段类型逐项核对,能省去大部分返工。对批量页面,可以在构建脚本里加一道自动校验,字段不合法就直接报错,避免坏标记上线。
需要提醒的是,部分常用的校验工具属于海外服务,使用时要留意网络条件,详见文末合规提醒。
常见误区
- 误区一:结构化数据越多越好。 只标记页面上真实存在的内容,标记类型和内容类型匹配即可,堆砌反而容易被判垃圾内容。
- 误区二:加了 Article Schema 就有富媒体结果。 是否展示由平台算法决定,标记只是提供"资格",不保证展示,也不保证排名。
- 误区三:标记完就不维护。 页面改版后要同步更新或删除标记,残留的过期标记可能引发问题。
合规提醒
结构化数据校验常用的部分工具属于海外服务,其访问和使用可能受所在地网络条件与法律约束,请遵守所在地法律法规和服务条款。国内可优先使用国产站长平台的检测工具。
下一步
- 想理解结构化数据概念?看 结构化数据是什么
- 想了解技术 SEO 全貌?看 技术 SEO 审计教程
- 想学习 SEO 基础?看 SEO 是什么
常见问题
相关推荐
结构化数据是什么?Schema 标记如何影响搜索展示
结构化数据是什么?讲清 JSON-LD、Schema.org 与 Article、FAQPage、Product 等常见类型,以及结构化数据如何影响传统搜索展示和 AI 搜索可读性。
SEO 是什么?网站为什么要做搜索引擎优化
SEO 是什么?讲清搜索引擎优化的目标、核心手段与内容站的实际意义,说明 SEO 是长期系统工程而非技巧堆砌,并给出新手起步路径。
技术 SEO 审计教程:用免费工具检查收录与页面问题
技术 SEO 审计教程:用 Google Search Console、PageSpeed Insights 和开源爬虫工具,检查网站收录、索引、性能与抓取问题,并给出修复优先级。
获取更多 AI 内容
订阅更新,第一时间获取新教程和工具推荐。