开发拿到了令牌文件,却不知道它对应哪份设计稿、能不能继续编辑源文件?
最快的处理方式:若开发只需读取颜色、文字和图层样式,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 方案入口了解可选方式。