itemtype必须是完整https url,否则结构化数据块完全失效;需严格匹配schema.org官方类型与属性,嵌套对象须独立声明且紧邻对应元素。

itemtype 必须是完整 HTTPS URL,否则整个微数据块失效
Google 和其他结构化数据解析器会直接跳过 itemscope 块,只要 itemtype 不是可验证的 HTTPS 协议 URL。这不是警告,是硬性拦截——itemtype="http://schema.org/Person"、itemtype="Person"、itemtype="./person" 全部无效。
常见错误包括:少写一个 s(HTTP → HTTPS)、用本地路径、拼错 schema.org 域名、或漏掉末尾斜杠(https://schema.org/Product/ 是合法的,但 https://schema.org/Product 也是,二者都返回 200;关键不是斜杠,而是协议+域名+路径是否真实可访问)。
- ✅ 正确:
itemtype="https://schema.org/Article" - ❌ 错误:
itemtype="http://schema.org/Article"(HTTP 已被主流工具拒绝) - ❌ 错误:
itemtype="schema.org/Article"(缺协议,不是 URL) - ❌ 错误:
itemtype="/vocab/article"(相对路径,无法验证)
验证方式很简单:把 itemtype 值粘贴进浏览器地址栏,必须能返回 HTTP 200 响应(哪怕只是 HTML 页面)。这是 WHATWG 规范和 Google Rich Results Test 的共同底线。
同一个 itemscope 只能有一个 itemtype,且类型决定可用 itemprop
itemtype 不是“分类标签”,它是契约——定义了这个作用域内哪些 itemprop 合法、哪些会被解析器报错。比如你在 itemtype="https://schema.org/Person" 下写 itemprop="price",Google 工具会明确提示 “Property price is not a valid property of Person”。
查对类型和属性的唯一可靠方式,是打开 https://schema.org/YourType(如 https://schema.org/LocalBusiness),滚动到 “Properties” 表格,只取其中列出的属性名,大小写一个字母都不能错。
- ✅
itemprop="telephone"在Person和Organization中都有效 - ❌
itemprop="businessHours"已废弃,应改用openingHoursSpecification - ⚠️
itemprop="image"要求值为 URL 字符串,不能是<img>标签;得用<link itemprop="image" href="logo.jpg">或<meta itemprop="image" content="logo.jpg">
itemtype 决定页面主体语义,选错会导致富媒体摘要不触发
一个企业官网首页,主 itemscope 用 itemtype="https://schema.org/Product" 是典型错误。Google 不关心你页面里有没有商品列表,它看的是“用户打开这个页面,最想了解什么?”——答案是公司本身,所以主类型必须是 Organization。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
选错类型后果很具体:缺 address 或 telephone 的 Organization,地图卡片不会出现;没嵌套 offers(含 price 和 priceCurrency)的 Product,搜索结果里不显示价格。
- 文章页 →
https://schema.org/Article(需headline、datePublished) - 餐厅详情页 →
https://schema.org/Restaurant(需address、priceRange、openingHoursSpecification) - 活动页 →
https://schema.org/Event(需startDate、location)
嵌套对象(如作者、地址、评论)必须用独立 itemscope + itemtype 声明,且必须紧贴在对应 itemprop 元素内部,不能隔层。这是最容易被忽略的结构性错误:机器不是靠视觉层级理解嵌套,而是靠 DOM 紧邻关系。
itemtype 不影响页面渲染,但写错会彻底丢失结构化数据价值
itemtype 属性本身不改变 CSS 样式、不触发 JS 事件、也不影响页面加载速度。它的全部作用就是告诉爬虫:“这个容器描述的是哪一类事物”。这意味着:它极其安静,也极其脆弱——写错一个字符,整块结构化数据就归零。
真正难的不是写对 URL,而是保持类型与内容一致。比如电商商品页混着用户评论模块,主类型仍是 Product,评论要用 itemprop="review" + 嵌套 itemtype="https://schema.org/Review",而不是给整个页面套 itemtype="https://schema.org/CollectionPage"。
最后提醒一句:别信“自动检测工具生成的 itemtype”。很多 CMS 插件或 SEO 工具会硬塞 http://data-vocabulary.org 这类已废弃地址,或者把 BlogPosting 和 Article 混用——后者才是当前推荐类型,前者已被标记为 legacy。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










