Sublime Text 批量修改文件名的真相与实战指南
先说一个核心事实：Sublime Text 编辑器本身，压根就不支持批量修改文件名。所有那些看似“在 Sublime 里一键批量重命名”的操作，背后要么是插件在干活，要么是调用了外部命令。这不是什么隐藏功能，而是其简洁设计哲学下的必然结果。
SideBarEnhancements 插件：如何正确启用批量重命名
很多人装了 SideBarEnhancements，却发现右键多选文件时，菜单里根本没有“Batch Rename”的影子。问题出在哪儿？其实，这个功能并非装完即用，得确认几个关键环节：
- 首先，你得确保已经安装了
Package Control，这是安装任何插件的前提，SideBarEnhancements 也不例外。 - 插件安装成功后，重启 Sublime Text 是必要步骤，部分 Sublime Text 4 的版本甚至需要手动刷新插件状态。
- 最关键的一点：右键侧边栏多选文件时，菜单里出现的是
Rename（单个）还是Batch Rename（多个），这取决于插件版本和实验功能是否开启。如果只有前者，说明当前版本默认关闭了批量入口。 - 想强制开启？可以手动在
Packages/User/SideBarEnhancements.sublime-settings配置文件中添加一行："enable_batch_rename": true。 - 另外，操作时有个细节容易踩坑：输入新后缀时千万别加点。比如想把文件改成
.ts，在输入框里只输ts就行；如果输成.ts，系统会生成一个带双点的..ts文件，让人哭笑不得。
文件名改了，标签页却“纹丝不动”？警惕同步断裂
这可能是最让人困惑和危险的问题了：明明在侧边栏看到文件名已经更新，但编辑器顶部的标签页却还顽固地显示着旧名字。这可不是显示延迟，而是典型的同步断裂，根源在于一个叫 atomic_sa ve 的设置：
- 当
"atomic_sa ve": true（默认值）时，Sublime 采用一种“原子保存”机制。重命名后，编辑器不会自动更新标签页对应的内部文件路径，它仍然指向旧的文件句柄。 - 此时如果你在标签页里编辑并保存，内容实际上会被写回一个已经不存在的路径（或者新建一个同名旧文件），这极有可能导致原文件被覆盖或内容丢失。
- 解决方法很直接：打开
Preferences → Settings，在右侧的用户设置区里加入"atomic_sa ve": false。 - 如何验证生效？重命名后立刻观察标签页标题，如果它实时变成了新文件名，而不是“旧名+星号（未保存状态）”，那就对了。
绕开插件：命令行批量改名的“坑”与“术”
如果不依赖插件，直接使用系统命令行批量改名，听起来很酷，但不同系统下的命令差异巨大，直接复制粘贴大概率会失败：
- 在 macOS 上，系统自带的
rename命令是 BSD 版本，不支持正则表达式。如果你直接运行网上常见的rename 's/\.js$/.ts/' *.js，只会得到报错。正确的姿势是使用for循环：for f in *.js; do mv "$f" "${f%.js}.ts"; done。 - 在 Windows PowerShell 中，Bash 的变量替换语法
${f%.js}完全无效。你需要使用 PowerShell 原生的-replace操作符：Get-ChildItem *.js | Rename-Item -NewName { $_.Name -replace '\.js$', '.ts' }。 - 在 Linux 上，虽然 GNU 版本的
rename命令支持强大的正则表达式，但像 Debian/Ubuntu 这类发行版可能默认没有安装。先运行rename --version确认一下，如果提示命令未找到，记得先执行sudo apt install rename。 - 无论使用哪种命令，在执行毁灭性的重命名操作前，务必先用
ls *.js或Get-ChildItem *.js预览一下匹配到的文件列表，避免误伤无辜文件。
真正的麻烦：重命名后，代码里的引用怎么办？
需要警惕的是，SideBarEnhancements 的 “Rename” 功能，其职责仅仅是修改磁盘上的文件名。它完全不会去扫描或自动替换你代码中任何对该文件的字符串引用。
- 举个例子，你把
utils.js改成了utils.ts，但另一个文件里的import './utils.js'语句纹丝不动。接下来 TypeScript 编译器报错，你可能会一头雾水。 - 这时候，必须手动使用 Sublime Text 的
Ctrl+Shift+F（在文件中查找）功能，全局搜索旧的引用路径，并逐一替换成新的。 - 操作时，注意勾选
Whole Word（全字匹配）和Case Sensitive（区分大小写）选项，否则替换user时可能会误伤username。 - 而对于那些动态拼接的路径（如
require(`${mod}_utils.js`)）或通过反射进行的调用（如 Python 的importlib.import_module("utils")），全局替换也无能为力，只能依靠人工逐一核对。
说到底，批量重命名从来不是最难的步骤。真正的挑战在于两步：第一，确保编辑器本身知道文件已经“改头换面”，别在后台继续编辑一个幽灵文件；第二，确保项目里所有依赖它的代码都及时“更新了通讯录”。这两件事必须分开处理，顺序不能乱，而且每一步都藏着各自的陷阱。
