Sublime Text 本身无内置格式化功能，必须安装对应插件（如JsPrettier、Black、HTML-CSS-JS Prettify）并配置外部工具（prettier、black等）、语法识别、绝对路径及作用域快捷键，缺一不可。
Sublime Text 本身不带内置代码格式化功能，所谓“一键格式化”必须依赖插件 + 正确配置，否则按 Ctrl+Shift+P 搜到的 Format Code 命令根本不会出现，或者点了没反应。
为什么装了 JsFormat 或 HTML-CSS-JS Prettify 还是不能格式化？
常见原因是：插件未绑定到快捷键、未正确识别文件类型、或缺少对应语言的外部格式化器（比如 prettier、js-beautify）。Sublime 不像 VS Code 那样自动下载依赖，它只负责调用命令——如果系统里没装 prettier，HTML-CSS-JS Prettify 就会静默失败。
- 检查终端能否运行
prettier --version（JS/TS/JSON）或black --version（Python），不能就先用npm install -g prettier或pip install black - 确认当前文件已正确设置语法类型：右下角应显示
JavaScript、Python等，而不是Plain Text；点一下手动选对 -
HTML-CSS-JS Prettify的配置文件Prettify.sublime-settings中，"prettier_cli_path"必须填绝对路径（如/usr/local/bin/prettier），不能写prettier
如何给不同语言绑定不同的格式化快捷键？
Sublime 允许按作用域（scope）区分快捷键，比如让 Ctrl+Alt+F 在 JS 文件中调用 Prettier，在 Python 文件中调用 Black，互不干扰。
- 打开
Preferences → Key Bindings，在右侧用户键位文件中添加： [ { "keys": ["ctrl+alt+f"], "command": "prettier", "args": {"auto_save": false}, "context": [ { "key": "selector", "operator": "equal", "operand": "source.js, source.jsx, source.ts, source.tsx" } ] }, { "keys": ["ctrl+alt+f"], "command": "black", "context": [ { "key": "selector", "operator": "equal", "operand": "source.python" } ] } ]- 注意
context是关键：没有它，快捷键会在所有文件里生效，而 Python 插件遇到 JS 代码大概率报错退出
FormatOnSave 自动格式化为什么有时失效？
不是所有插件都支持保存时触发，且触发时机受文件编码、BOM、行尾符影响。比如 JsFormat 默认不监听保存事件，必须手动改配置；而 Sublime-Black 的 "format_on_save" 开关只对 .py 文件有效，对 .pyi 或无后缀脚本无效。
- 启用前先确认插件是否原生支持：查 GitHub 主页 README 里有没有
format_on_save配置项 - 某些项目用
pyproject.toml控制 Black 行为，但 Sublime 插件默认不读它——得在插件设置里显式指定"black_args": ["--config", "pyproject.toml"] - 如果保存后内容变乱（比如缩进全塌），大概率是插件和编辑器 tab width 冲突：确保
detect_indentation设为false，并在插件配置里硬编码"indent_size": 2
真正稳定的“一键格式化”，本质是把每种语言的格式化命令、路径、参数、作用域边界都对齐一次。漏掉任意一环，就会出现“明明装了插件却按了没反应”的情况——这不是软件问题，是链路没串通。
