AB
AiBoss
チュートリアル

Deco

チュートリアル

用 Deco 把设计稿一键生成多端前端代码

Deco 能把设计稿解析成可复用的组件化前端代码,并针对 Web、H5、小程序等不同终端分别输出。本文按准备设计稿、导入、配置生成规则、生成与预览、下载接入、迭代维护的顺序,讲清每一步该做什么、设计稿要满足哪些规范,以及生成代码在业务逻辑、接口对接与性能优化上仍需人工补齐的部分。

Deco 是一款把设计稿转换成前端代码的智能开发工具,核心能力是解析设计稿的页面层级、布局方式、组件边界和文本图片资源,再按目标终端输出可维护的组件化代码。它面向的是前端工程师与设计团队协作的场景:设计稿改版频繁、同一套界面要同时落到 Web、H5、小程序或 App 等多个终端时,切图与像素还原这类重复劳动可以被大幅压缩,工程师能把精力放在业务逻辑和性能优化上。它适合电商活动页这类高频改版的页面、需要多端统一 UI 的项目,以及希望把设计规范沉淀成组件库的团队。如果你只是想先了解这类工具在站内的定位,可以看 Deco 这一条目。

需要先说明一点:Deco 生成的是结构与样式高度还原的代码骨架,不是可以直接上线的完整业务代码。接口调用、状态管理、交互逻辑、性能优化仍然要由工程师补齐。把这一点放在最前面,是因为它决定了后面所有步骤的重心——你的目标不是「一键出成品」,而是「一键出一个结构干净、能接着往下写的起点」。

准备工作

账号与访问方式

使用前需要一个 Deco 账号,通过官网或客户端登录后进入项目界面。具体可用的登录方式、是否区分团队空间、各套餐的功能与配额,以官网当前信息为准,本文不列举具体数字。

设计稿的整理

这一步的投入直接决定生成质量,值得在导入之前花时间。Deco 支持的设计工具与文件格式以其官网说明为准,主流设计工具通常在覆盖范围内,使用前建议先确认最新支持列表,并按推荐方式导出或整理设计稿。整理时按以下几条来做:

  • 图层与组件命名清晰统一:避免出现大量「矩形 12」「编组 5」这类自动命名,语义化的名字会直接影响生成代码里的类名与组件名。
  • 合理分组、划分组件边界:把可复用的部分(按钮、卡片、导航栏、列表项)单独做成组件,不要把所有元素平铺在一个画板里,也不要过度嵌套导致层级过深。
  • 统一使用样式与色板:颜色、字号、行高、间距尽量引用设计工具里的共享样式或变量,而不是每个元素手填一个近似值。散落的硬编码值会让生成的样式表变得零碎。
  • 按项目规范整理尺寸与栅格:明确页面宽度、栅格列数与间距体系,多端项目还要提前想好各端的适配策略。
  • 在设计阶段就考虑响应式与多端适配:哪些区块在窄屏下折叠、哪些元素在小程序里要换形态,最好在设计稿里就有对应表达,而不是等生成完再改。

明确目标端与技术栈

导入之前先想清楚两件事:这套页面要落到哪些终端(Web、H5、小程序、App 等),以及项目使用什么技术栈(例如 React、Vue,或团队内部的前端框架、特定小程序框架)。Deco 的多技术栈支持范围视产品实际配置而定,可选项以你登录后看到的界面为准。提前定好这两项,可以避免生成完再返工。

操作步骤

第一步:导入设计稿

登录后新建项目,在新建流程中选择设计工具来源,或直接上传设计文件。接着选择需要转换的页面或画板,确认导入范围。如果设计文件里包含多个页面,建议一次只导入本次要处理的那几个画板,范围越小,解析结果越容易核对。

导入时还要确认资源是否被正确带入,包括图片、图标、插画等。位图资源通常会被一并提取,矢量图标能否转成代码或组件取决于工具的支持情况,导入后在预览里检查一遍更稳妥。

第二步:配置生成规则

导入完成后进入生成配置,这一层决定了输出代码的形态。需要设置的项包括:

  • 目标端:选择 Web、H5、小程序或其他终端。同一套设计稿可以针对不同终端分别生成,这是 Deco 多端能力的入口。
  • 技术栈模板:选择现成模板,或创建符合团队规范的模板,例如 React、Vue 或企业内部框架。
  • 样式方案:CSS、预处理器(Less、Sass)或 CSS in JS,按项目现有工程约定来选,不要为了省事选一个和项目不一致的方案,否则接入时还要整体改写。
  • 高级选项:组件拆分策略、命名规范、文件目录结构。这几项对后续可维护性影响最大,团队有既有规范时应在这里对齐。

如果团队长期使用同一套规范,把这些配置固化成模板,后续项目直接复用,能明显减少每次的调整成本。

第三步:生成代码并预览

点击生成后等待系统解析设计稿。解析完成后进入预览界面,重点核对三样东西:页面结构是否符合预期、组件树划分是否合理、样式信息是否与设计稿一致。

发现偏差时有两种处理路径:回到设计稿微调后重新导入生成,或者在 Deco 里调整部分配置再生成。经验上,布局错位、组件被错误合并这类问题多半源于设计稿本身的结构问题,改设计稿比反复调配置更有效;而命名风格、目录结构这类问题则适合在配置层解决。

第四步:下载代码并接入项目

生成完成后可以下载代码包,或同步到代码仓库(例如 Git 仓库)。同步到仓库的方式更适合团队协作,便于走正常的代码评审流程。

拿到代码后在本地安装依赖、运行项目,先确认页面能正常渲染,再逐块检查样式还原度与响应式表现。之后才是真正的接入工作:把生成的组件挂到现有路由上,接上接口调用与状态管理,替换掉占位数据,补齐交互逻辑。

第五步:迭代与维护

设计稿更新后,重新导入并生成即可。可以选择增量或全量生成:增量适合局部改动,全量适合整体重构。由于输出是组件化的,多端 UI 的一致性主要靠「同一份设计稿 + 同一套生成规则」来保证,而不是靠人工比对。

每次迭代后建议回看生成规则是否需要调整。比如发现某类卡片总是被拆得过细,就在组件拆分策略里加一条规则;发现类名风格和项目不一致,就改命名规范。规则调得越贴合项目,后续自动化程度越高。

一个完整示例

下面以一个电商活动页为例,走一遍从设计稿到可运行页面的最小流程。示例中的配置项名称以实际界面为准,这里描述的是操作顺序与判断依据。

场景设定

需求是一个促销落地页,包含顶部横幅、商品卡片列表、倒计时区块和底部按钮。页面要同时用于 Web 端和 H5 端,项目技术栈为 Vue,样式使用 Sass。

设计稿整理

在 Figma 中完成设计后,先做一轮清理:把横幅、商品卡片、倒计时、底部按钮分别建为组件;商品卡片做成可复用的主组件,列表里用实例;颜色统一引用色板,字号与间距引用文本样式和间距变量;图层名改成 banner、product-card、countdown、cta-button 这类语义化名称。再单独确认窄屏下的布局:商品列表从四列变两列,横幅高度压缩。

导入与配置

登录 Deco,新建项目,选择 Figma 作为来源,导入该活动页画板,确认图片资源已带入。在生成配置中:目标端先选 Web,技术栈选 Vue 模板,样式方案选 Sass,组件拆分策略设为按设计稿组件边界拆分,命名规范沿用项目的短横线风格,目录结构按 pages 与 components 分层。

生成与核对

点击生成,在预览中检查组件树:横幅、商品卡片、倒计时、按钮应当是四个平级组件,商品列表内部引用卡片组件而不是复制四份。若发现卡片被展开成独立元素,说明设计稿里用的是复制而非实例,回到设计稿改成实例后重新生成。

下载与运行

下载代码包,解压后放入项目目录,安装依赖并启动开发服务器。此时页面应能渲染出静态结构。接着做三件事:把商品数据从写死的占位内容换成接口请求,把倒计时的静态文本换成计时逻辑,把底部按钮的点击接到下单流程。最后在窄屏下验证两列布局是否生效。

生成 H5 版本

回到 Deco,用同一份设计稿新建一次生成任务,目标端改为 H5,其余配置保持一致。生成后对比两版代码的组件结构,确认差异只出现在适配相关的样式上,而不是组件划分本身。这样后续设计稿改版时,两端可以同步重新生成,UI 不会走样。

注意事项

生成代码不等于可上线代码

Deco 输出的是结构与样式还原度较高的前端代码骨架,业务逻辑、接口调用、性能优化仍需工程师补充。简单展示页在少量调整后可以较快上线,但带交互和数据的功能页必须经过完整开发与测试。不要因为「一键生成」就跳过代码评审。

设计稿规范决定生成质量

图层命名混乱、样式硬编码、组件边界不清、层级过度嵌套,都会直接拉低解析准确度。与其在生成后反复修补,不如在导入前把设计稿整理到位。这是整个流程里投入产出比最高的一步。

支持范围以官网为准

支持的设计工具与文件格式、可选的终端类型与数量、多技术栈的具体清单,都会随产品迭代变化,使用前请查看官网当前信息,不要依据旧资料做技术选型。

样式方案要与项目一致

生成时选的样式方案如果和项目现有工程约定不符,接入阶段就要整体改写样式,反而增加工作量。团队有既有规范时,优先在配置里对齐,或直接做成模板复用。

增量生成需要人工核对

设计稿更新后重新生成,增量结果可能覆盖掉你在生成代码之上手写的业务逻辑。接入前先确认改动范围,把手工修改的部分与生成部分在目录上分开,能减少这类冲突。

价格与配额

各套餐的功能范围、生成次数或项目数量等配额限制,以官网当前信息为准。团队采购前建议先用实际项目试跑一轮,确认输出质量符合预期再决定。