Figma 动态 OG Image(Open Graph 社交分享卡片)模板架构与 Satori / @vercel/og 自动化生图实战:1200×630 安全区、Auto Layout Flexbox 对齐与中文字体子集优化
当用户将你的产品文档、博客文章或 SaaS 仪表盘链接粘贴进微信聊天框、X(Twitter)、Slack、飞书或 Discord 时,系统会自动抓取网页 <meta property="og:image"> 生成一张图文预览卡片。如果全站几百个页面只共用一张静态海报,点击率往往大幅落后于展示实时文章标题、作者头像、阅读时长与产品截图的动态 OG Image(Open Graph Image)。
目前业界主流方案是在 Figma 中由设计师搭建高精度模板,再由前端通过 Satori / @vercel/og 在 Edge Runtime 中将 JSX 直接渲染为 PNG 图片。然而实际落地时,设计师画得越自由,开发还原越容易崩溃:Figma 里的阴影模糊、Layer Blur、多栏 Grid 布局或自定义中文字体包,到了 Satori 里不是直接报错白屏,就是触发 Vercel Edge 体积超限,甚至在移动端微信里被裁切掉关键标题。打通这条自动化生图链路,必须在设计阶段就严格对齐 Satori 的底层约束。
一、主流社交平台 OG Image 尺寸与裁剪安全区对比 #
不同社交软件和浏览器对 og:image 的抓取比例与圆角裁切策略截然不同,如果未预留统一安全区,同一张卡片在微信里正常,在 X 信息流里却可能切掉左右两侧的 Logo 与副标题:
| 平台 / 协议场景 | 推荐输出分辨率 | 宽高比 | 边缘裁切与缩略图行为 | Figma 设计安全区建议 |
|---|---|---|---|---|
| Open Graph 通用基准 | 1200 × 630 px | 1.91 : 1 | 桌面与移动 Web 端最通用的标准比例,兼容 Facebook、LinkedIn、飞书 | 核心文字与头像收束在 中心 1008 × 470 px 内 |
| X (Twitter) 大图卡片 | 1200 × 628 px | 1.91 : 1 | summary_large_image 模式下会加上圆角边框,极窄屏幕可能轻微裁边 | 四周至少保留 64~96 px 内边距留白 |
| Slack / Discord / Telegram | 1200 × 630 px | 1.91 : 1 | 卡片左侧带彩色竖条,缩略图尺寸较小(尤其移动端压缩严重) | 正文主标题字号不小于 48~56 px,确保缩略图清晰可读 |
| 微信 / 公众号分享卡片 | 300 × 300 px 或 1200 × 630 px | 1:1 居中截取 | 微信会话卡片会从横图中强行居中裁切出正方形缩略图 | 若重点服务微信生态,核心图标与主视觉尽量靠画布水平居中 |
| 移动端双倍高清导出(静态兜底) | 2400 × 1260 px(@2x) | 1.91 : 1 | 部分静态官网首屏封面图会用于高分屏预览,但需控制体积 < 300 KB | 动态服务建议固定导出 1200 × 630(1x) 以缩短生图耗时 |
核心结论:所有动态 OG 模板在 Figma 中统一使用
1200 × 630 px画板,并在最外层锁定Padding: 64px(上下)×80px(左右) 的强制安全边界;除背景装饰外,任何标题、徽标、作者信息严禁越界贴边。更多画板尺寸规范可查阅 UI 设计规范与主流设备尺寸速查表。
二、实操一:在 Figma 中搭建 Satori 友好的 OG 模板组件 #
Satori 并不是完整的浏览器内核,它只实现了一套受限的 CSS Flexbox 布局子集。在 Figma 中制作需要自动化转译的 OG 卡片时,必须遵守以下四条硬性架构规约:
- 全链路使用纯 Flexbox 风格的 Auto Layout,严禁裸图层堆叠:
- 将根画板
OG_Template/Article设为1200 × 630 px,并开启垂直方向的 Auto Layout 自动布局(Vertical,Justify: Space between),内部拆分为Top_Meta_Bar(品牌 Logo + 分类徽标)、Center_Headline_Block(主标题 + 摘要)与Bottom_Author_Footer(作者头像 + 日期 + 域名)。 - 关键约束:Satori 要求所有包含多个子节点的容器必须显式拥有
display: flex,因此 Figma 中任何存在两个以上子元素的 Frame 都必须开启 Auto Layout,严禁使用普通的未编组容器或新版的二维Auto Layout Grid。若背景需要斜角装饰网格,请使用单个独立的Absolute position(Ignore auto layout)矢量容器统一承载。
- 将根画板
- 用 Variables 管理多主题与动态文本长度压测:
- 新建 Figma Variables 变量 集合
OG_Theme,包含Light与Dark(或Tech_Dark/Product_Brand)模式,将背景底色bg/canvas、主标题色text/primary、边框线border/subtle全部绑定为语义令牌,确保设计稿与 JSX 主题变量名 1:1 对齐。 - 长短文本极限压测:将主标题文本框设为
Fill container宽 +Hug contents高,同时为文本框开启Truncate text(文本截断省略号)并限制Max lines = 3。用 8 个字的极短标题与 36 个汉字的超长标题分别测试,确保标题换行后不会把底部Bottom_Author_Footer挤出630px画板外。
- 新建 Figma Variables 变量 集合
- 规避 Satori 不支持的视觉特效:
- 规范化字体字重与中英文标点:
- 动态生图服务器必须在冷启动或请求时加载字体二进制文件。Figma 中请选用明确支持开源分发且字重精简的字体(如 Noto Sans SC / 思源黑体 的
Regular 400与Bold 700两档,或 Inter 搭配思源黑体),避免在同一张卡片内混用 4 种以上字重导致后端加载超时。字体选型与商用授权细节详见 Figma 免费商用中文字体与 WOFF2 子集化实战。
- 动态生图服务器必须在冷启动或请求时加载字体二进制文件。Figma 中请选用明确支持开源分发且字重精简的字体(如 Noto Sans SC / 思源黑体 的
三、实操二:@vercel/og(Satori)零偏差代码与中文字体子集化交付 #
在 Dev Mode 开发模式 交付时,前端开发者最头疼的不是写 Flex 布局,而是中文字体文件太大(动辄 10~18MB)导致 Serverless / Edge 函数根本部署不上去。下面是一套经过生产环境验证的 Satori 对齐交付方案:
// app/api/og/route.tsx (Next.js App Router / Edge Runtime)
import { ImageResponse } from 'next/og';
export const runtime = 'edge';
// 核心技巧:按当前动态标题字符按需请求 Google Fonts 极简子集(仅数 KB)
async function loadGoogleFontSubset(font: string, text: string) {
const url = `https://fonts.googleapis.com/css2?family=${font}:wght@700&text=${encodeURIComponent(text)}`;
const css = await (await fetch(url)).text();
const resource = css.match(/src: url\((.+)\) format\('(opentype|truetype|woff2)'\)/);
if (resource) {
const response = await fetch(resource[1]);
if (response.status === 200) return await response.arrayBuffer();
}
throw new Error('Failed to load subset font');
}
export async function GET(request: Request) {
const { searchParams } = new URL(request.url);
const title = searchParams.get('title') || 'Figma 设计系统与自动化工程实战';
const tag = searchParams.get('tag') || '深度教程';
const siteName = 'Figmachina';
// 仅提取当前图片实际出现的全部字符,将 15MB 字体压缩至 ~25KB
const allText = `${title}${tag}${siteName}`;
const fontData = await loadGoogleFontSubset('Noto+Sans+SC', allText);
return new ImageResponse(
(
// 1:1 复刻 Figma 1200x630 外层 Auto Layout (Padding 64/80, Space-between)
<div
style={{
width: '1200px',
height: '630px',
display: 'flex',
flexDirection: 'column',
justifyContent: 'space-between',
padding: '64px 80px',
backgroundColor: '#0B0F19',
color: '#F8FAFC',
fontFamily: '"Noto Sans SC"',
position: 'relative',
}}
>
{/* Top_Meta_Bar:显式声明 display: flex */}
<div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between' }}>
<div style={{ display: 'flex', alignItems: 'center', gap: '14px' }}>
<div style={{ width: '36px', height: '36px', borderRadius: '8px', backgroundColor: '#3B82F6' }} />
<span style={{ fontSize: '28px', fontWeight: 700, letterSpacing: '-0.02em' }}>{siteName}</span>
</div>
<div
style={{
display: 'flex',
padding: '8px 20px',
borderRadius: '999px',
backgroundColor: 'rgba(59, 130, 246, 0.16)',
border: '1px solid rgba(59, 130, 246, 0.4)',
color: '#60A5FA',
fontSize: '22px',
}}
>
{tag}
</div>
</div>
{/* Center_Headline_Block:对齐 Figma Max lines=3 与 line-clamp */}
<div
style={{
// Satori 支持 -webkit-box + WebkitLineClamp 进行多行溢出截断
display: '-webkit-box',
fontSize: '60px',
fontWeight: 700,
lineHeight: 1.32,
letterSpacing: '-0.02em',
overflow: 'hidden',
textOverflow: 'ellipsis',
WebkitLineClamp: 3,
WebkitBoxOrient: 'vertical',
}}
>
{title}
</div>
{/* Bottom_Author_Footer */}
<div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', color: '#94A3B8', fontSize: '22px' }}>
<span>figmachina.com/articles</span>
<span>Figma 中文社区工程化指南</span>
</div>
</div>
),
{
width: 1200,
height: 630,
fonts: [{ name: 'Noto Sans SC', data: fontData, style: 'normal', weight: 700 }],
headers: {
// 强缓存 1 年,防止爬虫高频并发压垮 Edge 配额
'Cache-Control': 'public, max-age=31536000, immutable',
},
}
);
}
内网环境 / 稳定性兜底建议:若服务器位于无法直连 Google Fonts 的内网或国内云厂商环境,可将常用 3500 汉字的静态子集(
WOFF或TTF,注意 Satori 对WOFF2解压支持在部分旧版本中需额外转码,推荐直接提供.ttf或.otf/.woff格式)预裁切后托管至同域 CDN 或对象存储;亦可结合 Figma REST API 自动化流水线 在构建期预生成静态 PNG,彻底消除运行时生图延迟。
四、Figma 动态 OG Image 交付与渲染高频故障排查表 #
当动态分享图在微信、X 或 Vercel Edge 上出现空白、报错或排版错位时,可参照下表快速定位修复(更多通用排查参见 Figma 常见报错与疑难故障诊断手册):
| 异常现象 | 底层成因剖析 | 标准化解决步骤 |
|---|---|---|
Vercel / Cloudflare 部署报错 Function size exceeds limit 或超时 | 直接在代码仓库里打包了完整的 15MB 思源黑体 / 微软雅黑文件 | 严禁全量打入中文字体;改用 Google Fonts ?text= 动态按字抓取,或用 fonttools 仅保留常用 3500 字生成 < 1.2 MB 的 .ttf 子集放 CDN 按需拉取 |
接口直接报错 Expected <div> to have explicit "display: flex" | Figma 设计稿中有普通 Frame 或 Group 未开启 Auto Layout,前端转译时漏写了 display: flex | 遵循“多子节点必开 Auto Layout”原则;JSX 中任何包含 2 个及以上子元素的 <div> 必须显式写 display: 'flex' |
| Figma 里的毛玻璃弹窗、径向渐变光斑在生成的 PNG 里完全消失 | Satori 暂不完整支持 CSS backdrop-filter、部分复杂 SVG <filter> 模糊及高阶渐变语法 | 在 Figma 中将底图光晕与噪点装饰单独烘焙导出为一张 1200×630 低体积 WebP/PNG 背景图,或改用简单的 linear-gradient 叠加 |
中文全部显示为空白方框 □ 或英文正常但中文回退成丑陋系统字 | fonts 配置里只传入了 Inter 等拉丁字体,或者字体文件名与 CSS fontFamily 大小写不匹配;部分环境不识别 .woff2 | 确保 fonts 数组包含中文字体且传入的是 .ttf / .otf / .woff Buffer;style.fontFamily 名称必须与 fonts[i].name 完全一致 |
| 网页改了新标题,但微信/X 分享出去依然显示旧的分享图 | 社交平台抓取器会对同一个 URL 的 og:image 长期强缓存 | 为动态图片 URL 拼接内容版本号或哈希参数(如 /api/og?title=...&v=20261122),并在每次文章更新时刷新 URL 查询串 |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。