itemtype必须是完整HTTPS URL,作用是定义itemscope容器所描述的实体类型,需为可验证的外部词汇表地址且返回200状态码;必须与itemscope共存于同一语义化容器元素上。

itemtype必须是完整 HTTPS URL,不能简写或省略协议
itemtype的作用不是“选中元素”,而是告诉解析器“这个 itemscope 容器描述的是哪一类实体”。它必须是一个可验证的、外部定义的词汇表地址。Google Structured Data Testing Tool 和所有主流解析器都强制要求:值必须是绝对 HTTPS URL,且该 URL 在 HTTP 层能返回 200 状态码(哪怕内容只是 HTML 页面)。
常见错误包括:itemtype="Person"、itemtype="http://schema.org/Person"、itemtype="./schema/Person"——这些全都不生效。
- ✅ 正确写法:
itemtype="https://schema.org/Person" - ✅ 正确写法:
itemtype="https://schema.org/LocalBusiness" - ❌ 错误写法:
itemtype="Person"(无协议、无域名、非 URL) - ❌ 错误写法:
itemtype="http://schema.org/Person"(HTTP 已被拒绝) - ❌ 错误写法:
itemtype="https://schema.org/person"(大小写敏感,schema.org 官方路径全小写,但 type 名首字母大写)
itemtype必须和itemscope共存于外层容器,不能拆开或跨层
itemscope 和 itemtype 是一个绑定对,必须同时出现在同一个起始元素上,作为整个结构化数据块的“作用域锚点”。它不能加在空 <p> 或纯文本节点里,也不能复用给多个不相干内容块。
比如你有三篇独立文章,就得写三个独立的 <article itemscope itemtype="https://schema.org/Article">,而不是只在外层套一个 <main> 就完事。
立即学习“前端免费学习笔记(深入)”;
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 推荐用语义化标签作容器:
<article>、<aside>、<section>,比<div>更自然且利于 SEO - 禁止写成:
<div itemscope><span itemtype="https://schema.org/Event">...(itemtype 不在 itemscope 元素上) - 禁止跨区块复用:一个
itemscope itemtype只能管它直接包含的子元素,不能“跨过”</div><div>去覆盖下一段
同一itemscope只能有一个itemtype,但可叠加多个itemprop
itemtype 定义的是“类型主干”,不是属性列表。它决定了当前容器内哪些 itemprop 是合法的。例如 itemprop="telephone" 在 https://schema.org/Person 下有效,在 https://schema.org/Event 下就无效;而 itemprop="startDate" 反之亦然。
你不能在一个容器上写两个 itemtype,但可以多次使用相同或不同名称的 itemprop(如多个 itemprop="review" 会自动聚合为数组)。
-
itemtype="https://schema.org/Product"允许itemprop="name"、itemprop="offers"、itemprop="image" -
itemtype="https://schema.org/Offer"才允许itemprop="price"、itemprop="availability" - 嵌套时,子
itemscope的itemtype必须与父级itemprop的语义匹配,例如:itemprop="author"→ 子容器必须是https://schema.org/Person
验证时注意:itemtype URL 必须能被真实抓取到
别以为只要拼对了 schema.org 地址就万事大吉。WHATWG 规范和 Google 工具实际会发起一次 HEAD 请求,检查该 URL 是否返回 200。如果页面已下线、重定向到 404、或用了自建假域名(如 https://my-site.com/schema/Person),整个 itemscope 块都会被静默丢弃。
最稳妥的做法是始终使用官方地址:https://schema.org/XXX,不要替换协议、子域名或路径。目前所有主流 type 都支持 HTTPS 直达,且长期稳定。
容易被忽略的一点:即使 HTML 里写对了,如果服务器配置了严格 referrer 策略或 CSP 拦截了外部请求,也可能导致验证失败——这不是代码问题,而是部署环境问题。


















