必须同时使用itemscope与itemtype="https://schema.org/Article",且须置于语义化<article>标签上;headline、datePublished、articleBody为必填核心字段,日期需ISO 8601格式,嵌套对象须紧贴声明,最终须通过Google Rich Results Test验证。

itemtype="https://schema.org/Article"必须配itemscope,不能单独写
只加itemtype="https://schema.org/Article"没用,搜索引擎直接忽略。它必须和itemscope出现在同一个元素上,声明“这里是一个独立的文章实体”。常见错误是把itemtype丢在<body>或大包裹<div id="content">里——语义会漂移,Google 可能当成整页是一个 Article,导致标题、发布时间错位。
正确做法是复用语义化标签作容器:<article itemscope itemtype="https://schema.org/Article">。不推荐<div itemscope itemtype="https://schema.org/Article">,因为<div>无原生语义,读屏工具和爬虫无法判断内容角色。
- 同一页面有多篇文章?每篇都得有自己独立的
<article itemscope itemtype="https://schema.org/Article">,不能共用一个容器 - URL 必须完整、HTTPS、大小写敏感:✅
https://schema.org/Article,❌http://schema.org/article、https://schema.org/Article/、schema.org/Article - 不要用 JS 动态批量加
itemscope——DOM 必须静态可解析,否则 Google Rich Results Test 会报“未检测到结构化数据”
headline、datePublished、articleBody是 Article 的核心必填项
Google 不强制校验所有字段,但缺了这几个,富媒体摘要大概率不出现。其中headline和datePublished是强推荐,articleBody是实际提取正文首段的依据。
常见错误是把itemprop="headline"贴在<h2>甚至<p>上,却不检查该元素是否在itemscope范围内;或者用<time>但漏掉datetime属性,导致机器读不到时间戳。
立即学习“前端免费学习笔记(深入)”;
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
-
<h1 itemprop="headline">标题文本</h1>——纯文本,别带<sup>或图标 HTML -
<time itemprop="datePublished" datetime="2026-10-12">2026年10月12日</time>——datetime值必须是 ISO 8601 格式,且不能为空格或换行符 -
<div itemprop="articleBody"><p>第一段正文...</p></div>——别用<section>或<main>替代,articleBody只认直接绑定的块级容器
HowTo 和 Review 要慎用,Article 是最稳的选择
纯文字攻略(比如“《空之轨迹》全支线触发条件汇总”)就用https://schema.org/Article。强行套HowTo看似更“高级”,但它的校验极严:必须有step、name、itemListElement,且每个 step 得是<ol>下的<li>,漏一个字段整个结构化数据就失效。
含评分的内容(如“DLC 攻略体验:8.5/10”)得用https://schema.org/Review,但必须同时声明itemReviewed,否则会被当成孤立评测,不关联到具体游戏。
-
HowTo只适合真正分步操作类内容,比如“三把剑叠满狂暴值”的每一步都有明确动作、工具、时间估算 -
Review必须嵌套itemReviewed,例如:<div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Game"><span itemprop="name">艾尔登法环</span></div> - 别在
Article里混用reviewRating——这个属性只在Review下合法,Google 会报错
验证不是看源码,而是跑 Google Rich Results Test
即使你把所有itemprop都写对了,也可能因 CSS 隐藏、JS 渲染延迟、或<meta>位置不对被忽略。浏览器“查看源代码”看到的只是静态 HTML,不代表 Google 实际抓取到的内容。
必须把页面 URL 或 HTML 片段粘贴进 Google Rich Results Test,等它返回“有效”才真正落地。失败原因里最常出现的是:Missing field "headline"、Unspecified type for property "author"、Date is not in ISO 8601 format。
- 地址类、作者类嵌套对象必须紧贴
itemprop所在元素写,不能隔层,否则整个嵌套块被丢弃 -
author字段如果指向人,就得在itemprop="author"元素上同步写itemscope itemtype="https://schema.org/Person",不能靠父级“继承” - 微信公众号用 Wechat HTML Publisher 直接上传 HTML 富文本时,同样要过一遍 Rich Results Test——它不自动修正微数据错误


















