sublime text 本身不支持一键格式化，需依赖插件；装插件后快捷键无效常见原因包括未重启软件、语法识别为plain text、快捷键冲突、插件未加载或配置路径错误。
Sublime Text 本身没有“一键格式化”功能，按 Ctrl+Shift+I 或 Ctrl+Alt+F 默认不会有任何反应——这不是你装错了，是它原生就不支持。
为什么装了插件还按不动快捷键？
常见现象：装完 HTML-CSS-JS Prettify 或 JsPrettier，按 Ctrl+Shift+H 或 Ctrl+Alt+F 没反应，状态栏一闪就消失。
- 没重启 Sublime：插件安装或配置修改后必须完全退出再重开，不热重载
- 语法识别错误：右下角显示
Plain Text而不是JavaScript/HTML，插件直接跳过；手动点右下角切换，或先保存为.js/.html后缀 - 快捷键被占：
Ctrl+Shift+H常被 Emmet 或 SideBarEnhancements 占用；打开Preferences → Key Bindings，右侧搜ctrl+shift+h，删掉冲突项，或换用ctrl+shift+a - 命令未注册：插件安装后没生效，可手动调用验证——按
Ctrl+Shift+P输入JsPrettier回车，看是否执行；若不执行，说明插件根本没加载成功
不同语言该用哪个插件？别混着配
一个插件通吃所有语言？不行。选错插件，轻则无效，重则把 f-string 或类型注解格式化出错。
-
JavaScript/TypeScript：用JsPrettier（依赖本地prettierCLI），别用JsFormat——后者不支持现代语法，且已多年未维护 -
Python：用Black插件，禁用autopep8；后者对:=海象运算符、Literal类型等解析失败，容易报invalid syntax -
HTML/CSS/JS 混合（如普通 HTML 文件）：可用HTML-CSS-JS Prettify，但遇到.vue或.svelte单文件组件会乱缩进，此时应关掉自动触发，只手动选中代码块再执行 -
SQL：装SQL Beautifier，快捷键是Ctrl+K然后Ctrl+F（注意是两步，不是同时按）
怎么配对快捷键才真正生效？
不能只复制网上的 JSON 片段就粘贴保存——上下文匹配和作用范围决定它能不能触发。
- 必须加
context限定：比如只在 JS 文件里响应Ctrl+Alt+F，就得写"selector": "source.js"；否则在 Python 文件里也触发，结果报错 - 推荐显式启用选区模式：加
"selection_empty": true表示“仅当没选中内容时才全文件格式化”，避免误操作把注释块或模板字符串也重排 - Windows 用户注意扩展名：配置
prettier_cli_path时，值必须是绝对路径 +.cmd，例如C:\Users\xxx\AppData\Roaming\npm\prettier.cmd；填prettier或留空，一定失败 - Mac/Linux 用户注意路径来源：运行
which prettier，别信/usr/local/bin/prettier——M1 Mac 上很可能是/opt/homebrew/bin/prettier
选中代码块再格式化，比全文件更稳
新手常全选 Ctrl+A 再按格式化，结果把 /* prettier-ignore */ 注释删了、引号风格翻转、JSON 字符串换行错乱。
-
JsPrettier和Black都支持选区格式化：先用Ctrl+鼠标拖选或Shift+方向键选中一个函数、对象字面量或 CSS 规则块，再调命令，其余部分完全不动 - Vue/Svelte 中处理
<script></script>块时，务必只选中 script 内容，别连<template></template>一起选——HTML-CSS-JS Prettify会把它当 HTML 解析，缩进全崩 - 格式化前检查当前光标位置：如果光标落在注释行或空行，某些插件会拒绝执行，建议先把光标移到有效代码行内
最易被忽略的一点：插件配置改完后，必须彻底退出 Sublime 再重开；很多人改了 prettier_cli_path 却只用 Ctrl+Shift+P → Reload Packages，这不起作用——路径加载发生在启动阶段。
