Sublime Text 本身无智能自动排版能力，所有“保存即整齐”“一键重排结构”均依赖插件调用外部 CLI 工具（如 prettier、black）实现，任一环节（工具未安装、路径错误、语法识别失败、配置遗漏）都会导致格式化静默失效。
Sublime Text 本身不提供智能自动排版能力，所有“保存即整齐”“一键重排结构”的效果，都依赖插件调用外部 CLI 工具（如 prettier、black、sqlformat）完成。没装对工具、路径不对、语法识别错、配置漏项，任意一环断掉，format_on_save 就静默失效——不是插件坏了，是链路卡在了你看不见的地方。
为什么 Ctrl+Alt+L 按了没反应？常见断链点
这不是快捷键没绑好，而是底层调用根本没跑起来：
-
prettier或black在终端能执行，但在 Sublime 控制台（Ctrl+`）里运行import subprocess; subprocess.run(['prettier', '--version'])报错 → 说明 Sublime 没读到你的$PATH；macOS/Linux 需在Preferences → Settings – User里显式加"path": "/opt/homebrew/bin:/usr/local/bin"；Windows 要确认C:\Users\XXX\AppData\Roaming\npm已进系统环境变量，并重启 Sublime - 右下角状态栏显示的是
Plain Text或HTML，不是JavaScript或Python→ 插件压根不触发；必须手动点击语言名切换 - 快捷键绑错了作用域：比如全局绑定
ctrl+alt+l，但打开.json文件时调了black直接报错退出；正确做法是在Key Bindings – User里按语言限定：{"keys": ["ctrl+alt+l"], "command": "js_prettier", "context": [{"key": "selector", "operator": "equal", "operand": "source.js"}]}
Sublime-Code-Formatter 怎么配 Python/JS/TS
它不自带格式器，只做调度，配置必须显式指定命令和参数：
- Python 默认找
autopep8，但你装的是black？得改配置项python_formatter为black，且确保black --version可执行；推荐命令：["black", "-q", "-"]，format_stdin必须设为true，否则读不到当前文件内容 - JS/TS 默认走
prettier，但如果项目根目录有.prettierrc，插件会自动加载；没配的话，团队协作容易格式不一致 —— 别跳过prettier --check这类 CI 步骤 - Windows 用户注意：
prettier.cmd路径含空格（如C:\Program Files\nodejs\prettier.cmd）会导致调用失败，要么重装 Node 到无空格路径，要么用短路径（C:\Progra~1\nodejs\prettier.cmd）
format_on_save 为什么总出问题？三关必须全过
开这个开关前必须过三关，少一关就白配：
-
format_on_save_extensions必须精确匹配扩展名，比如写成["js", "ts"]，但文件是.tsx就不会触发；Vue 单文件组件需额外加"vue" - 插件配置里
auto_format_on_save默认是false，想“保存即格式化”得手动打开；但更推荐保持关闭，避免误触保存污染代码风格 - 文件语法必须正确识别（右下角显示
source.python而非Plain Text），且缩进统一（全空格或全 Tab），否则格式器可能拒绝处理
软换行（word_wrap）和真正排版是两回事
很多人混淆了“视觉折行”和“代码重排”：
-
"word_wrap": true和"wrap_width": 80只控制显示层折行，不修改文件内容；设为0表示自适应窗口宽度，适合代码文件 -
reindent是 Sublime 内置命令，只做基础缩进对齐，不会改括号位置、不调整运算符换行、不统一引号；它只在语法识别正确、缩进统一、且trim_automatic_whitespace关闭时才生效 - 若你希望长字符串第二行缩进对齐，可加
"indent_subsequent_lines": true，但它只在wrap_width为数字时起作用，且对 JSON/YAML 等缩进敏感格式慎用
最常被忽略的点：所有格式化插件都依赖外部 CLI 工具的可用性，而 Sublime 的 PATH 加载逻辑和终端不一致；别只在 shell 里验证 which prettier，一定要在 Sublime 控制台里用 subprocess 实测调用是否成功。
