Sublime Text 无法原生批量格式化多个文件，必须借助外部命令行工具（如 prettier、black）或 Python 脚本调用其 CLI 实现；插件仅支持单文件、不支持目录遍历，宏录制和多标签操作均不可靠。
Sublime Text 本身不支持批量自动排版多个文件——所有“一次格式化整个项目”的操作，都必须绕过 Sublime 内部机制，改用外部命令行工具或 Python 脚本驱动格式器（如 prettier、black）完成。
为什么不能直接用插件批量格式化？
Sublime 的主流格式化插件（如 JsPrettier、SublimeBlack）只响应单个当前激活视图的命令，不提供「遍历文件夹 + 匹配扩展名 + 逐个调用」的能力。即使你开了 format_on_save，它也只对「被保存过的文件」生效，不会主动扫描未打开的文件。
- 插件命令（如
js_prettier）默认只作用于当前 buffer，没有内置run_on_folder或apply_to_all_open_files参数 - 试图用宏录制「打开 → 格式化 → 关闭」流程会失败：宏无法自动打开任意路径下的文件，且跨文件操作在 Sublime 中不可靠
- 多标签页选中后运行格式化命令，仍只处理第一个 tab —— 这是 Sublime 命令调度机制决定的，不是插件缺陷
真正可行的批量排版方式：命令行 + 格式器 CLI
这是最稳定、可控、可复现的方式。核心逻辑是：跳过 Sublime，直接让 prettier、black 等工具读取磁盘文件并覆写。你只需确保它们已安装且路径可达。
- JS/TS/JSON：
prettier --write "src/**/*.{js,ts,jsx,tsx,json}" - Python：
black src/ tests/ --line-length=88（注意：路径末尾不加*，black自动递归） - 混合项目（如含 .vue + .py）：分两次跑，或用
find+xargs组合：find . -name "*.py" -exec black {} ; - 加保护：先用
--check模式预检（如prettier --check "src/**/*.js"），避免误改生产代码
Windows 用户特别注意的三个断点
很多“批量格式化失败”其实卡在环境链路上，不是命令写错。
-
prettier或black在 CMD/PowerShell 里能运行，但在 Sublime 控制台（Ctrl+`）里报command not found→ 说明 Sublime 没继承你的 shellPATH；需在 Sublime 的Preferences → Settings – User中显式补全："path": "C:\Users\xxx\AppData\Roaming\npm;C:\Python312\Scripts" - 路径含空格（如
C:Program Files odejsprettier.cmd）会导致调用崩溃 → 改用短路径（C:Progra~1 odejsprettier.cmd）或重装 Node 到无空格目录 - 文件编码为 GBK，但
prettier默认按 UTF-8 读 → 报错Invalid character；此时必须先转码：iconv -f GBK -t UTF-8 file.js | prettier --parser babel > file.js
如果非要在 Sublime 里触发批量操作，只能靠 Python 脚本桥接
你可以写一个极简脚本，放在 Sublime 的 Packages/User/ 下，用 subprocess 调用 CLI，并绑定快捷键。但要注意：这不是“Sublime 功能”，而是借壳执行命令行。
import subprocess
import os
import sublime
<p>class BatchFormatCommand(sublime.TextCommand):
def run(self, edit):
folder = os.path.dirname(self.view.file_name())</p><h1>示例：仅对当前文件所在目录下的 .js 文件格式化</h1><pre class="brush:php;toolbar:false;"> subprocess.run(["prettier", "--write", f"{folder}/*.js"])
然后在 Key Bindings – User 加：{"keys": ["ctrl+alt+shift+f"], "command": "batch_format"}。但该方案无法跨项目、不支持排除路径、错误也不反馈到 Sublime 面板——它只是把终端命令封装了一层。
真正需要批量排版时，别在 Sublime 界面里找按钮。打开终端，cd 到项目根目录，敲一行 prettier --write 或 black，才是最直接、最不容易出错的路径。其他方式，要么残缺，要么绕远，要么埋着编码/路径/权限的坑等你踩。
