HTML如何添加微数据｜语义化入门教程

本文深入解析了HTML中微数据（microdata）的正确使用方法，强调必须协同运用itemscope、itemtype和itemprop三个属性才能被搜索引擎准确识别为结构化数据，并指出常见错误如遗漏外层作用域或误用属性名；同时提醒读者严格遵循schema.org规范查证type与itemprop的匹配关系，注意大小写敏感、URL绝对性及预期数据类型；文章还客观对比了microdata与JSON-LD的适用场景，建议在动态渲染、复杂嵌套等情况下优先选用更稳定可靠的JSON-LD；最后提供基于Google官方工具的实操验证方法，帮助开发者避开“看似标记成功、实则数据丢失”的陷阱——微数据不是贴标签那么简单，而是细节决定语义能否真正落地。

怎么给 HTML 元素加 microdata 属性

microdata 不是独立语法，而是靠一组标准属性往现有元素上“贴标签”。核心就三个：itemscope、itemtype、itemprop，缺一不可才能被解析器识别为结构化数据。

常见错误是只加 itemprop，比如写 张三 —— 没有 itemscope 和 itemtype，搜索引擎根本不知道这是“人”还是“产品”还是“事件”。

• itemscope：必须加在最外层容器上（如
  或

  ），表示“这里开始一个实体”
• itemtype：紧跟着 itemscope，值必须是合法 URL，比如 https://schema.org/Person，不能写成 Person 或 person
• itemprop：用在内部子元素上，值是字符串（如 "name"、"jobTitle"），对应 schema.org 定义的属性名，大小写敏感

schema.org 的 type 和 itemprop 怎么查才不踩坑

直接去 schema.org 查，但别从首页瞎点。容易错的地方是：同一类信息在不同 type 下属性名不同，甚至含义也不同。

比如“电话号码”：Person 用 telephone，Organization 也用 telephone，但 LocalBusiness 还额外支持 faxNumber；而 Event 根本没有 telephone，得用 performer 关联到人再取。

• 先确定你要描述的主体类型（人？餐厅？文章？活动？），再查对应 type 页面的 “Properties” 表格
• 注意看属性右边的 “Expected Type”，比如 image 可能要求是 ImageObject 或 URL，不能随便塞个字符串
• 避免用已废弃的属性，比如旧文档里出现的 businessHours，现在应改用 openingHoursSpecification

microdata 和 JSON-LD 哪个该优先用

现在绝大多数场景，应该优先写