itemref必须写在itemscope元素上，不能单独存在；其值为id列表，用于将分散的itemprop属性合并到当前实体，且被引用的itemprop名称须符合schema.org类型约束。
itemref 必须写在 item 元素上，不能单独存在
很多人误以为 itemref 是个独立属性，可以随便加在任意标签上。其实它只能作为 itemscope 元素的属性出现，作用是“把其他地方定义的属性拉进来”。如果写在没带 itemscope 的元素上，浏览器完全忽略，微数据解析器也看不到。
-
itemref的值必须是空格分隔的 ID 列表，对应页面中其他元素的id - 被引用的元素（即那些
id对应的标签）本身不需要有itemscope，但必须有itemprop - 被引用的
itemprop值会和当前itemscope元素合并，构成完整结构化数据
itemprop 和 itemref 配合时，属性名必须一致且可识别
你用 itemref 拉进来的元素，它的 itemprop 名称必须和当前 itemscope 所描述的类型兼容。比如 http://schema.org/Person 期望 name、jobTitle，你却拉了个 itemprop="price" 进来，虽然语法不报错，但 Google Structured Data Testing Tool 会提示“属性未被类型支持”。
- 推荐先查 Schema.org 官方文档确认类型支持哪些
itemprop - 多个同名
itemprop（比如两个itemprop="address"）会被当作数组处理，顺序按 DOM 出现位置，不是按itemref里写的顺序 - 如果被引用元素自身还嵌套了
itemscope，它会被当作嵌套对象解析（例如itemprop="address" itemscope itemtype="http://schema.org/PostalAddress"）
常见错误：ID 引用失效或解析为空
最常遇到的是 Chrome DevTools 的“Elements → Microdata”面板显示为空，或者 Rich Results Test 工具报 “No structured data detected”，其实问题往往出在 ID 匹配上。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- ID 中含点号（
.）、冒号（:）等 CSS 选择器特殊字符时，HTML 允许，但某些旧版解析器可能截断——建议只用字母、数字、下划线、短横线 - ID 大小写敏感：
itemref="ContactInfo"对不上id="contactinfo" - 被引用元素不在同一 HTML 文档内（比如 iframe 或动态插入未触发重解析）会导致引用丢失
- 使用 JavaScript 动态设置
id或itemref后，需确保在微数据解析前已就位；部分工具不会重新扫描 DOM
一个能过 Google 测试的真实片段
下面这段代码在 Rich Results Test 中能正确识别为 Person，且 jobTitle 和 alumniOf 来自外部 ID：
<div itemscope itemtype="http://schema.org/Person" itemref="p-job p-school"> <span itemprop="name">张三</span> </div> <div id="p-job"><span itemprop="jobTitle">前端工程师</span></div> <div id="p-school"><span itemprop="alumniOf" itemscope itemtype="http://schema.org/EducationalOrganization"> <span itemprop="name">某某大学</span> </span></div>
注意：所有 id 都是纯字母，itemref 值用空格分隔，被引用元素都明确写了 itemprop，且嵌套结构符合 Schema 规范。
真正容易被忽略的是：itemref 不解决语义混乱，只解决 DOM 位置分散的问题。如果属性逻辑本就不属于同一个实体，硬用 itemref 拼凑，反而会让搜索引擎更难理解。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
