暗色模式
从 Figma 迁移到 MasterGo
如果你正在从 Figma 切换到 MasterGo，这篇指南将帮助你和团队完成无缝迁移。
适用对象
- 正在从 Figma 切换到 MasterGo 的设计师
- 负责团队迁移的设计负责人
- 导入后需要验证文件完整性的 QA
迁移方式对比
| 方式 | 适合场景 | 迁移内容 | 引用关系 | 限制 |
|---|---|---|---|---|
| Figma OAuth 导入 | 批量迁移多个文件 | 文件 + 页面结构 + 图层 | 支持（需通过团队文件迁移流程） | 需要 Figma 账号授权 |
| 本地 .fig 导入 | 已导出 Figma 本地文件 | 单文件 | 团队库组件关联会丢失 | 跨文件的组件引用无法保留 |
| Sketch 中转 | Figma 无法直接导入时 | 单文件 | 不保留 | 需先导出 Sketch，多一步 |
方式一：通过 Figma OAuth 直接导入（推荐）
第 1 步：授权 Figma 账号
- 登录 MasterGo 工作台 → 左侧导航栏「导入」→「从 Figma 导入」
- 系统跳转到 Figma 授权页面 → 登录 Figma → 点击「Allow Access」
- 授权成功后自动返回 MasterGo
授权范围说明
MasterGo 仅请求读取 Figma 文件列表和文件内容的权限，不会修改你的 Figma 文件。
第 2 步：选择要导入的文件
- 授权后页面展示你的 Figma 文件列表，支持按团队、项目筛选
- 勾选要导入的文件（支持多选）→ 选择目标团队和项目位置
- 点击「开始导入」
第 3 步：等待导入并验证
导入完成后，打开文件逐项检查：
- [ ] 页面结构是否完整（所有 Page 都已导入）
- [ ] 图层层级是否正确
- [ ] 文本内容和字体是否正常（Figma 字体自动映射到 MasterGo 对应字体）
- [ ] 颜色和样式是否保留
- [ ] 自动布局（Auto Layout）是否正常转换
- [ ] 组件实例是否正确关联
方式二：导入本地 .fig 文件
操作步骤
- 在 Figma 中选择 File → Save local copy，导出 .fig 文件
- 在 MasterGo 工作台点击「导入文件」或拖拽 .fig 文件到工作台
- 选择 .fig 文件上传 → 等待转换完成（通常 1-3 分钟，取决于文件大小）
- 文件打开后检查图层完整性和样式正确性
已知限制
- 团队库组件关联会丢失，需要手动替换
- 插件生成的特殊图层可能不兼容
- 交互原型信息不保留
- 文件中的嵌入图片需重新上传
建议
如需保留组件与实例的引用关系，请使用团队文件迁移流程。本地 .fig 导入无法保留跨文件的组件关联。
.fig 导入常见问题
| 问题 | 解决方法 |
|---|---|
| 导入失败，提示文件格式错误 | 确认是 Figma 导出的 .fig 文件；重新导出再试 |
| 导入后样式错乱 | 手动调整样式；使用「替换样式」功能批量更新 |
字体映射参考
| Figma 字体 | MasterGo 映射 | 备注 |
|---|---|---|
| Inter | 苹方（macOS）/ 微软雅黑（Windows） | 替代映射 |
| Roboto | 苹方 / 微软雅黑 | 替代映射 |
| 思源黑体 | 思源黑体 | 完全兼容 |
| 自定义字体 | 需上传 | 联系管理员上传到团队字体库 |
保留引用关系的迁移
如果你需要从 Figma 迁移团队文件并保留组件与实例的引用关系，可使用「团队文件迁移」功能，按正确的顺序导入文件：
- 将 Figma 中的"团队库文件"通过组件库入口导入，以保留组件与实例的关联
- 将"业务设计稿"通过设计稿入口导入，导入后自动关联到已导入的组件库
- 在"团队库文件"中发布团队库并启用，业务设计稿即可调用组件
详细流程参见 导入与导出 — 团队文件迁移。
团队迁移建议
- 先试点：选 1-2 个代表性文件进行导入测试
- 建团队库：在 MasterGo 中先搭建好团队组件库、样式库和变量库
- 分批迁移：按项目或团队分批迁移，每批导入后验证
- 确定切换日：迁移完成后设定统一的 Figma 只读/停用时间
- 培训团队：用设计编辑文档帮助团队成员快速上手
常见问题
| 问题 | 原因 | 解决方法 |
|---|---|---|
| Figma 授权失败 | Figma 账号权限不足 | 确认 Figma 账号对文件有 View 权限 |
| 导入后文件空白 | 文件包含不支持的元素 | 检查 Figma 文件是否使用了 Beta 功能 |
| 组件实例变成独立图层 | 主组件未在同一个文件内 | 先导入组件库文件，再导入使用该库的文件 |
| 图片丢失 | 图片在 Figma 中使用了外部 URL | 把外部图片嵌入 Figma 文件后重新导出 |
| 导入速度慢 | 文件很大或网络不稳定 | 拆分为小文件分次导入；避免高峰期 |
| 中文文本乱码 | 字体映射问题 | 选中文本 → 手动切换字体 |
| 原型连接丢失 | 交互数据格式差异 | 在 MasterGo 原型模式中重新建立连接 |
提示
在正式迁移前，先在 Figma 中做一次「文件清理」：删除隐藏图层、合并冗余样式、移除无用组件。这能显著提高导入速度和转换质量。