开发拿到了令牌文件,却不知道它对应哪份设计稿、能不能继续编辑源文件?

最快的处理方式:若开发只需读取颜色、文字和图层样式,Sketch Workspace 网页端可用于检查、导出令牌或分享令牌链接;若要修改 Sketch 源文件或令牌来源,则需要能运行 Sketch 的 Mac 环境。交付时,把链接策略对应到已确认的文档版本,并让开发核对实际导出内容。官方更新记录说明,2026.3.1 的更新重点并非新增令牌导出功能;本文以官方发布记录和交接文档为准,不把版本号当成功能来源。官方 2026.3.1 更新记录;官方令牌导出说明

负责颜色、文字和图层样式的设计系统设计师,可按流程整理令牌交付。
主要使用 Windows 的开发者,可了解浏览器端能检查和下载什么。
需要确认版本、权限与更新责任的设计负责人,可据此建立团队约定。

最后更新于 2026 年 10 月 1 日;版本与功能核实自 Sketch 官方更新记录、开发者交接及 Workspace 文档。

交接对象:令牌、源文件与素材

开始前先确认交付物。Design Tokens 是颜色变量、文字样式、图层样式等可复用设计值的导出结果,不等于完整 Sketch 源文件,也不等于图片、图标等导出素材。官方文档说明,令牌可以从网页端导出为 CSS 或 JSON;颜色变量支持这两种格式,文字样式和图层样式则以 JSON 格式导出。官方令牌导出说明

开发方需要什么 交付内容 不能由此推断什么
在代码中参考已确认的颜色或样式 令牌文件或令牌链接 不能据此编辑完整 Sketch 文档
查看尺寸、图层属性或样式路径 Workspace 网页端检查权限及文档链接 能查看不代表有源文件编辑权限
在项目中使用图标、图片等素材 单独导出的素材文件 素材包不能代替令牌或源文件

因此,交接邮件或任务单里不要只写“Sketch 文件已交”。要写明开发需要的是令牌、可检查的设计文档,还是可编辑的源文件;如果项目既要代码样式值又要图形资源,应分别列出,避免接收方把令牌 JSON 当成完整设计稿。

确认来源:文档、库与负责人

交付前要先找到令牌的真实来源:这些颜色变量、文字样式和图层样式来自本次审批的文档,还是来自某个库?如果同名样式可能在不同文档或库里出现,只核对名称并不足够。开发者应能从来源信息判断当前读取的是哪一组样式,而设计负责人则要确认它们属于本次交付范围。

核对项 设计方应确认 开发方应能复核
文档或库 本次审批对应的来源 链接打开后显示的文档身份
令牌范围 颜色、文字、图层样式的纳入范围 导出结果中是否包含预期类别
负责人 谁批准本次交付 遇到差异时联系谁
可编辑需求 是否需要改源文件 当前权限是否仅供查看

Windows 设计交接能做到什么?

Windows 开发者可以通过浏览器查看获准访问的设计、检查图层属性,并在权限允许时下载令牌或素材;这不等于浏览器能完整编辑 Mac 端的 Sketch 源文件。Workspace 网页端提供查看、检查和部分交接操作,而编辑源文档仍应回到 Sketch Mac 应用。官方开发者交接说明;官方 Workspace 文档

还要检查接收方权限。受邀访客是否能查看文档、检查图层或下载素材,取决于文档分享设置;查看权限与编辑权限并非同一回事。交付前用开发者实际账号测试一次,比设计师在自己的管理员账号下确认“链接能打开”更可靠。官方文档权限说明;官方分享设置说明

导出令牌:选择能追溯的链接状态

确认来源和范围后,再在 Workspace 网页端打开目标文档,从文档详情或组件视图进入令牌导出。检查导出预览,确认类别与格式后再下载;若开发要使用链接而不是静态文件,先确定链接应该跟随最新改动,还是锁定在已批准的状态。官方说明列出三种链接状态,且只有编辑者和管理员能启用或禁用链接,查看者可以复制和查看已启用的链接。官方导出与链接状态说明

链接状态 适合的交接情形 需要留意
指向最新文档更新 开发明确需要持续读取新改动,且团队接受链接内容随文档变化 不是固定快照;审批后继续改稿可能改变开发读取的值
指向最新已标星版本 交付需对应团队认可的状态,且该版本已完成确认 应在交付记录中写清对应版本,并由开发核对
禁用 已撤销共享,或不再允许通过该链接获取令牌 已分享的链接会停止工作,需告知接收方

判断分支:

  • 若审批后仍会持续改动,且开发需要追踪最新值,则选“最新文档更新”;否则回退到已批准版本的链接。
  • 若本次交付必须固定对应审批结果,则先确认已标星的版本与审批记录一致,再选“最新已标星版本”;若没有可确认的标星状态,应暂停发链接并补齐版本确认。
  • 若令牌不应继续对外开放,则选择禁用,并另外告知开发原链接已失效;不要把“禁用”当作撤回对方已经下载文件的保证。

这里的关键不是哪种链接看起来更方便,而是开发拿到的内容能否对应交付记录。持续指向最新更新的 URL 不应被误认为审批时的固定快照;需要锁定交接依据时,应优先采用已确认的版本策略,并保留当时的实际导出结果。

开发验收:让实际内容对上确认稿

链接发出后,不要以“开发能打开”为验收结束。请开发抽查代表性的颜色、文字样式和图层样式名称,并与已确认的 Sketch 文档核对。若发现名称、值或范围不符,先确认读取的是哪个文档版本、令牌链接采用了哪种状态,再判断问题出在来源选择、审批后改稿,还是开发侧的读取方式。

可勾选的验收清单:

  • [ ] 文档名称与令牌来源已写明,开发能打开相同的交接对象。
  • [ ] 已确认颜色、文字和图层样式哪些包含在本次交付中。
  • [ ] 导出格式符合开发方约定;格式不确定时,先用样例文件试读。
  • [ ] 开发实际检查了代表性的令牌,而不是只确认下载成功。
  • [ ] 令牌值与确认稿一致;如不一致,已记录差异并暂停把结果当作最终值。
  • [ ] 链接状态、接收对象和后续更新负责人均已说明。

令牌导出可以作为项目参考或开发流程的衔接材料,但不能据此承诺任何开发工具会自动同步,也不能推断链接内容适合直接接入生产环境。生产项目如何读取、校验和发布这些值,应由开发团队按自己的构建与发布流程验证;官方文档也提醒,不建议把公开令牌链接直接加入生产环境。官方令牌集成说明

改稿与收尾:保留可复核的记录

交付后发生改稿,先问开发是否已经采用旧令牌。如果还未采用,设计负责人可以决定更新链接或重新导出;如果开发已经使用,应先评估差异对实现的影响,再约定替换时间,避免设计侧更新了共享链接、开发侧却不知道读取结果已经变化。

Workspace 网页端适合查看、检查和部分导出,但它不能代替源文件编辑环境。需要调整颜色变量或样式来源、修正文档结构时,应由设计师在可运行 Sketch 的 Mac 环境中修改源文件,再重新确认版本与交付状态。官方检查功能说明

收尾记录无需复杂,但至少要让后来接手的人知道交付依据。可记录文档名称、审批状态、令牌链接用途、采用的版本策略、导出时间、接收人及更新负责人;其中具体值应由团队据实填写,不要用未经确认的默认信息代替。再用一份代表性令牌复核接收权限、链接是否可用以及开发侧是否能读到预期内容,然后明确由谁负责下次更新。

如果只需检查令牌或下载已开放的资源,先用 Workspace 网页端通常更直接;若必须修改源文件,临时远程使用 Mac 可以避免为偶发任务先购置设备,但若持续进行高频设计工作,或必须接触本地物理接口,按需租赁未必比自有设备合适。需要临时 Mac 环境时,可先查看 RUVCLOUD 的租赁方案与计费信息,再按项目使用频率决定是否租用;确认需要后,可从 RUVCLOUD 方案入口了解可选方式。