Figma 动态 OG Image(Open Graph 社交分享卡片)模板架构与 Satori / @vercel/og 自动化生图实战:1200×630 安全区、Auto Layout Flexbox 对齐与中文字体子集优化

2026 年 11 月 22 日

当用户将你的产品文档、博客文章或 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 卡片时,必须遵守以下四条硬性架构规约:

  1. 全链路使用纯 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)矢量容器统一承载。
  2. 用 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 画板外。
  3. 规避 Satori 不支持的视觉特效:
    • Satori 不支持复杂的 Figma Background Blur(毛玻璃)、多停点 Angular / Diamond 角度/菱形渐变、Drop Shadow 的多重混合模式以及复杂嵌套布尔蒙版。
    • 若需要微弱的光晕氛围底图或弥散圆斑,请将其合并导出为一张极轻量的静态背景图或简化 SVG,避免指望 Satori 实时计算复杂高斯模糊。关于特效兼容性可参考 图层效果 与 图层填充。
  4. 规范化字体字重与中英文标点:
    • 动态生图服务器必须在冷启动或请求时加载字体二进制文件。Figma 中请选用明确支持开源分发且字重精简的字体(如 Noto Sans SC / 思源黑体 的 Regular 400 与 Bold 700 两档,或 Inter 搭配思源黑体),避免在同一张卡片内混用 4 种以上字重导致后端加载超时。字体选型与商用授权细节详见 Figma 免费商用中文字体与 WOFF2 子集化实战。

三、实操二:@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)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。