UI 视觉设计 / 系统课时
规范图标和图片的资产交付
规范图标和图片的资产交付
本篇将 Figma 里的图标、照片和插画整理为开发可直接使用的资产:明确哪些内容应导出、怎样设置 SVG 和位图规格、文件由谁维护,以及交付前如何拦截截图切图与重复资源。
学习目标
- 区分应交付的独立资产与必须由组件实现的界面。
- 按画板尺寸、导出倍率和格式检查 SVG 与位图。
- 约定文件命名、仓库归属及重复文件的验收规则。
先判断哪些内容应该成为资产
不要看到视觉元素就切图。以一个含搜索按钮、商品照片和状态提示的页面为例,按内容是否需要响应状态、文本或布局变化来决定交付形式。
| 画面内容 | 交付方式 | 验收重点 |
|---|---|---|
| 搜索、关闭等单色图标 | 独立 SVG | 统一 24×24 逻辑画板,可缩放 |
| 商品照片、实拍背景 | JPG 位图 | 按实际展示尺寸提供足够像素 |
| 需要透明背景的复杂插画 | PNG,适合时使用 SVG | 边缘和透明区域正确 |
| 按钮、卡片、弹窗、文字 | 代码组件与设计令牌 | 不允许整块导出 PNG |
| 整页截图 | 仅供评审比对 | 不进入生产资产目录 |
例如,按钮的背景色、圆角和标题应由组件与 Token 实现,只交付其中无法用基础图形表达的图标。把整个按钮导出成图片,会导致文案无法本地化、禁用状态无法复用。
在 Figma 中导出正确的尺寸和格式
以 Figma Design 的 Design 模式为准,建议先建立统一的图标外框,再导出组件主节点,不要单独选择内部路径,否则不同图标容易出现可点击区域和视觉居中偏差。
- 将搜索图标放入 24×24 的 Frame,图形留出一致的安全边距,单色线性图标采用约 2 px 的设计笔画规格;检查实际路径没有超出画板。
- 选中该 Frame,在右侧栏底部找到 Export → +,格式选 SVG,保持默认 1x 后导出。Figma 的 SVG 导出仅支持 1x;缩放交给使用端。
- 为展示尺寸为 320×180 CSS 像素的横幅设置同尺寸 Frame;选择 JPG、2x 导出,得到 640×360 像素。若素材有透明背景,改用 PNG、2x;需要 3x 时对应 960×540 像素。
- 在 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;组件包只引用资源,不复制整套照片。 - 交付记录:每个资源至少登记源文件位置、使用场景、设计负责人、代码维护者、文件格式、像素或画板尺寸以及授权状态。改图标时先更新源组件,再替换同名交付物。

用交付检查阻止错误文件进入组件包
在仓库根目录建立 scripts/check-assets.mjs,使用 Node.js 18 或更新版本运行 node scripts/check-assets.mjs。先确保上述两个资产目录存在;路径不同的项目应修改 roots。下面的完整脚本同时检查命名、格式归属和 SHA-256 完全重复内容。
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} 个资产,未发现重复`);
}预期输出(两个目录合计仅有两份命名合规、字节内容不同的资产时):
检查通过:2 个资产,未发现重复发现错误时,脚本会打印文件路径并以非零退出码结束,可接入 CI 拦截合并。哈希仅能找出字节完全相同的文件,无法识别重新压缩、裁切后的相似图片;审查时还要核对缩略图、源文件和授权记录。验收一批资源的最低标准是:SVG 画板一致、位图像素符合倍率、文件名合规、归属唯一,而且没有把整块可交互界面切成图片。