Figma 插件上传速度由什么决定
影响 Figma 插件上传速度的主要因素有：
- 设计图的图层数量和复杂度
- 设计图中的切图数量
- 设计图尺寸和设计倍数设置（1 倍图还是 2 倍图）
- 网络质量
为什么 Moonvy 月维看起来比竞品慢
主要是相对于竞品为了高质量的设计标注结果
1. 上传结果包含的信息不同
如果一个工具主要生成一张预览图，或者只保存较简单的图层信息，上传链路会比较短。Moonvy 月维需要保留图层结构和标注数据，处理步骤更多，因此在同一份复杂设计图上，耗时可能更长。
这是一种功能取舍：上传时多处理一些内容，换来后续更完整的标注、代码和切图能力。实际比较时，应该比较上传完成后双方能提供的内容，而不只是比较进度条结束的时间。
2. 切图格式会增加处理工作
开启 SVG 切图后，插件需要额外检查可导出的图层，并准备 SVG 文件。开启「SVG 轮廓化字体」后，包含文字的 SVG 还需要将字体转换成路径，以降低字体缺失带来的显示差异。
如果项目只需要查看标注，或者研发只下载 PNG/WebP 切图，可以关闭 SVG 切图来缩短上传时间。
3. 外部组件可能需要额外检查
设计图使用了其他文件或团队资源库中的组件时，插件默认可以检查外部组件子图层的切图设置，并将设置继承到当前设计图。这个能力可以减少重复设置，但需要访问和检查外部组件，复杂文件中的耗时会更明显。
4. Figma 文件本身可能很复杂
大量嵌套图层、隐藏图层、超大位图、复杂蒙版、渐变、布尔运算、组件实例和变量，都会增加读取或解析时间。即使文件大小看起来不大，图层数量很多时也可能需要较长时间。
推荐设置
打开 Moonvy 月维插件的「设置」面板，可以根据交付需求调整上传内容。
| 设置 | 推荐做法 | 影响 |
|---|---|---|
| 跳过可视范围外的图层 | 保持开启 | 跳过 Frame 可视范围外的图层，减少需要解析的内容。默认开启。 |
| 切图导出 SVG | 需要 SVG 时开启，否则关闭 | 关闭后不再生成 SVG 切图，可以减少切图处理时间。 |
| 跳过外部组件子图层切图继承 | 不依赖外部组件切图设置时开启 | 不再检查外部组件的子图层切图设置，但组件根图层的切图继承仍然有效。 |
| 自动匹配未绑定变量 | 不使用自动变量匹配时关闭 | 关闭后不再检查数值与变量是否匹配，可以减少变量解析时间。 |
切图导出 SVG
在插件设置中关闭「切图导出 SVG」，上传的切图不会生成 SVG 格式，但 PNG 等其他格式不受这个选项影响。项目不需要 SVG 切图时，建议关闭此选项。
「SVG 轮廓化字体」只在需要 SVG 时有意义。开启后，SVG 中的文本会转换为路径，不会修改 Figma 原文件，但会增加处理内容。
跳过可视范围外的图层
保持「跳过可视范围外的图层」开启，可以减少超出 Frame 范围、通常不会参与最终交付的图层。只有在确实需要查看或处理这些范围外图层时，才需要关闭它。
跳过外部组件子图层切图继承
默认情况下，Moonvy 月维会检查外部组件子图层的切图设置。这样可以让组件在不同文件中复用切图配置，但会增加检查时间。
如果团队已经在当前设计文件中设置好切图，或者不需要继承外部组件子图层的切图设置，可以开启「跳过外部组件子图层切图继承」。需要保留切图继承时，可以直接在当前文件的图层上添加导出标记：
| 标记 | 作用 |
|---|---|
.export |
将当前图层作为切图导出 |
.导出 |
将当前图层作为切图导出 |
-export- |
将当前图层作为切图导出 |
减少设计图本身的处理量
只上传需要交付的 Frame
一次选中大量页面或画板，会同时增加读取、解析和上传的工作量。日常交付可以按页面或功能分批上传；需要更新单个页面时，也只选择对应的 Frame。
忽略不需要标注的图层
可以给不需要展示标注的图层、组或 Frame 添加特殊前缀：
| 图层名前缀 | 作用 |
|---|---|
-x- |
忽略当前图层、组或 Frame 的参数信息，但切图仍会上传 |
-bg- |
忽略当前图层的子图层，只显示当前图层 |
例如，背景装饰、不会交付的辅助图层，可以根据需要使用 -x- 或 -bg-。使用前请确认这些图层确实不需要被开发者查看。
清理不再使用的资源
删除无用的隐藏图层、超大位图和重复的复杂效果，通常能同时改善 Figma 文件操作和 Moonvy 月维上传速度。对于暂时不需要交付的内容，可以先放到另一个文件中，或分批上传。
建议的排查顺序
如果上传明显变慢，可以按下面的顺序定位：
- 新建一个简单 Frame，放入少量图层后上传一次；
- 如果简单 Frame 很快，说明网络和账号基本正常，问题更可能来自原设计图的复杂度；
- 在原设计图中依次尝试：关闭 SVG 切图、开启跳过外部组件子图层切图继承、关闭自动匹配未绑定变量；
- 将原设计图拆成几个页面或 Frame 分批上传，观察是哪一部分耗时明显；
- 如果简单 Frame 也很慢，检查是否开启了代理、网络是否稳定，以及插件是否能正常访问月维。
关闭功能会减少对应的数据或切图能力。调整设置后，建议用一张包含常用组件、变量和切图的真实页面做一次验证，确认开发者需要的信息仍然完整。
网络与登录问题
网络问题通常表现为上传阶段停留时间长、反复重试或上传完成后网页没有显示。请先确认浏览器可以正常访问 Moonvy 月维，再重新登录插件并重试。
如果使用代理工具，可以将下面的域名加入直连配置：
*.moonvy.com
moonvy.com
仍然无法上传时，可以参考《Figma 上传》中的常见问题或联系我们。
