若Figma自动重命名失效，需依次检查：一、在Settings→Beta features中开启Layer Metadata；二、确认组件图层“Advanced”区有可编辑“Name”字段，否则重建组件；三、在View→Canvas中启用Auto rename layers；四、禁用冲突的命名类插件；五、执行figma.clearCache()清除缓存并重启文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在figma中启用自动重命名功能后，发现组件名称未被正确识别或更新，则可能是由于图层元数据（layer metadata）设置未启用或配置异常。以下是排查与修复该问题的具体操作路径：一、确认Layer Metadata是否已启用
自动重命名功能依赖于Figma底层的图层元数据系统来识别组件结构和命名上下文。若该系统被禁用，组件将无法被自动命名逻辑识别。
1、点击右上角用户头像，打开下拉菜单。
2、选择“Settings”进入账户设置页面。
3、在左侧导航栏中点击“Beta features”选项卡。
4、查找名为Layer Metadata的开关项，确保其右侧滑块处于开启状态（显示为蓝色）。
5、若此前为关闭状态，请开启后刷新Figma编辑器页面。
二、检查组件图层是否具备可命名的元数据属性
Figma仅对具有完整元数据结构的图层执行自动重命名。若组件由旧版本文件导入、粘贴生成或通过脚本批量创建，可能缺失必要的元数据字段。
1、在画布中选中目标组件实例或主组件。
2、打开右侧“Properties”面板，向下滚动至“Advanced”区域。
3、观察是否存在“Name”字段且可编辑；若该字段显示为灰色不可编辑或完全缺失，则说明元数据未绑定。
4、尝试右键该组件 → 选择“Detach instance” → 再次右键新图层组 → 点击“Create component”，重建组件以触发元数据写入。
三、验证自动重命名开关是否在当前文档中激活
即使全局Layer Metadata已启用，单个Figma文档仍需单独启用自动重命名功能，否则组件不会响应命名策略。
1、确保当前处于目标设计文件内，而非库文件或原型视图。
2、点击顶部菜单栏的“View” → 悬停于“Canvas”子菜单 → 勾选“Auto rename layers”选项。
3、若该选项呈灰色不可勾选状态，说明当前文档权限受限或处于只读模式，请切换至编辑者身份并重新加载。
4、返回画布，选中一个含多个子图层的组件实例，按快捷键Ctrl+Shift+A（Windows）或Cmd+Shift+A（Mac）手动触发一次重命名。
四、排除插件或第三方脚本干扰
部分Figma社区插件（如Rename It、Auto Layout Helper）会覆盖原生重命名逻辑，导致组件无法被识别为有效命名对象。
1、点击左下角“Plugins”图标，打开插件管理面板。
2、在搜索框中输入“rename”“auto”“layer”等关键词，列出所有已安装的命名类插件。
3、对每个相关插件，点击其右侧“⋯”按钮 → 选择“Disable plugin”临时禁用。
4、关闭并重新打开当前Figma文档，再次测试自动重命名对组件的识别效果。
五、重置组件命名上下文缓存
Figma客户端可能因缓存残留导致Layer Metadata索引失效，尤其在频繁切换组件版本或跨团队协作后。
1、在Figma编辑器中，按下快捷键Ctrl+Shift+I（Windows）或Cmd+Option+I（Mac）打开开发者工具。
2、切换到“Console”标签页，粘贴并执行以下命令：figma.clearCache()。
3、等待控制台返回“undefined”提示后，关闭开发者工具窗口。
4、点击顶部“File” → “Close file”，再重新从“Recent files”中打开该文档。
