微数据生效需同时满足三项硬性条件:外层有itemscope、紧随合法itemtype https url、内部子元素用语义匹配的itemprop标注;itemscope与itemtype必须成对出现在同一元素上;itemtype必须为完整https url(如https://schema.org/person);itemprop值类型须严格匹配schema.org定义;嵌套实体必须显式声明内层itemscope和itemtype;所有itemprop元素必须被带itemscope的祖先元素包裹,且优先使用语义化容器标签。

微数据不是加了 itemprop 就算生效,必须同时满足三项硬性条件:外层有 itemscope、紧跟着合法的 itemtype HTTPS URL、内部子元素用语义匹配的 itemprop 标注——缺一不可,否则 Google Rich Results Test 会直接忽略整块。
itemscope 和 itemtype 必须成对出现在同一元素上
这是最常被跳过的前提。只写 itemprop="name" 而没包裹在带 itemscope 的容器里,等于没写。更隐蔽的错误是把 itemtype 写成相对路径或缩写:
-
itemtype="Person"❌ —— 解析器不认识,必须是完整 HTTPS URL -
itemtype="//schema.org/Person"❌ —— 协议省略导致部分爬虫拒解析 -
itemtype="https://schema.org/Person"✅ —— 唯一推荐写法(注意末尾不加斜杠)
2026 年起 Google 已停用旧版 http://data-vocabulary.org/,所有 itemtype 都得切到 https://schema.org/。写错协议或域名,机器读出来就是空。
itemprop 值类型必须严格匹配 schema.org 定义
不是所有字段都能直接塞文本。price、datePublished、telephone 这些字段,值类型和承载方式都有硬性要求:
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
-
price:必须用<meta itemprop="price" content="299.00">,不能写<span>¥299</span> -
datePublished:必须用<time itemprop="datePublished" datetime="2026-06-10"></time>,datetime属性才是机器读取的值 -
telephone:只在Person或Organization类型下合法,Event里直接写会无效 -
image:优先用<img itemprop="image" src="...">;若用 URL 字符串,得包在<meta itemprop="image" content="https://...">
查错方法:去 https://schema.org/ 对应 type 页面(比如 https://schema.org/Product),翻到底部看 “Properties” 表格,确认字段是否属于该 type、是否要求 content、是否接受文本内容。
嵌套实体必须显式声明内层 itemscope 和 itemtype
作者是人、餐厅有菜单、文章含评论——这些都不是字符串,而是另一个完整实体。只写 itemprop="author" 不够,必须再开一层作用域:
- 错误写法:
<p itemprop="author">张三</p>(没声明这是Person) - 正确写法:
<p itemprop="author" itemscope itemtype="https://schema.org/Person">张三</p>
嵌套层级越深,越容易漏掉某一层的 itemscope 和 itemtype。建议每嵌套一层就用 Google Rich Results Test 验证一次。所有 itemprop 元素,必须被某个带 itemscope 的祖先元素包裹,否则解析器找不到归属上下文。
最容易被忽略的是:微数据必须依附于语义容器,不能孤立存在。比如用 <div itemscope itemtype="https://schema.org/Product"> 包裹商品信息没问题,但若用 <code><span itemscope itemtype="https://schema.org/Product"></span>,虽然语法合法,但搜索引擎可能因语义弱而降权或跳过解析——优先复用 <article></article>、<section></section> 或已有语义标签作容器。










