itemtype 必须使用 schema.org 官方支持的 HTTPS 绝对 URL 类型，如 https://schema.org/WebSite 或 https://schema.org/Organization；它仅声明实体类型，需配合 itemprop 才生效，错误 URL、HTTP 协议、相对路径或非标准类型均导致结构化数据失效。
itemtype 不能单独描述“网站信息”——它只声明实体类型，而“网站”本身不是 schema.org 官方支持的独立类型。 你想标记的其实是 WebSite、Organization 或 Person 这类可被搜索引擎识别的实体，itemtype 就是告诉解析器“这个容器里描述的是哪一种”。写错 URL 或选错类型，整个结构化数据就白搭。
为什么不能用 itemtype="Website" 或 itemtype="./site"
常见错误是把 itemtype 当成自定义标签来用。它必须指向一个真实存在的、HTTPS 协议的 schema.org 类型 URL：
- ❌
itemtype="Website"—— 不是合法类型，Google Structured Data Testing Tool 直接报错 - ❌
itemtype="http://schema.org/WebSite"—— HTTP 协议已被主流解析器拒绝（2026 年起强制 HTTPS） - ❌
itemtype="/vocab/site"—— 相对路径无效，必须是完整绝对 URL - ✅ 正确示例：
itemtype="https://schema.org/WebSite"或itemtype="https://schema.org/Organization"
注意：WebSite 类型确实存在，但使用场景极窄（通常只用于首页 <html> 或 <body> 级别），多数情况该用 Organization（公司官网）、Person（个人博客）或 Blog（内容站点）。
WebSite 和 Organization 的适用边界
选错 itemtype 会导致 rich result 被拒、地图标记失败或搜索摘要不显示：
立即学习“前端免费学习笔记（深入）”；
- 用
https://schema.org/WebSite：仅当你要描述整个站点的元信息，比如url、potentialAction（搜索框）、sameAs（社交链接）。它不描述“谁运营这个站”，只描述“这个站本身” - 用
https://schema.org/Organization：适用于企业、机构官网，能绑定name、logo、contactPoint、address等关键字段，是 Google 商家卡片和知识图谱的基础 - 用
https://schema.org/Person：适合个人主页、博主、自由职业者，支持jobTitle、alumniOf、knowsLanguage等更细粒度属性
别混用：一个 itemscope 容器只能有一个 itemtype；如果首页同时想表达“这是某公司官网”和“这是个网站”，得用嵌套——外层 Organization，内部再包一层 WebSite 并用 itemprop="url" 关联。
itemtype 必须配合 itemprop 才生效
itemtype 单独写没意义，它只是“类型声明”，真正让搜索引擎读到数据的是 itemprop 绑定的字段。例如：
<div itemscope itemtype="https://schema.org/Organization"> <span itemprop="name">极客工坊</span> <link itemprop="url" href="https://geekworkshop.dev"> <img itemprop="logo" src="/logo.png" alt="极客工坊"> </div>
这里 itemtype 告诉解析器：“下面这些 itemprop 都属于一个 Organization 实体”；没有它，itemprop="name" 就是悬浮状态，被忽略。
容易漏的点：
-
logo必须是图片 URL，不能只写文字；推荐用<link itemprop="logo" href="...">或<img>，别用<div>包文字 -
url属性必须用<link itemprop="url" href="...">，不能靠<a href>的文本内容自动提取 -
sameAs（社交账号）要列全，每个平台一个<link itemprop="sameAs" href="...">，不能合并写在同一个元素里
验证时最常卡住的地方
即使代码看起来都对，Google Rich Results Test 仍可能报“Missing field”或“Invalid type”，原因往往很隐蔽：
-
itemtypeURL 多了一个斜杠或少了一个字母，比如https://schema.org/Organization/（末尾斜杠）→ 解析器会 404，导致整块失效 - 用了旧版词汇表 URL，如
http://data-vocabulary.org/Person（已废弃多年，2026 年所有工具都不认） - 页面有多个
itemscope，但某个嵌套层级漏了itemtype，导致子级itemprop无法归属 -
itemprop写在了<script>或<style>内部——微数据只解析 HTML 渲染树中的可见/元数据节点
真正难的不是写对语法，而是理解：每个 itemtype 都是一份契约，你承诺按 schema.org 定义的字段规则提供数据；一旦字段缺失、类型错配或 URL 不可达，契约就作废。
