itemscope 表示“这里是一个独立实体”，itemprop 用于定义该实体的具体属性；二者必须与 itemtype 成套使用，且仅适用于含明确语义的实体页面（如公司页、商品页），缺一不可。
itemscope 和 itemprop 是什么，什么时候该用
它们是 HTML 微数据（Microdata）的核心属性，用来标记网页内容的结构化语义，让搜索引擎、爬虫或阅读器能准确识别“这是一个人”“这是一篇新闻”“这是一个产品价格”。不是所有页面都需要加，但如果你的页面包含明确实体（比如公司联系页、商品详情页、博客文章页），加了能让 Google Search Console 识别出 Organization、Product、Article 等类型，可能影响富媒体摘要展示。
怎么给一个公司信息块加 itemscope + itemprop
常见错误是只加 itemprop 不加 itemscope，或者漏掉 itemtype。正确写法必须三者配合：
<div itemscope itemtype="https://schema.org/Organization">
<h1 itemprop="name">极客科技有限公司</h1>
<p itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="streetAddress">科技园路8号</span>，
<span itemprop="addressLocality">深圳</span>
</p>
<a itemprop="url" href="https://geektech.example">官网</a>
<span itemprop="telephone">+86-755-12345678</span>
</div>
-
itemscope表示“这里是一个独立实体”； -
itemtype必须是 Schema.org 上定义的完整 URL（不能简写成Organization）； -
itemprop的值必须符合该itemtype允许的属性列表（查https://schema.org/Organization确认）； - 嵌套结构（如
address）需要单独加itemscope+ 对应itemtype，否则会被当成字符串而非结构化地址。
常见报错和验证失败原因
用 Google Rich Results Test 或 Schema Markup Validator 扫描时，以下问题最常导致微数据不被识别：
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
-
itemtypeURL 拼写错误，比如写成http://schema.org（少 s）或漏掉末尾斜杠（实际不需要）； -
itemprop值为空或仅含空格（例如<span itemprop="price"> </span>）； - 重复使用同一
itemprop多次却没声明为数组（Schema.org 中多数属性默认只接受单值，如image可多次出现，但name不行）； - 把
itemprop加在<script>或内联样式里——微数据只作用于可见 DOM 节点，不可见内容不会被解析。
JSON-LD 比 Microdata 更推荐吗
是的，但不是因为 Microdata 无效，而是更易出错。Microdata 依赖 HTML 结构严格对齐，改个 <div> 套法或删个标签就可能断掉整个 itemscope 链。而 JSON-LD 放在 <head> 或页面任意位置都行，不干扰渲染逻辑。不过如果已有大量旧模板且只改局部，Microdata 仍可快速上线——关键是别混用：同一实体不要同时用 itemscope 和 script type="application/ld+json"，容易触发冲突校验失败。
立即学习“前端免费学习笔记（深入）”；
