UI 视觉设计 / 系统课时

规范图标和图片的资产交付

规范图标和图片的资产交付

本篇将 Figma 里的图标、照片和插画整理为开发可直接使用的资产:明确哪些内容应导出、怎样设置 SVG 和位图规格、文件由谁维护,以及交付前如何拦截截图切图与重复资源。

学习目标

  • 区分应交付的独立资产与必须由组件实现的界面。
  • 按画板尺寸、导出倍率和格式检查 SVG 与位图。
  • 约定文件命名、仓库归属及重复文件的验收规则。

先判断哪些内容应该成为资产

不要看到视觉元素就切图。以一个含搜索按钮、商品照片和状态提示的页面为例,按内容是否需要响应状态、文本或布局变化来决定交付形式。

画面内容 交付方式 验收重点
搜索、关闭等单色图标 独立 SVG 统一 24×24 逻辑画板,可缩放
商品照片、实拍背景 JPG 位图 按实际展示尺寸提供足够像素
需要透明背景的复杂插画 PNG,适合时使用 SVG 边缘和透明区域正确
按钮、卡片、弹窗、文字 代码组件与设计令牌 不允许整块导出 PNG
整页截图 仅供评审比对 不进入生产资产目录

例如,按钮的背景色、圆角和标题应由组件与 Token 实现,只交付其中无法用基础图形表达的图标。把整个按钮导出成图片,会导致文案无法本地化、禁用状态无法复用。

在 Figma 中导出正确的尺寸和格式

以 Figma Design 的 Design 模式为准,建议先建立统一的图标外框,再导出组件主节点,不要单独选择内部路径,否则不同图标容易出现可点击区域和视觉居中偏差。

  1. 将搜索图标放入 24×24 的 Frame,图形留出一致的安全边距,单色线性图标采用约 2 px 的设计笔画规格;检查实际路径没有超出画板。
  2. 选中该 Frame,在右侧栏底部找到 Export → +,格式选 SVG,保持默认 1x 后导出。Figma 的 SVG 导出仅支持 1x;缩放交给使用端。
  3. 为展示尺寸为 320×180 CSS 像素的横幅设置同尺寸 Frame;选择 JPG、2x 导出,得到 640×360 像素。若素材有透明背景,改用 PNG、2x;需要 3x 时对应 960×540 像素。
  4. 在 Export → Preview 检查是否多出了背景、阴影或被裁切的元素,再查看导出文件的实际像素。面向常规 Web 交付可在导出设置里选择 sRGB,以免不同色域出现非预期差异。

SVG 应检查 viewBox 与画板一致,并确认没有意外嵌入的位图、外部引用或多余图层。Figma 可能把描边导出为填充路径,因此不要假设 SVG 文件仍保留原始 stroke 属性。Figma Design 的直接导出格式不含 WebP;如项目要求 WebP,应在后续图片处理环节转换,而不是让设计师截图替代。

统一命名并划清资源所有权

文件名用小写英文、数字和短横线,表达语义用途而不是画面位置。统一使用 icon-search.svg、icon-close.svg、img-help-hero-2x.jpg,避免 图标最终版2.svg、Frame 176.png。2x 只用于位图倍率,SVG 不添加该后缀;不要把构建系统生成的哈希写进设计源名称。

约定两条可追溯的交付路径:

  • 共享图标:Figma 组件库是设计源,设计系统维护者审批;代码唯一归属为 packages/ui/assets/icons/,只接收经过核对的 SVG。
  • 业务图片:原始摄影或插画文件由业务团队管理,交付到 apps/web/public/images/ 或业务 CDN;组件包只引用资源,不复制整套照片。
  • 交付记录:每个资源至少登记源文件位置、使用场景、设计负责人、代码维护者、文件格式、像素或画板尺寸以及授权状态。改图标时先更新源组件,再替换同名交付物。

Figma 资产审核与代码归属分流图

用交付检查阻止错误文件进入组件包

在仓库根目录建立 scripts/check-assets.mjs,使用 Node.js 18 或更新版本运行 node scripts/check-assets.mjs。先确保上述两个资产目录存在;路径不同的项目应修改 roots。下面的完整脚本同时检查命名、格式归属和 SHA-256 完全重复内容。

js
import { createHash } from 'node:crypto';
import { readdirSync, readFileSync } from 'node:fs';
import { basename, join } from 'node:path';

// 共享组件包只收图标,业务目录才接收位图。
const roots = [
  { dir: 'packages/ui/assets/icons', pattern: /^icon-[a-z0-9-]+\.svg$/ },
  { dir: 'apps/web/public/images', pattern: /^img-[a-z0-9-]+\.(png|jpe?g|webp)$/ }
];

function walk(dir) {
  return readdirSync(dir, { withFileTypes: true }).flatMap(entry => {
    const path = join(dir, entry.name);
    return entry.isDirectory() ? walk(path) : entry.isFile() ? [path] : [];
  });
}

const seen = new Map();
const errors = [];
let count = 0;
for (const { dir, pattern } of roots) {
  for (const path of walk(dir)) {
    count++;
    if (!pattern.test(basename(path))) errors.push(`命名或格式错误:${path}`);
    // 按文件内容去重,防止改名后重复进入不同目录。
    const hash = createHash('sha256').update(readFileSync(path)).digest('hex');
    if (seen.has(hash)) errors.push(`重复文件:${seen.get(hash)} 与 ${path}`);
    else seen.set(hash, path);
  }
}
if (errors.length) {
  errors.forEach(error => console.error(error));
  process.exitCode = 1;
} else {
  console.log(`检查通过:${count} 个资产,未发现重复`);
}

预期输出(两个目录合计仅有两份命名合规、字节内容不同的资产时):

text
检查通过:2 个资产,未发现重复

发现错误时,脚本会打印文件路径并以非零退出码结束,可接入 CI 拦截合并。哈希仅能找出字节完全相同的文件,无法识别重新压缩、裁切后的相似图片;审查时还要核对缩略图、源文件和授权记录。验收一批资源的最低标准是:SVG 画板一致、位图像素符合倍率、文件名合规、归属唯一,而且没有把整块可交互界面切成图片。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

规范图标和图片的资产交付

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通