☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
style organizer可自动识别并清理figma中未被引用的无效样式。步骤包括：一、安装启用插件；二、扫描分类样式；三、批量删除无效样式；四、导出json清理报告；五、通过figma cli集成自动化扫描提醒。
如果您在figma项目中发现大量未被任何图层引用的文本、填充、描边或效果样式，导致样式面板臃肿、协作混乱或导出体积异常增大，则很可能是项目内积累了大量无效样式。style organizer是一款专为figma设计的第三方插件，可自动识别并分类未被使用的样式资源。以下是解决此问题的步骤：
一、安装并启用Style Organizer插件
Style Organizer需通过Figma Community平台安装，安装后首次运行将自动扫描当前文件全部样式节点，并区分“已使用”与“未使用”状态，为后续清理提供结构化依据。
1、在Figma桌面端或网页版中打开目标设计文件；
2、点击右上角“Plugins”按钮，选择“Search plugins”；
3、在搜索框中输入Style Organizer，找到官方发布版本（作者：Figma Community）；
4、点击“Install”完成安装，随后点击“Run”启动插件。
二、执行全量样式扫描与分类
插件启动后将遍历当前文件所有页面、帧及嵌套组件，比对每个样式ID是否存在于任意图层的styleId属性中，从而精确判定有效性。该过程不修改任何图层，仅生成只读报告。
1、插件界面弹出后，确认顶部显示“Scan current file”选项处于激活状态；
2、点击“Start Scan”按钮，等待进度条完成（大型文件可能需10–30秒）；
3、扫描结束后，左侧面板将分组列出“Used Styles”与“Unused Styles”，右侧同步显示各样式预览及引用次数；
4、点击“Unused Styles”分组标题旁的展开箭头，查看全部未使用样式的完整列表。
三、批量删除无效样式
Style Organizer支持安全批量移除操作，删除前会二次提示并高亮所选样式名称，防止误删关键资源。所有删除动作仅作用于当前Figma文件本地，不影响团队库或主样式集。
1、在“Unused Styles”列表中，勾选全部复选框或按住Shift键多选指定样式；
2、点击右下角红色按钮“Remove Selected”；
3、在弹出的确认对话框中，再次核对样式数量与名称，点击“Confirm Removal”；
4、插件执行删除后，自动刷新左侧面板，“Unused Styles”分组清空，样式面板实时更新。
四、导出清理报告并存档
为保障团队协作可追溯性，Style Organizer允许将本次扫描结果导出为JSON格式报告，包含时间戳、文件ID、样式总数、无效样式明细及删除操作日志，便于审计与回滚验证。
1、扫描并清理完成后，点击插件界面右上角“⋯”更多菜单；
2、选择“Export Report”选项；
3、系统自动生成report_YYYYMMDD_HHMMSS.json文件，保存至默认下载目录；
4、将该文件重命名为“figma_style_cleanup_project_name_v1.json”，归档至项目文档库。
五、设置定期自动化扫描提醒
Style Organizer本身不提供定时任务功能，但可通过Figma API配合外部脚本实现周期性检查。推荐使用Figma CLI工具，在CI流程中集成样式健康度校验，当无效样式占比超5%时触发告警。
1、在项目根目录初始化Figma CLI配置，执行命令：figma-cli init；
2、创建脚本clean-styles.js，调用plugins/run接口传入Style Organizer插件ID；
3、在package.json中添加npm script："check:styles": "figma-cli run --plugin-id=figma-plugin-style-organizer"；
4、将该脚本接入GitHub Actions每日凌晨执行，并将结果推送至Slack通知频道。
