sidebarenhancements批量重命名需满足三条件:项目上下文(project→add folder to project…显式添加)、模板含动态变量(如{{index}})、提前启用"enable_undo_for_rename_operations": true,缺一则失效。

Sublime Text 原生不支持批量重命名文件,SideBarEnhancements 是目前唯一稳定、可撤销、带预览的解决方案,但必须满足“项目上下文 + 正确模板 + 显式启用撤销”三个硬性条件,缺一不可。
为什么右键 Rename 没反应或点了没变化
这不是插件失效,而是 Sublime 没识别出操作上下文。SideBarEnhancements 的 Rename 功能只对「已加入项目的文件夹内选中的多个文件」生效。
- 单个文件右键 → 不会出现
Rename选项(只有 Move / Delete) - 直接拖文件夹进窗口 → 不构成项目,右键菜单仍是原生的
- 必须通过
Project → Add Folder to Project…显式添加目标目录 - Windows 用户若路径在
C:\Program Files\下,系统会静默拒绝写入,Rename 点击后无任何提示
模板怎么写才不会覆盖所有文件
所有变量必须显式包含至少一个动态标识符,否则所有文件会被重命名为完全相同的名字,触发系统覆盖警告(且无法恢复,除非提前开了撤销)。
- 安全写法:
img_{{index}}.png、{{name}}_backup.{{ext}}、log_{{index0}}.txt - 危险写法:
new_file.txt(无变量)、{{name}}.txt(若原文件名相同,仍会冲突) - 可用变量:
{{name}}(不含扩展名)、{{ext}}(含点,如.py)、{{index}}(从 1 开始)、{{index0}}(从 0 开始) - 中文、空格、括号基本能处理,但 macOS 上若文件系统是 case-insensitive(默认 APFS),
IMG.png → img.png实际是覆盖,无提示
如何让 Ctrl+Z 撤销整批重命名
该功能默认关闭,且一旦重命名完成再开启设置也无效——必须在操作前就启用。
- 打开
Preferences → Package Settings → SideBarEnhancements → Settings – User - 添加这一行:
"enable_undo_for_rename_operations": true - 保存后,下次执行
Rename才会记录完整操作栈 - 撤销仅限当前 Sublime 会话;重启后历史清空,无法跨 session 恢复
重命名后侧边栏不刷新怎么办
SideBarEnhancements 不监听文件系统事件,重命名操作完成后,编辑器标签页和侧边栏不会自动更新显示新名称。
- 手动刷新侧边栏:按
Ctrl+R(Windows/Linux)或Cmd+R(macOS) - 若文件正在编辑中,标签页名仍显示旧名,需右键该标签 →
Reopen with Encoding或关闭重开 - 不想每次手动刷?可装
AutoSetSyntax或File Watcher类插件自动响应变更 - 注意:重命名含隐藏文件(如
.gitignore)时,插件不会警告,新名若仍以点开头,文件将被隐藏
最常被忽略的是撤销开关和项目绑定这两步——很多人重命名失败后第一反应是重装插件,其实只要检查 Project → Add Folder to Project… 是否执行过、Settings – User 里有没有那行 enable_undo_for_rename_operations,90% 的问题当场解决。











