Sublime Text 保存时自动格式化需安装插件（如 Sublime-Code-Formatter 或 JsPrettier），配置对应 on-save 选项并指定文件扩展名，确保依赖 CLI 工具就位且路径正确。
Sublime Text 本身不内置代码格式化功能，OnSaveFormat 也不是原生配置项——它来自第三方插件 JsPrettier、Sublime-Code-Formatter 或 HTML-CSS-JS Prettify 等。直接在设置里写 "on_save_format": true 不会生效。
怎么让 Sublime 在保存时自动格式化 JS/TS/HTML/CSS？
核心路径是：装对插件 → 配置插件的保存钩子 → 指定格式化命令和文件类型。最稳定通用的选择是 Sublime-Code-Formatter（支持多语言，依赖外部工具少）或 JsPrettier（JS/TS 强依赖 Prettier CLI）。
- 推荐优先试
Sublime-Code-Formatter：它自带 Python/JS/HTML/CSS 格式化逻辑，无需全局安装prettier或black，开箱即用 - 如果项目已用
prettier，且希望保持团队一致，选JsPrettier，但必须确保本地有prettierCLI 可执行（npm install -g prettier或项目级node_modules/.bin/prettier） - 装完插件后，必须重启 Sublime，否则
Preferences → Package Settings里看不到对应菜单
Sublime-Code-Formatter 的 OnSave 配置怎么写？
该插件通过 format_on_save 控制是否启用保存时格式化，但默认是关闭的。需手动编辑其用户配置：
- 菜单栏打开
Preferences → Package Settings → Sublime Code Formatter → Settings – User - 填入如下内容（注意缩进是 JSON，不能用 tab）：
{
"format_on_save": true,
"format_on_save_extensions": [
"js", "jsx", "ts", "tsx", "html", "css", "scss", "json", "py"
],
"jsmax_preserve_newlines": false
}
-
format_on_save_extensions必须显式列出你要格式化的后缀，空数组或不写则不生效 - Python 文件若想用
black格式化，得额外配"python_formatter": "black"并确保black已安装且在 PATH 中 - 如果保存后没反应，检查右下角状态栏是否显示 “Formatting…” —— 没显示说明插件根本没触发，大概率是文件扩展名不匹配或插件未激活
JsPrettier 保存自动格式化常见失败原因
JsPrettier 更易出问题，因为高度依赖外部环境。典型报错如：prettier command not found 或 Cannot find module 'prettier'。
- 确认
prettier是全局安装（npm install -g prettier），或在项目根目录存在node_modules/prettier - 在
Preferences → Package Settings → JsPrettier → Settings – User中加：
{
"auto_format_on_save": true,
"auto_format_on_save_excludes": ["*/node_modules/*", "*/dist/*"],
"prettier_cli_path": "/usr/local/bin/prettier"
}
-
prettier_cli_path在 macOS/Linux 下常用/usr/local/bin/prettier，Windows 下可能是C:\\Users\\xxx\\AppData\\Roaming\\npm\\prettier.cmd；用which prettier或where prettier查准路径 - 如果项目用 pnpm/yarn，且
prettier在node_modules里，JsPrettier默认找不到，必须配node_path指向项目node_modules/.bin - 不要同时启用
Sublime-Code-Formatter和JsPrettier的on_save，会冲突导致格式化两次或失败
真正麻烦的不是配置项本身，而是插件背后依赖的 CLI 工具是否就位、路径是否正确、权限是否允许执行——这些错误不会弹窗提示，只会静默跳过格式化。建议先手动运行一次 Ctrl+Shift+P → Format Code，确认能成功，再打开 OnSave。
