UI 视觉设计 / 系统课时

导出规范 SVG 资源

导出规范 SVG 资源

SVG 交付的目标不是“设计工具里看起来正常”,而是让开发拿到后可以直接复用、换色、缩放和审查。本节从路径、描边、viewBox、命名和冗余数据入手,整理一套可验证的导出规则,避免资源在组件化后出现尺寸漂移或主题色失效。

学习目标

  • 建立适合开发接入的 SVG 文件契约,明确尺寸、颜色和命名边界。
  • 清理会影响缩放、换色或维护的路径、描边与编辑器冗余数据。
  • 使用脚本在交付前检查 viewBox、固定尺寸、硬编码颜色和文件名。

先固定开发侧资源契约

导出前先约定“资源由谁控制尺寸和颜色”。如果图标会进入前端组件库,通常让组件控制外部尺寸,让 SVG 只保留稳定坐标系;颜色则优先使用 currentColor,使图标跟随文本色或设计令牌,而不是把品牌色写死在路径中。

常见的 24 像素图标可以统一采用 viewBox="0 0 24 24"。若团队约定由 CSS 或组件属性控制大小,源文件不再写固定 width、height。文件名使用小写短横线,例如 icon-search.svg,不要混用空格、中文、下划线和版本尾缀。

清理路径、描边和颜色

导出后重点检查几何是否仍符合规范。描边图标需要统一 stroke-width、端点和转角规则;不要因为轮廓化操作把本来可维护的描边全部变成复杂填充路径。只有在跨工具兼容或字体轮廓等明确场景下,才把描边转路径。

颜色也要区分“语义颜色”与“资源固有颜色”。普通单色功能图标适合使用 currentColor;多色品牌标识、插画或状态图形则不应机械替换。若同一文件同时出现多个接近但不同的硬编码色值,通常意味着导出前还没有完成样式归一。

校验视图框和冗余数据

viewBox 应覆盖完整图形,同时保留设计规范要求的安全边距。路径若超出视图框,运行时会被裁切;视图框过大则会让视觉主体显得偏小。还要检查是否遗留编辑器专用命名空间、无用分组、空的 defs、不可见图层或重复变换。

对于交付给组件库的纯资源文件,通常无需携带设计工具的图层名称和内部 ID。若某些 id 被渐变、蒙版、裁剪路径或 use 引用,则必须保留并保证唯一,不能为了“文件更干净”直接删除。

用脚本做交付前检查

下面的命令会创建一个可复用的 24 像素搜索图标,并用 Node.js 检查四项交付规则:文件名、viewBox、是否存在固定宽高、是否出现硬编码颜色。示例只依赖 Node.js 内置模块。

bash
# 源资源只保留稳定坐标系和可继承的主题色。
cat > icon-search.svg <<'SVG'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none">
  <circle cx="11" cy="11" r="6.5"
          stroke="currentColor" stroke-width="2" />
  <path d="M16 16L21 21"
        stroke="currentColor" stroke-width="2" stroke-linecap="round" />
</svg>
SVG

# 校验脚本把可自动判断的交付规则固定下来。
cat > validate-svg.mjs <<'JS'
import { readFileSync } from 'node:fs';
import { basename } from 'node:path';

const file = process.argv[2];
if (!file) throw new Error('usage: node validate-svg.mjs <file.svg>');

const svg = readFileSync(file, 'utf8');
const checks = [
  ['filename', /^[a-z0-9]+(?:-[a-z0-9]+)*\.svg$/.test(basename(file))],
  ['viewBox', /viewBox="0 0 24 24"/.test(svg)],
  ['flexible-size', !/<svg[^>]*\b(?:width|height)=/i.test(svg)],
  ['theme-color', /(?:stroke|fill)="currentColor"/.test(svg) &&
    !/(?:#[0-9a-f]{3,8}\b|rgb\()/i.test(svg)]
];

const failed = checks.filter(([, ok]) => !ok).map(([name]) => name);
if (failed.length) {
  console.error(`FAIL ${file}: ${failed.join(', ')}`);
  process.exit(1);
}

console.log(`OK ${file}: viewBox=24, flexible-size, theme-color`);
JS

# 在交付目录执行检查,失败时以非零状态码退出。
node validate-svg.mjs icon-search.svg

预期输出

text
OK icon-search.svg: viewBox=24, flexible-size, theme-color

这类脚本适合放进资源仓库的提交检查中,但它只能验证约定明确的静态规则,不能替代视觉审查。例如光学居中、曲线是否变形、描边是否在不同缩放下显得过重,仍要回到真实组件尺寸中确认。

交付时保留可追溯性

最终资源应做到“一图标一文件、一名称一语义”。如果同一个含义存在线性版、填充版或不同尺寸专版,用团队约定的后缀区分,并在设计系统中记录对应关系。不要把 final、new、v2 这类临时状态写进长期文件名。

交付完成后,用开发侧实际加载方式打开 SVG,检查缩放、主题色和边界是否符合预期。只要源文件的坐标系、颜色控制权和命名稳定,后续无论封装成 React、Vue 组件还是图标包,都能减少二次清理和视觉偏差。

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

目录与阅读设置

记录一个想法

导出规范 SVG 资源

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

登录哪都通