itemtype 属性必须是完整 HTTPS URL,指向 schema.org 等被认可的词汇表,如“https://www.php.cn/link/5ce1696154c224dd56c13b37e0f2c618”,不可省略协议、不可带尾斜杠、不可用 HTTP 或相对路径,且同一元素仅能声明一个类型,须与 itemprop 严格匹配官方定义。

itemtype 属性不是“设置数据类型”,而是声明一个结构化数据实体的语义类型,它必须是一个可验证的、完整的 HTTPS URL,指向 schema.org 或其他被主流解析器(如 Google)认可的词汇表。
itemtype 必须是完整 HTTPS URL,不能缩写或省略协议
itemtype 的值不是字符串标识符,也不是本地路径,更不是任意拼写的类名。它本质是一个远程词汇表地址,解析器会尝试 HTTP 请求该 URL(哪怕只返回 200 HTML 页面),以确认其有效性。
- ✅ 正确:
itemtype="<a href="https://www.php.cn/link/5ce1696154c224dd56c13b37e0f2c618">https://www.php.cn/link/5ce1696154c224dd56c13b37e0f2c618</a>" - ❌ 错误:
itemtype="Product"(纯字符串,无意义) - ❌ 错误:
itemtype="<a href="https://www.php.cn/link/d9e360253d5ae30f987b25887a0d31d1">https://www.php.cn/link/d9e360253d5ae30f987b25887a0d31d1</a>"(HTTP 协议已被 Google 等拒绝) - ❌ 错误:
itemtype="//schema.org/Product"(协议相对路径,不合法) - ❌ 错误:
itemtype="<a href="https://www.php.cn/link/5ce1696154c224dd56c13b37e0f2c618/">https://www.php.cn/link/5ce1696154c224dd56c13b37e0f2c618/</a>"(末尾斜杠违反 IANA 规范,Google Rich Results Test 会报错)
浏览器和爬虫不关心这个 URL 返回什么内容,但必须能发起 HTTPS 请求并收到 200 响应。2026 年起,<a href="https://www.php.cn/link/26500174dc195f6d503667e1badba3a0">https://www.php.cn/link/26500174dc195f6d503667e1badba3a0</a> 已被彻底停用,所有新项目必须切到 <a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937</a>。
同一 itemscope 元素只能有一个 itemtype
itemtype 定义的是该作用域内描述的“主干类型”,不是属性列表,也不支持多值或继承式声明。
立即学习“前端免费学习笔记(深入)”;
- 不能写成:
itemtype="<a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person</a> <a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Author">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Author</a>" - 不能靠 CSS 类名或自定义 data 属性模拟类型叠加
- 如果需要表达多重角色(如既是 Person 又是 Organization 成员),应使用嵌套:外层
itemtype="<a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person</a>",再通过itemprop="alumniOf"指向另一个itemscope itemtype="<a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Organization">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Organization</a>"
itemtype 和 itemprop 必须严格匹配 schema.org 官方定义
写错大小写、拼错属性名、或把 itemprop="price" 放在 itemtype="<a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person</a>" 下,都会导致字段被忽略。
-
itemprop="telephone"在Person或Organization下合法,在Event下无效 -
itemprop="image"要求值是 URL 或ImageObject类型,不能直接塞一段 HTML 文本 - 所有属性名区分大小写:
datePublished≠Datepublished≠datepublished
查法很简单:打开 <a href="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person</a> 页面,滚动到底部看 “Properties” 表格,只用里面列出的项。
容易被忽略的点是:URL 必须可访问且无重定向。某些部署在私有网络或带身份验证的 vocab 地址(如内部微服务托管的 schema)即使格式正确,也会因无法被 Google 抓取而判定为无效 itemtype。验证前务必用 Google Rich Results Test 实测响应状态。



















