itemscope 和 itemtype 必须在同一 HTML 元素上共存，构成强制绑定的“作用域声明对”，单独使用任一属性均无效；itemtype 值须为完整 HTTPS URL 且无尾部斜杠，类型需匹配内容意图，并通过 Google Rich Results Test 验证。

itemscope 和 itemtype 必须写在同一 HTML 元素上

单独加 itemscope 或只写 itemtype 都无效，Google 和其他解析器会直接跳过整块微数据。它们不是可选搭配，而是强制绑定的“作用域声明对”。

• itemscope 表示“这里开始一个新实体”，但不说明类型；itemtype 紧跟其后，指明这个实体是 https://schema.org/Product 还是 https://schema.org/LocalBusiness 等具体类型
• 必须写在同一个起始标签里，比如 <div itemscope itemtype="https://schema.org/Product"> —— 不能拆成 <div itemscope><section itemtype="...">
• 常见错误：在 <body itemscope> 上声明，却把所有 itemprop 放在深层 <p> 里，导致层级断裂、解析失败

itemtype 值必须是完整 HTTPS URL，且末尾不能有斜杠

写错 URL 格式是最隐蔽也最常被忽略的失效原因。解析器不会报错，但结构化数据完全不生效。

• 正确：https://schema.org/Product、https://schema.org/Person（注意协议、域名、路径全小写、无尾部斜杠）
• 错误：Product（缩写）、http://schema.org/Product（HTTP 不安全）、https://schema.org/Product/（末尾斜杠非法）、//schema.org/Product（协议相对路径）
• 2026 年起 Google 已停用 http://data-vocabulary.org/，所有旧地址必须迁移到 https://schema.org/

itemscope + itemtype 定义的是作用域起点，不是全局开关

它只影响该元素及其后代中合法的 itemprop，不跨容器、不继承、不共享。

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

• 每个独立实体（如页面上有三篇食谱）都必须各自有 itemscope itemtype 容器，不能共用一个外层 div
• 嵌套对象（如 author 是 Person）必须新开一层 itemscope itemtype，且必须作为 itemprop="author" 的**直接子元素**，中间不能插无关 wrapper
• 推荐复用语义化标签作容器，比如用 <article itemscope itemtype="https://schema.org/Article">，而非无意义的 <div>

类型选择要匹配页面主体意图，不是越细越好

选错 itemtype 不会导致语法错误，但会让 Google Rich Results Test 报 “itemtype does not match content”，结构化数据被过滤或降权。

立即学习“前端免费学习笔记（深入）”；

• 企业首页展示地址、电话、营业时间？主类型应为 https://schema.org/LocalBusiness，不是 Organization 或硬套 Product
• 博客文章页，核心是文章本身，就用 https://schema.org/Article；若页面混着 FAQ 模块，不要把整个 <main> 标为 FAQPage，而应单独为 FAQ 区域开新 itemscope
• 查 schema.org 时，务必点进对应 type 页面的 “Properties” 表格，确认你要用的 itemprop 是否被该类型允许（例如 price 在 Person 下非法）

验证环节最容易被跳过：写完必须用 Google Rich Results Test 实时抓取 HTML，看是否识别出完整实体树——任何一层漏掉 itemscope 或写错 itemtype URL，整条链就断了。