VSCode格式化需同时满足触发入口、格式化器可用性、语言上下文三条件；否则快捷键静默失败。常见原因包括焦点不在编辑器、when表达式缺失或错误、系统/输入法劫持、命令ID拼错等。
VSCode 自定义格式化不是改个快捷键就完事，而是“触发入口 + 格式化器可用性 + 语言上下文”三者必须同时满足；否则按了 Shift+Alt+F 或自定义键，大概率静默失败或弹出“没有可用的格式化程序”。
为什么自定义快捷键后格式化没反应？
常见现象是按键按下后无任何反馈，甚至不报错。这不是 VSCode 崩了，而是快捷键根本没走到格式化逻辑里。
- 当前焦点不在编辑器：比如你在终端、设置页、搜索框里按了键，
editorTextFocus条件不满足，命令直接被跳过 -
when表达式写错或缺失：例如只写了{"key":"ctrl+alt+f","command":"editor.action.formatDocument"}，没加"when": "editorTextFocus"，那它可能在不该触发的地方报错，或在该触发时被其他更高优先级规则压制 - 系统/输入法劫持：Windows 上搜狗拼音常吞掉
Ctrl+Shift+P，Mac 上某些触控板手势会拦截Cmd+Option+F；建议用原生输入法测试 - 命令 ID 拼错：比如写成
editor.formatDocument（少action.）或format_on_save（VSCode 不认这种命名），VSCode 不报错但也不执行
如何安全添加带条件的格式化快捷键？
图形界面（Ctrl+K Ctrl+S）适合临时调整，但要真正控制触发场景，必须编辑 keybindings.json。
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: Open Keyboard Shortcuts (JSON)回车 - 确保数组结构正确：整个文件是 JSON 数组，每条规则是对象，末尾不能多逗号
- 必填字段：
"key"（如"ctrl+shift+f"）、"command"（推荐右键图形界面中对应命令 → “复制命令 ID”获取）、"when"（至少写"editorTextFocus"） - 想只在 JavaScript 文件生效？用
"when": "editorTextFocus && editorLangId == 'javascript'"；注意语言 ID 是小写，且不含空格 - 禁用某默认键？别删，写
{"key":"shift+alt+f","command":"unset"}，更稳妥
格式化行为不一致？重点看这三个配置项
快捷键只是开关，真正决定输出结果的是 settings.json 里的三处配置，它们之间有优先级关系。
-
"editor.formatOnSave": true是全局开关，但单独开它没用——VSCode 还不知道该调谁 -
"editor.defaultFormatter": "esbenp.prettier-vscode"必须填对扩展 ID，填错（比如漏掉-vscode）或没装插件，保存时就会卡顿半秒再放弃 - 语言专属配置优先级更高：
"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }会覆盖全局defaultFormatter，但不会影响[javascript]文件 - 项目级配置（如
.prettierrc）和编辑器配置冲突时，VSCode 默认以项目配置为准；若tabWidth设为 2，但editor.tabSize是 4，格式化后立刻被重排，看起来像“格式化失效”
远程开发（SSH/WSL）下格式化为何失灵？
VSCode 的格式化器运行在“代码所在环境”，不是本地机器。你在本地装了 Prettier 插件，但文件在 WSL 里打开，格式化请求发往的是 WSL 环境，本地插件完全不参与。
- 检查右下角语言模式旁是否有
SSH: xxx或WSL: Ubuntu标识 - 在远程环境中重新安装格式化插件：点击扩展视图左下角远程按钮 → “Install in SSH: xxx”
- 远程环境的
settings.json独立于本地，需单独配置editor.defaultFormatter和formatOnSave - 如果远程没装 Node.js，Prettier 就跑不起来；
black则要求远程 Python 环境里已安装black包（不只是插件）
最常被忽略的一点：格式化不是“一次配好就永远有效”。插件升级可能改 command ID，系统更新可能调整热键拦截逻辑，团队协作时更要确认 settings.json 和项目配置文件是否真正对齐——而不是只盯着快捷键有没有按响。
