summary将twitter:image压缩为60×60小图标,文字区域窄、标题易截断;summary_large_image则用作封面图,需≥1200×630像素,x客户端从中裁切1.91:1中央区域,焦点必须居中以防关键内容被裁。

summary 和 summary_large_image 的实际渲染差异
选错类型不会报错,但会直接导致分享卡片在 X(原 Twitter)客户端里“看起来不像你想要的那样”。summary 强制压缩 twitter:image 到约 60×60 像素作小图标,文字区域窄、标题截断快;summary_large_image 则把图当封面用,宽度至少要 1200px,X 客户端会从中裁出 1.91:1(≈1200×630)区域,焦点必须居中,否则关键内容被砍掉。
什么时候该用 summary_large_image
只要页面有主视觉图、封面图、产品截图或 Banner 类图像,就该用 summary_large_image。它不是“更高级”,而是唯一能展示大图的稳定类型——app 和 player 已基本失效,photo 从未被官方支持,validator 会直接报错。
-
twitter:image必须是直链(不能带重定向),格式推荐 JPG 或 PNG,避免 WebP(部分旧客户端不识别) - 图片宽高比不必严格 1.91:1,但建议尺寸 ≥1200×630,上限高度 ≤2000px,否则可能被自动缩放模糊
- 别指望 X 平台按你写的尺寸原样显示:它只取中间区域裁切,人物/LOGO/文字务必放在画面中央
summary 适合什么场景
summary 不是“降级方案”,而是明确为无图或弱网优化设计的类型。比如纯文字博客、API 文档页、后台管理页,或者你根本不想暴露主图(比如预发布页、灰度测试页)。
-
twitter:image在summary下会被强制压成小图标,哪怕你给的是 2000×1000 大图也没用 - 标题(
twitter:title)超过 70 字符会被硬截断,且不换行;描述(twitter:description)超 200 字符同样被砍,不提示 - 没填
twitter:image,卡片就只剩标题+描述+小 logo(来自twitter:site关联账号头像)
缓存和验证才是最大陷阱
写对了标签 ≠ 立刻生效。X 平台抓取后会缓存卡片元数据,哪怕你改了 HTML、换了图、甚至删了 meta 标签,旧卡片仍可能持续显示数小时甚至一两天。
- 必须用 Twitter Card Validator 强制刷新抓取,输入 URL 后点 “Preview card” 才算真正触发更新
- validator 报 “Card not found” 多半是因为服务器返回 404/500,或 HTML 中
twitter:card标签位置不对(比如写在里) - CDN 或反向代理缓存了 HTML?那 validator 看到的还是旧版本,得先清 HTML 缓存再测
meta,而在于图怎么构图、缓存怎么破、以及你永远不知道用户是从哪个客户端点开链接的——iOS 官方 App、Android 第三方客户端、桌面网页版,对裁切逻辑和尺寸容忍度都不一样。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











