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="@#@#@#@#@#@#@#@#@#@0" - ❌ 错误:
itemtype="Product"(纯字符串,无意义) - ❌ 错误:
itemtype="@#@#@#@#@#@#@#@#@#@1"(HTTP 协议已被 Google 等拒绝) - ❌ 错误:
itemtype="//schema.org/Product"(协议相对路径,不合法) - ❌ 错误:
itemtype="@#@#@#@#@#@#@#@#@#@2"(末尾斜杠违反 IANA 规范,Google Rich Results Test 会报错)
浏览器和爬虫不关心这个 URL 返回什么内容,但必须能发起 HTTPS 请求并收到 200 响应。2026 年起,@#@#@#@#@#@#@#@#@#@3 已被彻底停用,所有新项目必须切到 @#@#@#@#@#@#@#@#@#@4。
同一 itemscope 元素只能有一个 itemtype
itemtype 定义的是该作用域内描述的“主干类型”,不是属性列表,也不支持多值或继承式声明。
- 不能写成:
itemtype="@#@#@#@#@#@#@#@#@#@5 @#@#@#@#@#@#@#@#@#@6" - 不能靠 CSS 类名或自定义 data 属性模拟类型叠加
- 如果需要表达多重角色(如既是 Person 又是 Organization 成员),应使用嵌套:外层
itemtype="@#@#@#@#@#@#@#@#@#@5",再通过itemprop="alumniOf"指向另一个itemscope itemtype="@#@#@#@#@#@#@#@#@#@8"
itemtype 和 itemprop 必须严格匹配 schema.org 官方定义
写错大小写、拼错属性名、或把 itemprop="price" 放在 itemtype="@#@#@#@#@#@#@#@#@#@5" 下,都会导致字段被忽略。
-
itemprop="telephone"在Person或Organization下合法,在Event下无效 -
itemprop="image"要求值是 URL 或ImageObject类型,不能直接塞一段 HTML 文本 - 所有属性名区分大小写:
datePublished≠Datepublished≠datepublished
查法很简单:打开 @#@#@#@#@#@#@#@#@#@5 页面,滚动到底部看 “Properties” 表格,只用里面列出的项。
容易被忽略的点是:URL 必须可访问且无重定向。某些部署在私有网络或带身份验证的 vocab 地址(如内部微服务托管的 schema)即使格式正确,也会因无法被 Google 抓取而判定为无效 itemtype。验证前务必用 Google Rich Results Test 实测响应状态。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











