itemtype必须是严格匹配的https url，如https://schema.org/localbusiness；itemscope与itemtype须同标签声明；itemprop须符合itemtype定义的属性集；嵌套对象需用itemprop+itemscope同元素绑定。

itemtype 必须是完整 HTTPS URL，不能缩写或拼错

itemtype 的唯一作用是告诉解析器“这个 itemscope 描述的是哪一类实体”，它必须指向 schema.org 官方定义的、可 HTTP 访问的类型页面。写成 Person、https://schema.org/person（小写）、http://schema.org/Person（HTTP 协议）或 ./Product 都会直接导致整块微数据被 Google Rich Results Test 忽略。

常见错误包括：复制旧文档里的 http://data-vocabulary.org/Product（已废弃多年）、用本地路径模拟类型、或把 itemtype 当 class 一样随意命名。验证时只要看到 “Unrecognized type” 或 “No structured data detected”，第一反应就该检查 itemtype 是否为严格匹配的 HTTPS URL。

• ✅ 正确：<div itemscope itemtype="https://schema.org/LocalBusiness"> <li>❌ 错误：<code><div itemscope itemtype="LocalBusiness">（无协议无域名） <li>❌ 错误：<code><div itemscope itemtype="https://schema.org/localbusiness">（大小写敏感） <h3>itemscope 和 itemtype 必须写在同一 HTML 标签上</h3> <p>这两个属性不是“父子关系”，也不是“作用域继承”，而是强绑定的声明对。它们必须共存于同一个起始标签内，否则搜索引擎无法建立语义上下文——哪怕只漏掉一个，所有内部的 <code>itemprop 都会失效。

  典型误用场景：在 上加 itemscope，却把 itemtype 写在子 <main></main> 里；或者把 itemtype 放在 <section></section>，而 itemscope 放在更深层的 <article></article>。这种拆分会让解析器完全丢失类型信息。

  

  HTML汇报生成器

  🚀 不用写一行代码！把项目总结、工作汇报、研究报告、技术文档、提案、数据看板直接变精美HTML。12种主题 × 11种背景动效 × 9种鼠标特效 × 10种边框样式 × 实时调色器 × 毛玻璃卡片 × PDF导出，生成后还能自由调色，零门槛AI直出。触发词：项目总结、工作汇报、PPT、生成报告、做个总结、HTML文档、数据报告、流程文档、会议纪要、技术文档、研究报告、数据看板、提案、做个展示页、帮我做个汇报、文档生成。

  下载
  • ✅ 正确：<article itemscope itemtype="https://schema.org/Article"></article>
  • ❌ 错误：<article itemscope><header itemtype="https://schema.org/Article"></header></article>
  • ❌ 错误：<article itemtype="https://schema.org/Article"></article>

  itemtype 决定可用的 itemprop，不能跨类型混用

  每个 schema.org 类型都明确定义了它支持哪些属性。比如 price 只在 https://schema.org/Offer 或 https://schema.org/Product 下合法；写在 https://schema.org/Person 里，Google 工具会报 “Property price is not a valid property of Person”。这不是警告，是硬性校验失败。

  查属性前必须先确认 itemtype：去 https://schema.org/[YourType] 页面看右侧 “Properties” 表格，注意每行的 “Expected Type” 列——它告诉你这个属性值本身该是什么类型（比如 image 要求是 URL 或 ImageObject，不能是纯文本“logo.jpg”）。

  • ✅ 合法：<div itemscope itemtype="https://schema.org/Offer"><span itemprop="price">¥299</span></div>
  • ❌ 非法：<div itemscope itemtype="https://schema.org/Person"><span itemprop="price">¥299</span></div>
  • ⚠️ 注意：telephone 在 Person 和 Organization 中都存在，但 openingHoursSpecification 只属于 LocalBusiness，别套错

  嵌套对象必须用 itemprop + itemscope 紧贴绑定

  当某个属性本身是个复杂对象（比如 author 是一个人、address 是一个地址），不能靠 DOM 层级“自动推导”。必须让 itemprop 和子级的 itemscope 出现在**同一个元素**上，否则 Google 会丢弃整个嵌套结构。

  最容易被忽略的是地址类标记：很多人写 <div itemprop="address"><span itemscope itemtype="https://schema.org/PostalAddress">...</span></div>，这会导致 address 值为空。因为 itemprop="address" 没绑定到任何 itemscope，只是个空壳。

  • ✅ 正确：<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">... <li>❌ 错误：<code><div itemprop="address"><div itemscope itemtype="https://schema.org/PostalAddress">... <li>⚠️ 地址必须补全关键字段：<code>addressLocality、addressRegion、postalCode、addressCountry 缺一不可，否则 LocalBusiness 富媒体可能不触发地图展示
  实际部署时最常卡住的点不在语法，而在类型选择——页面主体是“一家餐厅”，就该用 https://schema.org/Restaurant，而不是把菜单项、评论、营业时间全塞进 https://schema.org/WebPage。Google 不关心你写了多少 itemprop，只认那个最外层的 itemtype 是否准确描述了用户打开页面时最想了解的对象。