itemtype必须是完整HTTPS URL,如“https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person”,不可省略协议、大小写敏感、末尾无斜杠;同一itemscope仅允许一个itemtype;需语义匹配合法itemprop;须用Google工具实测验证。

itemtype必须是完整 HTTPS URL,不是类型名称
itemtype 的作用不是“起个名字”,而是指向一个外部定义的、可验证的词汇表地址。它本身不参与渲染,也不触发 JS 逻辑,但写错就会让整个 itemscope 块被搜索引擎忽略。
常见错误包括:
- 写成
itemtype="Person"或itemtype="schema.org/Person"—— 这些都不是合法 URL - 用 HTTP 协议:
itemtype="http://schema.org/Person"—— 主流解析器(如 Google Rich Results Test)已拒绝 HTTP - 路径末尾多斜杠:
itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person/"—— 多余斜杠会导致 404 或校验失败
✅ 正确写法只有这一种:itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person"。这个 URL 必须能返回 HTTP 200 响应(哪怕只是 HTML 页面),且大小写敏感。
同一个 itemscope 只能有一个 itemtype
你不能在一个元素上叠加多个 itemtype 来表达“既是人又是员工”。浏览器会只取第一个,其余全部丢弃。
如果需要表达复合语义(比如某人同时是作者和编辑),正确做法是嵌套:
<div itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Article">
<div itemprop="author" itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">
<span itemprop="name">李四</span>
</div>
<div itemprop="editor" itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">
<span itemprop="name">王五</span>
</div>
</div>
注意:itemprop="author" 和 itemprop="editor" 必须各自紧贴对应的 itemscope 容器,中间不能插入无关标签,否则嵌套关系断裂,结构化数据失效。
itemtype 和 itemprop 必须语义匹配
itemtype 决定了哪些 itemprop 是合法的。例如 itemprop="price" 只在 itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Offer" 或 Product 下有效;写在 Person 里,Google 工具会直接报错。
查属性是否可用,必须去 schema.org 对应 type 页面的 “Properties” 表格里确认。重点关注两列:
-
Property name:必须严格拼写,
jobTitle≠jobtitle -
Expected Type:比如
image属性可能要求是ImageObject或URL,不能直接塞一段文字
别依赖旧文档或第三方教程——很多已废弃属性(如 businessHours)仍被误传,实际应改用 openingHoursSpecification。
验证 itemtype 是否生效,必须用工具实测
写完不能靠“看起来对”就认为 OK。必须用 Google Rich Results Test 或 Schema Markup Validator 提交 HTML 片段。
工具会明确告诉你:
- itemtype URL 是否可访问(HTTP 状态码是否为 200)
- 该 URL 是否被识别为有效 schema.org 类型
- 内部
itemprop是否在该 type 的合法属性列表中
最容易被忽略的一点:本地开发时用 file:// 协议打开 HTML,所有微数据都会失效——因为 itemtype 要求 HTTPS,且解析器无法加载本地文件作为词汇表来源。必须走 HTTP(S) 服务才能验证。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











