itemtype URL 必须严格为 HTTPS 绝对地址，如“https://schema.org/Person”，协议、大小写、末尾斜杠均不可错；itemscope 与 itemtype 必须同元素；嵌套实体需独立 itemscope；类型须匹配属性定义；itemprop 值须显式可见或通过 content/datetime 提供。
itemtype URL 格式错：协议、大小写、斜杠全得对
Google Rich Results Test 报 “No structured data detected”，90% 是 itemtype 写错了 URL。它不是“差不多就行”的字符串，而是必须严格匹配的 HTTPS 绝对地址。
常见错误现象：itemtype="http://schema.org/Person" 在 2026 年已完全失效；itemtype="https://schema.org/person"（小写）被解析器拒绝；itemtype="https://schema.org/Person/"（末尾斜杠）直接静默丢弃。
- ✅ 正确写法只有：
itemtype="https://schema.org/Person"、itemtype="https://schema.org/Movie" - ❌ 协议必须是
https，不能是http或省略 - ❌ 域名必须是
schema.org，不能是data-vocabulary.org（2026 年全量弃用） - ❌ 路径末尾不能有斜杠，大小写必须与官网一致（
Product不等于product）
itemscope 和 itemtype 没写在同一元素上
这是语法硬性要求，不是风格建议。分离写法等于没写，整个微数据块会被跳过。
错误示例：<div itemscope><section itemtype="https://schema.org/Book"></section></div>——itemtype 没绑定到 itemscope 所在节点，解析器找不到作用域起点。
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- ✅ 必须合并：
<section itemscope itemtype="https://schema.org/Book"> - ✅ 推荐复用语义标签：
<article itemscope itemtype="https://schema.org/Article">，比套<div>更干净且利于 SEO - ❌ 不要在
<time>、<p>等内联或非容器语义标签上单独加itemtype（HTML 规范不允许）
嵌套结构漏掉内层 itemscope
当 itemprop 指向另一个实体（如 author、address、isPartOf），它本身必须是一个独立作用域，不能靠父级“继承”类型。
典型错误：<div itemscope itemtype="https://schema.org/Article"><p itemprop="author">张三</p></div>——itemprop="author" 没绑定任何 itemscope，Google 直接忽略作者信息。
- ✅ 正确嵌套：
<p itemprop="author" itemscope itemtype="https://schema.org/Person">张三</p> - ✅ 对于地址：
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">，且内部必须含streetAddress、addressLocality等子属性 - ⚠️ 嵌套层级越深，越容易漏掉某一层的
itemscope，建议每加一层就跑一次 Google Rich Results Test
类型选错导致 itemprop 全部失效
itemtype 是契约声明，不是装饰。选错类型，所有 itemprop 都会因校验失败被丢弃——哪怕字段名拼写完全正确。
比如用 itemtype="https://schema.org/Event" 却写 itemprop="telephone"，Google 会直接忽略，因为 Event 类型根本不定义 telephone 属性。
- ✅ 查类型定义的唯一可靠路径：打开
https://schema.org/Event（注意结尾无斜杠），拉到页面底部看 “Properties” 列表 - ✅ 广播单期节目必须用
https://schema.org/RadioEpisode，用RadioProgram会导致播放卡片不出现 - ✅ 品牌名优先用
https://schema.org/Brand，企业注册信息才用https://schema.org/Organization
最常被忽略的一点：所有 itemprop 的值必须来自用户可见文本，或通过 content、datetime 等属性显式提供机器可读格式。光靠渲染结果“看起来对”没用，解析器只认结构。
