itemtype必须是完整HTTPS URL,如https://schema.org/Person;嵌套时需紧贴对应itemprop元素;同一itemscope仅允许一个itemtype,但可含多个itemprop;验证须用Google Rich Results Test,静默失效常见于协议错误或隔层嵌套。

itemtype必须是完整 HTTPS URL,不能缩写或省略协议
浏览器和结构化数据验证工具(比如 Google Rich Results Test)会直接拒绝非 HTTPS 的 itemtype 值。哪怕只是少一个 s,比如写成 http://schema.org/Person,整个 itemscope 块就会被忽略。
常见错误包括:
- 写成
Person或schema.org/Person—— 缺少协议和完整域名 - 用相对路径如
./vocab/person—— 解析器无法定位语义定义 - 拼错 URL,比如
https://schema.orh/Person(orh 是错的)
正确写法只有一种:itemtype="https://schema.org/Person"。这个 URL 不需要返回 JSON-LD,只要 HTTP 状态码是 200 即可(哪怕返回的是 HTML 页面)。
Google Structured Data Testing Tool 是唯一靠谱的检查入口
别信浏览器开发者工具里“Elements”面板看到的 itemtype 值是否高亮——它不校验有效性。真正能判断结构化数据是否生效的,只有 Google 官方工具。
操作要点:
- 把页面 URL 或 HTML 片段粘贴进 Google Rich Results Test(新版 Search Console 中的“结构化数据”报告页)
- 如果报错 “
itemtypeis not a valid URL” 或 “Unrecognized type”,基本就是协议、拼写或路径问题 - 注意:工具不会提示“你少写了
s”,只会静默丢弃整块,所以得自己比对标准 URL
嵌套 itemtype 必须紧贴 itemprop,不能隔层
itemtype 本身不校验嵌套逻辑,但 Google 解析器对嵌套结构极其敏感。如果你在 itemprop="author" 下声明作者类型,itemscope itemtype 必须直接写在同一个元素上。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML,微信编辑器可直接渲染,无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
错误示例(会被整个忽略):
<div itemprop="author"> <div itemscope itemtype="https://schema.org/Person">张三</div> </div>
正确写法(紧贴绑定):
<div itemprop="author" itemscope itemtype="https://schema.org/Person">张三</div>
这种“隔层嵌套”在 HTML 结构上看不出问题,但 Google 工具里查不到 author 字段,也不会报明确错误,容易误判为内容没填全。
同一 itemscope 只能有一个 itemtype,但可叠加多个 itemprop
itemtype 是类型主干,不是属性列表。一个容器声明了 itemtype="https://schema.org/LocalBusiness",就不能再加第二个 itemtype;但你可以同时写 itemprop="name"、itemprop="address"、itemprop="telephone" —— 这些都合法。
容易踩的坑:
- 误以为要为地址单独声明
itemtype="https://schema.org/PostalAddress"就得再套一层itemscope,结果忘了在父级itemprop="address"上绑定,导致地址字段丢失 - 在同一个
div上重复写itemtype,浏览器不报错,但 Google 工具只认第一个,后面被忽略
真正关键的不是“写几个”,而是“每个 itemtype 是否有对应 itemprop 绑定,且绑定位置是否紧贴”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










