利用HTML代码中的itemscope和itemprop添加微数据-html教程-PHP中文网

itemscope 表示“这里是一个独立实体”，itemprop 用于定义该实体的具体属性；二者必须与 itemtype 成套使用，且仅适用于含明确语义的实体页面（如公司页、商品页），缺一不可。

利用html代码中的itemscope和itemprop添加微数据

itemscope 和 itemprop 是什么，什么时候该用

它们是 HTML 微数据（Microdata）的核心属性，用来标记网页内容的结构化语义，让搜索引擎、爬虫或阅读器能准确识别“这是一个人”“这是一篇新闻”“这是一个产品价格”。不是所有页面都需要加，但如果你的页面包含明确实体（比如公司联系页、商品详情页、博客文章页），加了能让 Google Search Console 识别出 Organization、Product、Article 等类型，可能影响富媒体摘要展示。

怎么给一个公司信息块加 itemscope + itemprop

常见错误是只加 itemprop 不加 itemscope，或者漏掉 itemtype。正确写法必须三者配合：

Article To Html

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

下载

<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 扫描时，以下问题最常导致微数据不被识别：

itemtype URL 拼写错误，比如写成 http://schema.org（少 s）或漏掉末尾斜杠（实际不需要）；
itemprop 值为空或仅含空格（例如 <span itemprop="price"> </span>）；
重复使用同一 itemprop 多次却没声明为数组（Schema.org 中多数属性默认只接受单值，如 image 可多次出现，但 name 不行）；
把 itemprop 加在 <script></script> 或内联样式里——微数据只作用于可见 DOM 节点，不可见内容不会被解析。

JSON-LD 比 Microdata 更推荐吗

是的，但不是因为 Microdata 无效，而是更易出错。Microdata 依赖 HTML 结构严格对齐，改个 <div> 套法或删个标签就可能断掉整个 <code>itemscope 链。而 JSON-LD 放在或页面任意位置都行，不干扰渲染逻辑。不过如果已有大量旧模板且只改局部，Microdata 仍可快速上线——关键是别混用：同一实体不要同时用 itemscope 和 script type="application/ld+json"，容易触发冲突校验失败。