itemtype必须是完整HTTPS URL且返回200,itemscope须包裹itemtype并置于块级元素,itemprop需绑定机器可读值,类型须匹配页面核心内容。

itemtype必须是完整 HTTPS URL,少一个字符都不行
Google 和 WHATWG 解析器强制要求 itemtype 值必须是可访问的、协议为 https 的绝对 URL,且该 URL 在 HTTP 层需返回 200 状态码(哪怕内容只是 HTML 页面)。写成 http://schema.org/Person、schema.org/Person、Person 或 https://schema.org/Person/(末尾多斜杠)都会导致整块微数据被忽略。
常见错误包括:
- 复制链接时漏掉
s,变成http协议 - 从文档里抄了缩写,如直接写
Product - 本地开发时用
./vocab或相对路径 - 拼错域名,比如
schmea.org或大小写混用(https://Schema.org/Article)
itemscope 必须包裹 itemtype,且不能跨层断开
正确结构示例: 错误模式: 即使 判断依据很简单: 典型疏漏点: 真正生效的微数据,是 itemtype 只在带有 itemscope 的元素上起作用,而且这个 itemscope 必须出现在最外层容器(如 ),不能藏在中间某层 wrapper 里。一旦 itemprop 元素和它的 itemscope 祖先之间隔了一个没声明任何 microdata 的 <div itemscope itemtype="https://schema.org/LocalBusiness">
<h1 itemprop="name">某某公司</h1>
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="streetAddress">XX路1号</span>
</div>
</div>
加 itemprop,但外层没有 itemscope + itemtype
itemscope 放在 ,但 itemprop="name" 写在嵌套的 里,中间夹着一个无 microdata 的 当外层容器—— 不是合法的 scope 容器,应优先选块级元素Google Rich Results Test 报错但页面看着“没问题”?检查 itemtype 是否匹配页面意图
itemtype 语法全对、URL 可访问,Google 仍可能在测试工具里报“未检测到结构化数据”或“类型不匹配”。根本原因是:你选的类型和页面主体不一致。比如企业首页硬套 https://schema.org/Product,或新闻详情页用了 https://schema.org/Organization,Google 会认为语义冲突,主动降权或忽略。
LocalBusiness 至少要有 name、address;Article 至少要有 headline、datePublished
https://schema.org/Restaurant 是 LocalBusiness 的子类,但如果页面没展示营业时间、菜单、预订入口,用 Restaurant 反而增加验证失败风险为什么加了 itemtype 还是没富媒体结果?别漏掉 itemprop 的绑定细节
itemtype 定义了“这是什么”,但没定义“它有什么”。如果所有 itemprop 都绑在文本内容上,而 URL、日期、价格这些关键字段没用 href、datetime、content 显式提供机器可读值,Google 就无法提取结构化信息——它不会猜“¥99.99”是不是价格,“2024-05-20”是不是发布日期。
官网 → 缺 href,实际提取到的是“官网”字符串,不是链接 → 没加 datetime 属性,日期格式不统一,易被忽略 → 没用 content="29.99",货币符号干扰数值识别 里: → 应拆成多个 前端
itemscope、itemtype、itemprop 三者严丝合缝,且每个 itemprop 的值都经得起机器解析——不是“看起来像”,而是“明确告诉搜索引擎这是什么”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











