2年搭建设计系统，上线后发现按钮圆角全变了：一个独立设计师的复盘

2021年中，我的Figma库里已经塞满了47种组件变体。数据表格、金融图表、投资人卡片布局——该有的都有了。文档写得详尽，每个padding值背后都有设计理由。

上个月，我对照生产环境的真实界面，发现按钮圆角对不上，表单标签的灰色偏差了几个色阶，该16px的间距成了14px。没有哪处是灾难性的，但凑在一起，产品就是不够"整"。

系统很完整，交付很零散。两件事同时成立。

从0到1的兴奋，掩盖不了从1到100的失速

2019年底加入VALK时，这里连设计团队都没有。从零开始听起来很爽——不用继承别人的烂摊子，每个决策都是自己的。

2020年中，组件库跑起来了。年底，文档补全。2021年中，覆盖几乎所有UI模式。我当时确实挺得意。

但代码和组件的分裂是静悄悄的。没有某个崩溃的早晨，只有无数个"差不多就行"的下午。前端工程师没读文档，不是因为他懒，是因为文档在Figma里，而他写代码时在编辑器、在代码库、在看已经存在的组件。那是他的参考系，不是我的。

我后来意识到一个尴尬的事实：设计系统在我手里是系统，在他手里是建议。

文档的悖论：写得越细，越没人看

我在Krasnaya Polyana的山间小屋里写这篇文章。租来的房子很安静，适合想事情。本来说是来清空脑袋的，结果每天打开Figma，盯着那个gap发呆——系统说该这样，上线的是那样。

我花了真功夫写文档。不是罗列参数，是解释为什么主按钮用那个padding，为什么选这个蓝而不是旁边那个看起来差不多的。设计决策的上下文。

但文档的读者只有我自己。前端工程师没读过大部分，这不是批评，是观察。他干活快，质量也不错，只是他的工作流里没有"打开Figma读设计文档"这个环节。代码库里已有的组件，才是他复制粘贴的起点。

我试过把规范同步到代码侧，但我是唯一的设计师，没有专门的DesignOps人手。每次迭代，Figma更新在先，代码追赶在后，缝隙就这么产生了。

单人团队的结构性困境

很多设计系统的文章假设你有团队。专人维护文档，专人做DesignOps，专人跟前端对齐token。我读到这些时会觉得，嗯，道理都对，但我的现实是：一个人画界面，一个人写规范，一个人追落地。

这不是抱怨，是复盘的前提。小团队做设计系统，得接受某些"最佳实践"根本够不着。我的策略后来变了：不再追求Figma和代码的像素级同步，而是抓最关键的变量——颜色、字体、间距阶梯。其他的，允许一定漂移。

这个妥协让我不舒服，但比假装系统完美运行要诚实。

回头看那两个按钮圆角的差异，14px和16px，用户根本不会注意到。我注意到，是因为我建了那个系统。这种敏感度是设计师的职业病，也是负担。

你现在维护的设计系统，有多少组件是"理论上存在"而"实际上没人用"的？