itemscope 和 itemtype 必须成对出现在外层容器上，仅加 itemprop 无效；搜索引擎解析微数据时首先查找 itemscope 元素，缺失则整个块不被视为实体，itemprop 仅是孤立字符串。
itemscope 和 itemtype 必须成对出现在外层容器上
只加 itemprop 是无效的。搜索引擎解析微数据时，第一步就是找带 itemscope 的元素——没它，整个块就不是“一个实体”，itemprop 只是孤立字符串。
常见错误包括：
- 把
itemscope和itemtype拆开写在不同标签上（比如div有itemscope，但itemtype写在子span上） - 用错 URL：必须是完整、可访问的 schema.org 地址，如
https://schema.org/Product，不能简写为Product或product - 嵌套不闭合：内层
itemscope没配对结束，导致后续itemprop被归属到错误父级
正确写法示例：
<div itemscope itemtype="https://schema.org/Article"> <h1 itemprop="headline">标题</h1> <time itemprop="datePublished" datetime="2026-07-01">2026年7月1日</time> </div>
itemprop 值必须来自 schema.org 官方属性名，且上下文匹配
itemprop 不是随便起的变量名，它必须是当前 itemtype 所定义类型允许的属性。比如 https://schema.org/Product 支持 price，但 https://schema.org/Person 不支持——强行写会失效，且 Google Rich Results Test 会报错。
立即学习“前端免费学习笔记（深入）”；
容易踩的坑：
- 大小写敏感：
datePublished有效，datepublished或DatePublished都不行 - 混淆层级：给
Offer子项写itemprop="name"，实际应写在Product层；子项要用itemscope+itemtype显式声明新实体 - 文本内容与
meta混用不当：日期、货币等机器可读值优先用<meta itemprop="..." content="...">，避免把 ISO 格式塞进可见文本里影响可读性
标签位置直接影响微数据是否被爬虫提取
2023 年起 Google 全面启用移动优先索引，其首屏内容提取逻辑严格限定在 <main></main> 内部。如果微数据块写在 <header>、<aside> 或嵌套过深（DOM 深度 >6 层），大概率被跳过。
实操建议：
-
<main>必须唯一，且直接包裹核心内容区域（如文章正文、商品详情），不能是<section>或<article>的子元素 - 用浏览器 DevTools 查看源码，确认
itemscope容器确实在<main>的直接后代或浅层嵌套中 - SSR/SSG 项目要检查 HTML 输出结果，避免微数据靠 JS 注入——爬虫不执行 JS，只看静态 HTML
结构化数据不提升排名，但缺失会导致语义丢失
微数据本身不会让页面排名变高，但它决定了搜索引擎“能不能认出这是篇文章”“是不是个带价格的商品”。没有它，<h1> 和 <p> 对爬虫来说只是普通文本，无法关联到 headline 或 description 这类语义。
真正影响 SEO 的是组合效果：
-
<title>和<h1>语义不一致 → 触发“结构混乱”标记 → 长期拉低 E-E-A-T 评分 -
<main>缺失或错嵌 → 爬虫提取页脚备案号当主关键词 → 页面被归类为“网站信息页”而非“内容页” - 微数据属性名拼错或类型不匹配 → Google Rich Results Test 报错 → 富摘要（如星级、价格）不出现在搜索结果中
最常被忽略的一点：验证必须用真实 HTML 源码，不是渲染后 DOM —— 很多框架默认关掉 SSR，本地 view-source: 看不到微数据，自然也骗不过爬虫。
