figma协作文件图层混乱问题可通过三步解决：一、用clean document插件自动清理隐藏图层、冗余组并重命名；二、运行cleanuporphans.js脚本批量删除孤立组件与样式；三、每日交接前用collapse layers功能一键折叠所有展开图层。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma协作文件中频繁遇到图层列表膨胀、空组堆积、隐藏图层残留等问题，导致选中困难、性能下降或开发对接出错，则很可能是垃圾图层未及时清理所致。以下是解决此问题的步骤：
一、运行Clean document插件自动清理
Clean document是一款经验证的轻量级Figma插件，专为结构化清理设计：它能自动识别并移除隐藏图层、解散单子图层的冗余组、重命名混乱图层，并按空间位置重新排序，显著提升文件可读性与协作效率。
1、在Figma编辑器中打开目标协作文件。
2、点击右上角「Plugins」菜单，选择「Search plugins」，输入“Clean document”并安装启用。
3、选中需清理的页面或画板（支持全选多个画板），点击插件面板中的「Clean selected frames」按钮。
4、勾选「Remove hidden layers」、「Ungroup single-child groups」、「Rename layers by position」等选项，确认执行。
5、等待插件完成扫描与操作，刷新图层面板即可观察到层级大幅精简。
二、执行cleanupOrphans.js脚本批量清除孤立组件
该脚本来自Figma官方推荐的自动化工具链，可深度扫描项目内所有未被引用的组件、样式及断连实例，避免因协作中误删主组件而遗留“幽灵图层”，尤其适用于长期迭代的多人项目。
1、访问GitHub仓库skills/figma-generate-library/scripts/cleanupOrphans.js，复制全部脚本内容。
2、在Figma中打开「Plugins」→「Development」→「Create new plugin」，粘贴代码并保存为“Orphan Cleaner”。
3、返回设计文件，运行该插件，系统将自动列出所有孤立组件与样式名称。
4、勾选确认项后点击「Remove selected」，脚本将立即解除关联并从资源面板中删除对应条目。
5、重启Figma客户端以确保资源面板完全刷新，避免缓存残留显示。
三、使用Figma原生Collapse Layers功能预控图层展开态
持续暴露展开状态的图层会加剧视觉干扰与误操作风险；Figma内置的一键折叠机制可在每次交接前快速归零图层展开层级，从源头抑制“图层洪水”，为后续清理提供干净起点。
1、确保图层面板处于可见状态（快捷键Shift+2）。
2、观察图层面板右上角是否出现「Collapse layers」按钮（仅当存在已展开图层时显示）。
3、点击该按钮，所有展开的组、框架与嵌套图层将即时收起。
4、如需快捷触发，直接按下 Option+L（Mac）或 Alt+L（Windows） 组合键。
5、建议将此操作设为每日同步前的固定动作，形成协作规范。
