itemtype必须是完整https url,如https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937article;缺s、相对路径、末尾斜杠、大小写错误或多个类型均导致解析失败。

itemtype必须是完整 HTTPS URL,写成 HTTP 或相对路径直接失效
浏览器和结构化数据测试工具(如 Google Rich Results Test)会严格校验 itemtype 的协议与可访问性。哪怕只是少一个 s,比如写成 http://schema.org/Person,现代解析器会直接拒绝识别整个 itemscope 块——它不会降级处理,而是彻底忽略。
常见错误包括:
-
itemtype="schema.org/Person"(缺协议、缺https://) -
itemtype="./vocab/Product"(相对路径,不合法) -
itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product/"(末尾多斜杠,部分解析器会 404) -
itemtype="Person"(纯字符串,不是 URL,完全无效)
itemtype指向的 URL 必须能返回 HTTP 200,空页面或重定向都不行
itemtype 不要求该 URL 返回 JSON-LD 或机器可读内容,但它必须是一个真实可达、状态码为 200 的 HTTPS 地址。WHATWG 规范明确要求“该 URL 应在 HTTP 层可获取”。如果域名过期、路径被删、或服务器返回 404/301/500,Google 工具就会报 Unable to fetch schema.org type 类错误,整段微数据作废。
验证建议:
- 在浏览器地址栏直接打开你写的
itemtype值,确认能加载出一个页面(哪怕只是 HTML 文档) - 避免使用短链、跳转服务或内部代理地址
- 优先用官方标准地址,如
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Article,不要自行镜像或改写
同一个 itemscope 元素不能有多个 itemtype,也不能用空格或逗号分隔
itemtype 是单值属性,语义上表示“这个容器描述的是**唯一一种类型**”。即使你想表达“既是产品又是本地商家”,也不能写成 itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937LocalBusiness" 或用逗号分隔。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
正确做法是选择最贴合页面核心意图的那个类型,例如企业首页主推服务与地址,就用 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937LocalBusiness;商品详情页就用 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product。需要嵌套其他类型时,应通过子元素的 itemscope + 新 itemtype 实现,而非堆砌。
大小写和拼写必须完全匹配 schema.org 官方定义
itemtype URL 中的路径部分区分大小写。写成 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937article(小写 a)或 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937person 都无法通过验证——正确写法是 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Article、https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person。
这个细节容易被忽略,因为浏览器渲染不受影响,但结构化数据提取器会严格比对。Google Rich Results Test 报错信息通常只提示“Invalid type”,不会告诉你哪里错了,得逐字符核对。
建议:
- 始终从 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937 页面点击进入具体类型,复制完整 URL
- 不要靠记忆拼写,尤其注意
Organization、LocalBusiness、VideoObject等长单词的大小写与连字符
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










