必须使用 https://schema.org/FAQPage 类型,mainEntity 必须是 Question 实体数组,每个 Question 下需嵌套 Answer 实体,name 和 acceptedAnswer.text 需纯文本且严格符合结构要求,否则无法触发 FAQ 富媒体卡片。

itemtype 必须用 https://schema.org/FAQPage,不能用 QAPage 或 Article
标记常见问题问答页,唯一被 Google 支持的类型是 https://schema.org/FAQPage。写成 https://schema.org/QAPage(适用于单个问答对)或 https://schema.org/Article 都不会触发 FAQ 富媒体卡片。Google Rich Results Test 会直接报 “Missing field ‘mainEntity’” 或 “Invalid itemtype”,且 Search Console 可能标记为 “No rich result detected”。
FAQPage 的 mainEntity 必须是 Question 实体数组,每个 Question 要独立 itemscope
FAQPage 不是容器型类型,它必须通过 mainEntity 属性显式指向一组 Question 实体。每个问题都要单独声明作用域:
- ❌ 错误:把所有问答塞进一个 里,只用
itemprop="name"和itemprop="acceptedAnswer"平铺写- ✅ 正确:外层
FAQPage容器内,每个独立包裹一问一答- 每个
Question下的acceptedAnswer必须再嵌套一层itemscope itemtype="https://schema.org/Answer",不能只写文本Question 和 Answer 的字段有强格式要求,纯文本容易失败
Google 对 FAQ 结构化数据的字段校验比普通类型更严格,常见踩坑点:
htmlq 命令行 HTML 内容提取器,支持 CSS 选择器下载htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
-
name(问题标题)必须是纯文本,不能含、或 HTML 实体(如),否则可能被截断或拒收 -
acceptedAnswer的内容必须用包裹,不能只放或直接写在itemprop="acceptedAnswer"元素里- 日期类字段(如
dateCreated)虽非必填,但若使用,必须用,datetime值需为完整 ISO 日期(不带时间也行,但不能是 "Oct 5, 2026")嵌套层级错一位,整个 FAQ 卡片就消失
FAQPage 的结构非常“刚性”,嵌套关系不能松动:
- 外层
FAQPage容器必须是、或语义清晰的块级标签,不推荐用mainEntity必须直属于FAQPage容器,不能隔一层 wrapper:是无效的Question和Answer必须同级嵌套,不能把Answer提到Question外面,也不能把两个Question套进同一个itemscope- 验证时用 Google Rich Results Test,重点看 “mainEntity” 是否解析出多个
Question对象,而不是只显示一个或报 “Empty array”实际部署时最容易忽略的是:FAQ 页面往往由 CMS 渲染,模板里容易把
mainEntity循环逻辑写在错误层级,导致生成的 HTML 中itemprop="mainEntity"出现在子元素上而非直接子节点——这个细节偏差,就是富媒体卡片不出现的全部原因。
- 日期类字段(如
- ✅ 正确:外层
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










