itemtype必须是schema.org上严格匹配的https完整url，如https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937localbusiness；itemprop须在itemscope内且仅用该type定义的属性；嵌套对象需itemprop与子itemscope同元素；特殊值须用link/meta/time等专用标签声明。
itemtype必须是完整 HTTPS URL，不能简写或拼错
itemtype不是随便填的字符串，它必须指向 schema.org 上一个真实可访问的类型定义页，且协议、路径、大小写全部严格匹配。比如 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937LocalBusiness 是合法的，而 http://schema.org/localbusiness、LocalBusiness、https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Localbusiness 全部无效。
主流工具（如 Google Rich Results Test）在 2026 年已彻底弃用 http://data-vocabulary.org/ 等旧地址，也不再容忍任何斜杠缺失或大小写偏差。验证时若报“Unrecognized type”，八成是这里出问题。
- 检查方式：把
itemtype值粘贴进浏览器地址栏，确认能返回 200 页面（哪怕内容是 HTML） - 不要手写——直接从 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937 某个类型页复制完整 URL
- 企业类页面优先选
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937LocalBusiness，而非更宽泛的Organization；产品页必须用Product或Offer，不能混用
itemprop只能出现在itemscope作用域内，且必须匹配对应type的字段
itemprop 不是独立有效的属性，它像一个“字段名签”，但签在哪，得看上面有没有盖“实体章”（itemscope）和“类型钢印”（itemtype）。没这两样，itemprop 就是废纸。
更关键的是，每个 itemprop 值必须是当前 itemtype 在 schema.org 官网明确定义的属性。比如 price 只对 Offer 和 Product 合法，写在 Person 里会直接报错。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 查字段是否合法：打开
itemtype对应的 schema.org 页面（如 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Offer），在“Properties”章节找目标属性名 - 大小写敏感：
datePublished≠datepublished，telephone≠phone - 文本内容会被原样提取，所以
<p itemprop="name">iPhone <sup>®</sup></p>提取值是"iPhone ®"，Google 可能拒收——纯文本优先，必要时改用<meta itemprop="name" content="iPhone 15">
嵌套对象必须让itemprop和子itemscope在同一元素上
当某个属性本身是个对象（比如 author 是 Person，address 是 PostalAddress），嵌套结构极易失效。根本原因是：解析器要求 itemprop 必须“直接承载”子 itemscope，中间不能插无关 wrapper。
错误写法：<div itemprop="author"><div itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">张三</div></div> → itemprop="author" 没绑定到任何 itemscope，整个嵌套块被丢弃。
- 正确写法：
<div itemprop="author" itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">张三</div> - LocalBusiness 的
address嵌套常漏掉postalCode或addressCountry，导致地图功能不触发 - 避免用
itemref跨区域拼接——2026 年所有主流搜索引擎都不支持，别浪费时间
URL、日期、价格等特殊值必须用专用写法
微数据不靠渲染后肉眼判断，而是按 DOM 属性规则提取机器可读值。纯文本无法表达语义，必须用特定标签或属性显式声明。
-
url类（image、sameAs、url）：必须用<link itemprop="image" href="logo.jpg">或<meta itemprop="url" content="https://example.com">，<img itemprop="image" src="...">无效 -
datetime类（startDate、datePublished）：用<time itemprop="datePublished" datetime="2026-10-05">10月5日</time>，优先读datetime属性 -
price类：用<div itemprop="price" content="89.99">¥89.99</div>，content属性提供机器可读数值，文本只作展示 - 隐藏字段（SKU、ID）：用
<meta itemprop="sku" content="A2890">，但必须放在同一级itemscope容器内，且带content
最容易被忽略的其实是层级关系：itemscope 定边界，itemtype 定契约，itemprop 才是履约动作。三者断一环，整块结构化数据就归零——不是部分失效，是完全不被识别。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
