og:type是强制字段,不可省略,必须显式声明为website、article、profile、video.movie、product等标准值;自定义值会被转为website且无法触发平台特有样式;类型错配会导致卡片降级、字段失效或分享统计分散。

og:type 必须显式声明,不能省略
所有平台都要求 og:type 存在,即使只写 website。漏掉它会导致 Facebook、LinkedIn 等平台 fallback 到默认类型(如 website),但部分平台(如早期 Slack)可能直接忽略整张卡片。它不是“可选增强”,而是协议强制字段。
常见 type 值及对应使用场景
不同内容性质要匹配语义准确的 type,否则平台可能拒绝渲染或降级展示:
-
website:静态首页、作品集、企业站等无明确内容实体的页面 -
article:博客、新闻、教程类长文(启用后才支持article:published_time等子属性) -
profile:个人主页(需配合profile:first_name等扩展字段) -
video.movie或video.episode:视频详情页(Facebook 会自动启用播放器控件) -
product:电商商品页(LinkedIn 支持价格和品牌字段)
不要用自定义值如 blog_post 或 portfolio_item——Facebook 会静默转为 website,且无法触发平台特有样式。
type 写错或不一致会引发哪些问题
动态页面尤其容易踩坑:
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 服务端渲染时,
og:type和实际内容类型不匹配(比如文章页返回了website),Facebook Sharing Debugger 会报Object at URL is of a type that is invalid - 同一域名下混用
article和website,但未统一og:url规范化逻辑,导致分享统计分散 - React/Vue 客户端路由页没做 SSR,
og:type被硬编码为website,而真实内容是文章,结果卡片无发布时间、作者信息
检查方式:用 Facebook Sharing Debugger 抓取 URL 后,看 Debug 面板里 Object Properties 下的 Type 是否与你期望一致,且无 warning。
type 和平台行为强绑定,不是纯装饰
某些字段只在特定 og:type 下生效,写了也白写:
-
article:author、article:published_time只对og:type=article有效,Twitter 完全无视 -
video:duration、video:release_date仅当og:type是video.*才被解析 - LinkedIn 对
product类型支持product:price:amount,但对website类型完全忽略该字段
真正要控制分享效果,得先让 og:type 对上,再填配套字段——顺序不能反。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










