sublime text 不能直接调用 brotli 命令行工具，需先确保系统已安装 brotli 并加入 path，再通过自定义 build system 调用；推荐使用 shell_cmd 集成而非第三方插件，以保障参数支持与稳定性。
Sublime Text 能不能直接调用 Brotli 命令行工具
不能——Sublime Text 本身不内置 Brotli，也不提供图形化压缩界面。它只能通过外部命令集成来触发 brotli、unbrotli 或 brcat。关键不是“能不能装”，而是“怎么让编辑器可靠地调用系统已安装的 Brotli 工具”。
确保系统已正确安装并可全局调用 brotli
如果终端里执行 brotli --version 报错“command not found”，后续所有集成都会失败。这不是 Sublime 的问题，是环境缺失。
- Debian/Ubuntu 用户必须运行
sudo apt install brotli（仅靠 Package Control 安装 Python 的brotli包没用，那只是解压库，不是命令行工具） - macOS 用户用 Homebrew：确认
brew install brotli成功后，检查which brotli输出是否在/usr/local/bin/brotli或/opt/homebrew/bin/brotli；若不在 PATH 中，需手动补进 shell 配置文件 - Windows 用户需额外把 brotli.exe 所在目录加入系统环境变量 PATH，否则 Sublime 启动的子进程找不到该命令
用 Build System 实现单文件快速压缩/解压
这是最轻量、最可控的方式，不依赖插件，适合日常调试和批量预处理静态资源。
新建 Build System（Tools → Build System → New Build System…），粘贴以下内容：
{
"shell_cmd": "brotli -q 11 -k \"$file\"",
"file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "$file_path",
"selector": "source",
"variants": [
{
"name": "Decompress",
"shell_cmd": "brotli -d -k \"$file\""
}
]
}
保存为 Brotli.sublime-build。注意几点：
-
-k保留原文件，避免误删；如需覆盖压缩并删源，改用--rm - 解压变体用
-d，但不会自动去掉.br后缀——Brotli 默认输出同名文件（如style.css.br解压为style.css），前提是输入文件名带.br - 若当前打开的是
script.js.br，选中 “Decompress” 变体即可原地还原；若打开的是index.html，则执行压缩生成index.html.br
为什么不用第三方 Brotli 插件
社区有叫 BrotliCompressor 或类似名字的 Package Control 插件，但实际踩坑率高：
- 多数只封装了 Python
brotli库，不调用系统brotli，导致无法使用-w（窗口大小）、-D（自定义字典）等关键参数 - 硬编码路径，Linux/macOS 下常因权限或沙盒限制静默失败，错误也不报到面板上
- 不兼容 Sublime Text 4 的新 API（如
view.file_name()在某些版本返回None），一保存就崩溃
真正稳定的做法，是守住「系统命令 + Build System」这条线——它不抽象、不黑盒、出错时终端输出一目了然。压缩逻辑复杂时，宁可写个 shell 脚本丢进 shell_cmd，也别赌一个维护停滞的插件。
