sublime text 保存自动格式化需插件配置且必须通过三关：环境路径对、语法识别对、文件扩展名对；缺一关则 auto_format_on_save 失效，常见原因包括右下角显示 plain text、prettier_cli_path 未正确配置、glob 通配符错误或语法模式不匹配。
Sublime Text 本身不自动排版、不自动格式化、不读取项目配置——所有“保存即美化”效果都来自插件手动配置，且必须过三关：环境路径对、语法识别对、文件扩展名对。少一关，auto_format_on_save 就是摆设。
JsPrettier 保存自动格式化为什么没反应？
不是插件坏了，是它根本没被触发。JsPrettier 默认只对 .js、.ts、.vue 等有限扩展名生效，且严格依赖当前文件的语法模式。
- 右下角显示 Plain Text 或 HTML？点它手动切到 JavaScript 或对应语言，否则插件跳过
-
auto_format_on_save_excludes如果写成"node_modules/**"，实际应为"*/node_modules/*"—— glob 通配符不支持** - macOS 用户常见 PATH 不一致：终端能跑
prettier --version，但 Sublime 找不到，必须硬填prettier_cli_path，比如/opt/homebrew/bin/prettier - 如果项目用了本地
prettier（npm install --save-dev prettier），路径得指向node_modules/.bin/prettier，Windows 注意用正斜杠或双反斜杠
HTML/CSS/JS 混写文件怎么安全格式化？
HTML-CSS-JS Prettify 对内联 <script></script> 或 <style></style> 容易误解析，尤其含模板字符串或 CSS 变量时；JsPrettier 则完全不处理 HTML 文件。
- 推荐拆分：把
<script>const html = `<div>${x}`</script>移到单独.js文件，再用 JsPrettier 处理 - 若必须保留混写，改用
JsBeautify（免 Node 依赖，装完即用），但需在设置里关掉"html": {"end_with_newline": false}，否则可能多删空行 - 禁用
auto_format_on_save对 HTML，只用快捷键临时触发：在 Key Bindings 用户配置中加{"keys": ["ctrl+alt+h"], "command": "html_css_js_prettify"}
Python 自动格式化总报 command not found: black？
Black Formatter 插件只是外壳，真正干活的是你本地装的 black 命令——它和 Python 环境强绑定，虚拟环境切换后极易失效。
- 先在终端确认：运行
which black（macOS/Linux）或where black（Windows），把输出路径填进插件 Settings 的black_cmd_path - 如果用 pyenv 或 conda，确保当前 shell 激活的是项目环境，再装
pip install black - 别信“全局安装就万事大吉”：Sublime 启动时可能加载系统 Python，而
black装在 venv 里，路径必须显式指定 -
custom_file_extensions必须包含"py"，否则即使文件是.py后缀，插件也不响应
AlignTab 对齐等号为什么 Ctrl+Alt+A 没反应？
ST4 用户别碰 Alignment——作者已停更，API v4 不兼容，装了也白装。AlignTab 是唯一可靠选择，但它的触发逻辑很“刚”。
- 快捷键必须写在 Preferences → Key Bindings – User，不能写在插件自带配置里
-
"user_input": "="只匹配等号；要同时对齐=和:，得写"user_input": "=|:"，注意|不用转义（AlignTab 内部用的是字符串匹配，不是正则） - 对齐前务必统一缩进：选中代码 → Convert Indentation → Convert to Spaces，否则混合 Tab/Space 会导致错位
- 禁用
auto_save：否则格式化插件可能在你手动对齐后立刻重写缩进，白干
最常被忽略的其实是语法识别链：文件后缀 → 右下角语言模式 → 插件支持列表 → 环境命令可达性。四个环节任一断裂，自动排版就静默失效，连错误提示都不会弹。
