
我们团队去年做中台重构时,遇到过一个典型问题:同一个主色蓝,在前端代码里搜出了 7 个不同的十六进制色值,从 `#1677FF` 到 `#1890FF` 各自为政。设计师本地的 Figma 存着 `V2.1_最终版`,而研发跑去拿了上个月的旧设计稿切图。这种资产散落不是因为大家偷懒,而是因为设计与研发之间没有建立一套统一的规则和闭环管道。
根据相关行业调研数据,在没有建立标准化设计资产库的团队中,UI 设计师与前端工程师在样式还原、重命名和查找切图上消耗的无效工时,往往占到日常协同的 30% 以上。要解决资产散落,关键在于把分散在网盘、聊天记录和本地草稿中的素材,收拢到一条统一的管线中。
明确单一真实源与资产层级
很多团队管理混乱,根源在于没分清谁才是权威。所有视觉样式的单一真实源(SSOT)必须且只能在设计端,而所有功能交互与渲染的单一真实源必须在前端代码库。
为了让双方说话在一个频道上,必须把设计资产抽象成三个层级的 Design Tokens:
1.全局基础 Token(Global Tokens):定义基础色板、阶梯字号、固定间距。比如 `blue-500: #1677FF`、`spacing-4: 16px`。这个层级不包含任何业务语意,只记录具体数值。
2.语意层 Token(Semantic Tokens):建立业务逻辑映射。比如定义 `color-primary: {blue-500}`、`color-background-page: {gray-50}`。这样做更好,因为当产品需要支持深色模式或品牌换色时,研发只需要切换语意层映射,不需要改动一行业务代码。
3.组件层 Token(Component Tokens):直接绑定具体组件属性。比如 `btn-primary-bg: {color-primary}`。
操作避坑提示:绝对不要跳过语意层,直接让研发把组件样式绑定在全局数值上。一旦跳过语意层,后期做多主题切换或者局部改版时,全局修改会引发大面积样式错乱。
设计与研发协同资产流转实操
建立资产库不是写完文档就封板,它必须是一条自动流转的管道。我们目前验证下来最高效的流转方式分为四个具体步骤:
•先做 A:在设计工具中结构化定义资产。
UI 设计师在 Figma 中建立专用的 Design System 文件,使用 Local Variables 或 Tokens Studio 插件统一管理色板、间距与圆角。所有组件按 `Category / Component / Variant / State` 规范命名(例如 `Button/Primary/Medium/Hover`)。
•然后做 B:将设计变量导出为结构化 JSON。
设计师完成样式审查后,通过 Tokens Studio 或自研插件,直接把样式参数一键推送到指定的 Git 仓库(如 GitHub 或 GitLab),生成标准的 `tokens.json`。这个步骤切断了人工截图和标注的不确定性。
•接着做 C:研发端自动化编译转换。
研发在代码仓库配置 GitHub Actions,只要检测到 `tokens.json` 发生更新,立刻调用开源工具 Style Dictionary 进行自动转换。脚本会把同一份 JSON 分别编译成前端需要的 CSS 变量文件(`variables.css`)、SCSS 变量集,以及移动端需要的 Swift 或 Android XML 资源。
•最后做 D:组件库消费与文档同步。
前端组件库(如基于 React 或 Vue 搭建的私有组件库)重新引入编译好的变量,自动部署并推送到 Storybook 文档站。研发和 UI 打开同一个 Storybook 链接,就能即时看到组件的最新状态。
主流协同方案与工具选型对比
不同规模的团队,资源投入和技术储备差异很大。我们在选型时做过系统评估,主流方案的参数与特点如下表所示:
| 方案类别 | 推荐工具组合 | 资产同步机制 | 适用团队阶段 | 维护成本 | 核心优缺点对比 |
|---|---|---|---|---|---|
| 全链路工程化方案 | Figma + Tokens Studio + Style Dictionary + Storybook | Git 触发,CI/CD 自动化编译输出多端变量 | 研发实力较强、产品形态多端且长期迭代的团队 | 前期搭建成本高,后期维护极低 | 优点:跨端一致性最高,杜绝手动修改; 缺点:需要前端工程化支持,前期配置繁琐。 |
| SaaS 一体化文档方案 | Figma + Supernova 或 Zeroheight | 通过 SaaS 平台的官方插件或 Webhook 同步 | 追求快速落地、缺乏专职前端基建的中型团队 | 中等,依赖第三方服务订阅费 | 优点:开箱即用,文档展示直观; 缺点:国内网络访问稳定性受限,高阶自动化定制能力较弱。 |
| 轻量级文件归档方案 | Eagle / 语雀 / 蓝湖 + 本地 NAS | 人工打包导出,定期归档与版本标记 | 初创团队、外包项目或仅有单端产品的业务 | 前期极低,后期协作损耗高 | 优点:无需代码介入,上手零门槛; 缺点:资产更新滞后,研发与设计极易脱节,无法防范硬编码。 |
图标与矢量资产的规范化沉淀
除了颜色和文字,散落最严重的是各类 SVG 图标和插画切图。有的设计师导出的 SVG 带着无用图层,有的带着固定的 `fill` 颜色,前端拿过去改不了颜色只能重新找设计师返工。
处理图标资产时,必须执行以下三项标准操作:
1.统一画板与基准网格:
所有系统级图标必须画在固定的网格内(比如 24x24px 或 16x16px)。图形内部四周保留 2px 的安全边距,确保不同图标在视觉重心上保持平衡。
2.清理冗余矢量代码:
在把 SVG 交接给研发前,必须去除描摹工具残留的无效标签和属性(例如 `sketch:type`、空群组 “)。所有需要支持跟随父级文字变色的单色图标,必须把路径内的 `fill` 属性统一替换为 `fill=”currentColor”`。
3.建立图标包自动化流水线:
先建一个专门存放图标的 Git 仓库(如 `design-icons`)。设计师只需把命名规范的 SVG 丢进仓库的指定目录,研发配置 `@svgr/cli` 脚本,几秒钟就能把几十个 SVG 打包成标准的 React/Vue 图标组件,并自动发布为内部 npm 包。前端开发者在页面中只需要写 “ 即可调用,完全不需要在聊天软件里传文件。
设计资产库的版本控制与治理流程
资产库建好后,最怕“只建不管”,三个月后又退化成垃圾场。为了保障资产库的健康运转,必须建立清晰的版本演进机制。
我们团队严格执行语义化版本规则(Semantic Versioning):
•修订版本(Patch,如 1.0.1):微调某个色值的明度,微调某个图标的曲线,对研发完全向后兼容,不需要额外对齐。
•次版本(Minor,如 1.1.0):新增了 5 个表单组件,或者新增了一套语意 Token,向后兼容。
•主版本(Major,如 2.0.0):重构了全局色彩体系或删除了旧组件,这种破坏性变更(Breaking Change)必须经过设计和研发负责人的联合评审,严禁单方面直接发布。
而且,每一次 Figma 资产库发布组件更新,更新日志里必须附带对应的 PR 链接和修改范围说明。每周排期时留出 30 分钟由一名 UI 和一名研发代表共同走查未沉淀的临时组件。如果一个业务组件在多个业务线被复制超过 3 次,就必须抽离规范,沉淀进全局资产库。
把规范变成自动化流程,比依赖个人的自觉性可靠得多。通过明确单一源头、打通 Token 自动转换管道、以及用版本规则约束迭代,散落的创意资产就能稳定转化为研发和设计共同的高效资产。
原创文章,作者:七点互动,如若转载,请注明出处:https://ai.qidianhudong.com/aikonw/4560.html