itemtype必须与itemscope共存于同一html标签,且值为无尾斜杠的https schema.org完整url,如https://schema.org/person;否则微数据无效。

itemtype必须和itemscope写在同一HTML元素上
单独写itemtype毫无作用,它不是独立配置项,而是微数据的作用域声明的一部分。搜索引擎只认“itemscope + itemtype”成对出现在同一个开始标签里的组合。
常见错误是把itemscope放在<div>上,<code>itemtype却加在子级<section></section>里;或者用CSS类名模拟作用域,比如class="person-scope"——这些都不会被解析器识别。
-
itemscope定义“这里开始一个新实体” -
itemtype紧跟着说明“这个实体属于哪一类”,例如人、文章、商品 - 二者缺一不可,且必须共存于同一标签:
itemtype值只能是HTTPS协议的完整Schema.org URL
不能缩写、不能拼错、不能省略协议或尾部斜杠。2026年起,Google、Bing等主流解析器已全面拒绝HTTP协议和非schema.org来源的URL。
错误示例:
itemtype="Person"、itemtype="http://schema.org/Person"、itemtype="https://schema.org/Person/"(末尾斜杠)、itemtype="./person"——全部失效。- ✅ 正确写法:
itemtype="https://schema.org/Person" - ✅ 查类型最稳路径:打开 https://schema.org/Person(注意是 HTTPS,无尾斜杠),页面底部有“More specific Types”,点进去确认是否适合你的场景
- ⚠️ LocalBusiness、Restaurant、Hospital 等子类也必须用完整 HTTPS URL,不能套用父类再靠属性补全
选错itemtype会导致itemprop被静默忽略
itemprop不是通用字段,它绑定的是当前itemtype在Schema.org中明确定义的属性。比如itemprop="telephone"在https://schema.org/Person下合法,在https://schema.org/Article下直接无效——Google Rich Results Test不会报错,但会跳过该字段。
anything-to-html下载将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 查属性是否支持:打开对应类型的 Schema.org 页面(如 https://schema.org/LocalBusiness),滚动到“Properties”章节,只认这里列出的
itemprop名 - 嵌套对象也要配
itemtype:比如author是Person,就得写<div itemprop="author" itemscope itemtype="https://schema.org/Person">,不能只写<code>itemprop="author"就完事 - 日期、价格、URL类属性需配合
datetime、content、href等属性提供机器可读值,光靠文本内容大概率被误判 - 工具显示“Valid”但没提取出任何字段——多半是
itemtype指向了不支持富媒体展示的类型(如Thing),或缺少必需属性(如name、url) - 工具报“Missing field”但没说明哪层出错——往往是因为嵌套
itemscope没紧贴itemprop,中间插了无关容器 - 本地测试时用file://协议打开HTML,工具无法加载外部
itemtypeURL(哪怕它是HTTPS)——必须部署到HTTP(S)服务上再测
验证itemtype是否生效必须用Google Rich Results Test
浏览器开发者工具看不到微数据是否被识别,
itemtype写对了也不代表结构化数据就跑通。唯一可靠方式是把HTML丢进 Google Rich Results Test(注意:不是旧版 Structured Data Testing Tool)。常见假成功现象:
真正容易被忽略的点在于:itemtype不是“选类型”,而是“签契约”。你选了哪个URL,就等于承诺按那个Schema.org类型的所有约束来组织数据——少一个必需字段、错一个大小写、漏一个嵌套层级,契约就作废。
- ✅ 正确写法:










