Sublime Text 本身不能批量修改文件后缀——它不操作文件系统，所有“批量改后缀”都是调用系统命令或插件封装的外壳。你看到的“右键 Batch Rename”“一键替换扩展名”，背后全是 mv、ren 或 Rename-Item 在干活。搞不清这点，就容易误以为改了后缀代码就能跑，结果 import utils 报错、require('./config.js') 找不到模块，全是因为文件磁盘名字没变，或者变了但引用没同步。
SideBarEnhancements 的 Batch Rename 怎么用才不翻车
这是最贴近 Sublime 界面习惯的操作路径，但有硬性前提和易错点：
- 必须通过
Project → Add Folder to Project…显式添加目标目录，拖进窗口或双击打开不算“项目上下文”，右键不会出现Batch Rename - 安装插件后需重启 Sublime；若仍只看到
Rename（单个）而没有Batch Rename，手动在Packages/User/SideBarEnhancements.sublime-settings中加一行："enable_batch_rename": true - 输入新后缀时不要带点：想改成
.ts，只填ts；填.ts会生成..ts，文件名直接损坏 - 插件不检查目标文件是否存在，
utils.ts已存在时，utils.js重命名会静默失败，原文件不动，无任何提示
PowerShell（Windows）或 Bash（macOS/Linux）一行命令更可靠
命令行不是“更高级”，而是更透明、可验证、可复现。尤其当你要处理嵌套目录、排除某些文件、或做条件替换时，插件模板语法立刻不够用。
- Windows PowerShell 示例（改当前目录下所有
.js为.ts）：Get-ChildItem *.js | Rename-Item -NewName { $_.Name -replace '\.js$', '.ts' } - macOS/Linux Bash 示例（同上）：
for f in *.js; do mv "$f" "${f%.js}.ts"; done - 执行前务必先确认范围：
ls *.js或Get-ChildItem *.js，别在工程根目录盲目运行 -
${f%.js}是 Bash 参数展开，删结尾.js；PowerShell 不支持该语法，必须用-replace或$_.BaseName - 含空格路径必须加引号：
"$f"，否则file name.js会被拆成两个参数，mv报错
改完后 Sublime 标签页还显示旧名？这不是 Bug，是 atomic_save 在起作用
这是最常被忽略的同步断裂问题：文件磁盘名字已变，但 Sublime 编辑器里的标签页仍指向旧文件句柄。此时保存，内容可能写回一个已不存在的路径，或覆盖错误文件。
- 根本原因是默认设置
"atomic_save": true，它让 Sublime 先写临时文件再原子替换，但重命名后旧路径失效，机制失灵 - 解决方法：打开
Preferences → Settings，在右侧用户设置中加入："atomic_save": false - 验证是否生效：重命名后看标签页标题是否立刻变成新文件名；若仍是旧名+星号（*），说明未生效
- 即使关了
atomic_save，已打开的旧标签页也不会自动刷新，需手动关闭再用Ctrl+P搜索新名重新打开
真正麻烦的从来不是怎么改后缀，而是改完之后：代码里所有 import、require、#include、路径字符串都得跟着批量更新，而且得区分是字面量路径还是动态拼接。这个环节漏掉一行，编译或运行时才会暴露，但那时你已经记不清哪些文件动过了。
