itemtype必须是完整HTTPS URL且末尾无斜杠,如https://schema.org/Person;须指向schema.org真实存在的类型页,大小写敏感、不可拼错,且需与itemscope同元素绑定。

itemtype 必须是完整 HTTPS URL,且末尾不能带斜杠
填错 itemtype 是微数据失效的第一大原因。它不是随便写个类型名就能用的字符串,而是必须指向 schema.org 上一个真实存在的、可解析的实体定义页。
常见错误包括:itemtype="Person"、itemtype="https://schema.org/Person/"(末尾斜杠)、itemtype="http://schema.org/Person"(HTTP 协议不安全)、itemtype="//schema.org/Person"(协议相对路径)——全部无效。
- ✅ 正确写法:
itemtype="https://schema.org/Person" - ✅ 也正确:
itemtype="https://schema.org/Product"、itemtype="https://schema.org/LocalBusiness" - ❌ 所有含斜杠结尾的都失败,比如
https://schema.org/Person/ - ❌ 2026 年起 Google 已停用
http://data-vocabulary.org/系列地址,直接忽略
不能只查“名字”,得去 schema.org 页面确认 type 是否存在且适用
同一个语义在不同上下文里可能对应不同 type。比如页面主体是“一家开在街角的咖啡馆”,itemtype 填 https://schema.org/Organization 就太宽泛;填 https://schema.org/Restaurant 又可能缺字段;而 https://schema.org/CafeOrCoffeeShop 才是 2026 年 schema.org 官方推荐的精确子类。
验证方式很简单:把你要填的 URL 直接粘贴进浏览器,比如访问 https://schema.org/CafeOrCoffeeShop。如果能打开、页面顶部显示 “Type: CafeOrCoffeeShop”,且下方 “Properties” 表格里有你实际要用的字段(如 address、telephone),那这个 itemtype 就可用。
立即学习“前端免费学习笔记(深入)”;
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- ⚠️ 注意大小写:schema.org 是大小写敏感的,
https://schema.org/product❌ - ⚠️ 不要拼错单词:比如
CoffeShop(少个 e)或Resturant❌ - ⚠️ LocalBusiness 是通用父类,但 Google Rich Results Test 对它的富摘要支持弱于更具体的子类(如
Restaurant、RealEstateAgent)
同一页面多个 itemscope,itemtype 可以不同,但不能模糊混用
一个页面可以同时标记多个独立实体,比如首页既有公司信息(LocalBusiness),又有最新一篇博客(Article),还有嵌套的作者信息(Person)。这完全合法,但每个 itemscope 必须配对唯一、明确的 itemtype。
容易出问题的是“主容器”选型模糊。例如把整页 当作万能兜底,再往里塞 itemprop="author" —— 但 WebPage 类型本身不定义 author 属性,Google 会跳过该 itemprop 或报错。
- ✅ 推荐做法:主
itemscope应匹配页面核心意图。企业首页 →LocalBusiness;新闻列表页 →CollectionPage;单篇博文 →Article - ✅ 嵌套用法:在
Article内部用<div itemprop="author" itemscope itemtype="https://schema.org/Person"> <li>❌ 避免把 <code>Product和Event混在同一个itemscope下,它们属性集互斥,会导致部分字段被静默丢弃
itemtype 填对了,但 itemprop 还是不生效?检查是否漏了 itemscope
itemtype 必须和 itemscope 出现在**同一个 HTML 元素上**。这是硬性规则,不是“父子关系”或“就近原则”。写成这样就彻底失效:
<div itemscope>
<section itemtype="https://schema.org/Product">
<h1 itemprop="name">无线耳机</h1>
</section>
</div>
因为 itemscope 和 itemtype 分开了,搜索引擎无法建立实体上下文。所有 itemprop 都变成孤儿属性,直接忽略。
- ✅ 正确写法:
<section itemscope itemtype="https://schema.org/Product"> - ✅ 也可以用语义化标签:
<article itemscope itemtype="https://schema.org/Article"> - ⚠️
<form itemscope itemtype="https://schema.org/ContactPage">是可行的,但要注意 ContactPage 本身不定义表单字段,具体输入仍需绑定到其子属性(如contactPoint)或嵌套Organization实体
itemprop 的拼写——其实根源是外层 itemscope 和 itemtype 没绑对位置,或者 URL 多了个看不见的空格或斜杠。


















