SideBarEnhancements是唯一能在Sublime侧边栏直接批量重命名文件的可靠路径,因原生不支持文件系统操作;必须满足项目上下文、启用enable_batch_rename、模板含{{name}}或{{index}}三条件,否则菜单不显示、操作无效或静默覆盖文件。

SideBarEnhancements 是唯一能在 Sublime 侧边栏里直接批量重命名文件的可靠路径,原生功能完全不支持——这不是设置问题,是 Sublime 本身没实现文件系统操作层。
为什么右键没出现 Batch Rename 菜单项
不是插件没装好,而是 Sublime 没识别出合法操作上下文:
• 必须通过 Project → Add Folder to Project… 显式添加目录;仅拖拽文件夹或用 File → Open Folder 不生效
• Packages/User/SideBarEnhancements.sublime-settings 中必须有 "enable_batch_rename": true(注意 JSON 语法,结尾加逗号)
• 右键对象必须是侧边栏里的文件节点,且所有选中文件在同一层级目录下
• Windows 用户避开 C:\Program Files\ 等受控路径,否则静默失败、无错误提示
模板里写 {{name}} 和 {{index}} 有什么实际区别
变量写错或漏写会导致静默失败、空名、甚至覆盖原文件:
• {{name}} 是原文件名(不含扩展名),{{ext}} 是扩展名(含点,如 .js)
• {{index}} 从 1 开始编号,{{index0}} 从 0 开始;补零写法是 {{index|03}}(三位)或 {{index0|02}}(两位)
• 模板中必须含至少一个动态变量,否则所有文件会被重命名为完全相同的名字(例如输 backup 就真全变成 backup)
• 错误写法:new_file.{{ext}}(若多个文件同名会冲突);安全写法:{{name}}_v2.{{ext}}、log_{{index0|02}}.{{ext}}
重命名后标签页还是旧文件名,怎么同步
这不是 UI 卡顿,是 atomic_save 默认开启导致的路径句柄错位——最危险的隐藏坑:
• 打开 Preferences → Settings,在右侧用户设置中加入 "atomic_save": false
• 验证方式:重命名 a.txt 为 b.txt 后,标签页标题应立刻变成 b.txt,而不是仍显示 a.txt
• 已打开的文件不会自动重载,需手动右键标签页 → Revert,或按 Ctrl+R(Windows/Linux)/Cmd+R(macOS)刷新侧边栏
• 如果文件已被修改未保存,Revert 会丢弃当前改动,务必先保存
怎么撤销整批重命名操作
Ctrl+Z 默认无效,且一旦提交就不可逆——除非你提前开启撤销支持:
• 打开 Preferences → Package Settings → SideBarEnhancements → Settings – User
• 添加配置:"enable_undo_for_rename_operations": true(注意 JSON 格式,别破坏结构)
• 这个开关必须在重命名前就启用,事后加了也救不回已执行的操作
atomic_save 和撤销开关——它们不报错、不提醒,但会直接导致内容写错位置或无法挽回。

















