快捷键失效主因是输入被系统/输入法/第三方工具劫持，或VS Code中语言模式错误、默认格式化器未配置、远程环境插件缺失；需逐层排查拦截点与上下文配置。
快捷键本身没坏，是绑定、拦截或上下文缺失导致它“按了等于没按”。
快捷键被系统或插件悄悄吞掉了
Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）按下去完全没反应，控制台也空空如也——说明按键根本没进 VS Code。这不是格式化逻辑的问题，而是输入被截断了。
- Windows 上搜狗、QQ 拼音常把
Shift+Alt绑定为中英文切换，关掉「快捷键上屏」或切回微软拼音标准模式 - macOS 要检查「系统设置 → 键盘 → 快捷键」里 Spotlight、输入源是否占用了
Cmd+Shift+F或Shift+Option+F - 远程桌面、Logitech Options、AutoHotkey 等工具也可能劫持，临时禁用后测试
- 在 VS Code 中按
Ctrl+Shift+P→ 运行Developer: Toggle Developer Tools，切到 Console 标签页再按快捷键，看是否有日志输出
快捷键绑对了但命令不执行
命令面板里能搜到 editor.action.formatDocument，快捷键也显示已绑定，可就是不干活。常见原因不是命令失效，而是它没“资格”运行。
- 右下角语言模式显示
Plain Text：点击它，手动选对语言（比如.ts文件必须设为TypeScript，不是JavaScript） -
editor.defaultFormatter配置为空或错误：必须填扩展 ID，例如 Prettier 是esbenp.prettier-vscode；填prettier或留空会静默失败 - 工作区配置覆盖了用户设置：检查
.vscode/settings.json里有没有"[javascript]": { "editor.formatOnSave": false }这类语言专属关闭项
想换快捷键？直接改命令绑定就行
Shift+Alt+F 不是硬编码，它只是默认绑给了 editor.action.formatDocument 命令。你可以安全替换，不用动任何插件或配置文件。
- 按
Ctrl+K Ctrl+S（Win）或Cmd+K Cmd+S（Mac）打开快捷键面板 - 搜索
format document，找到命令名为editor.action.formatDocument的那一项 - 点击右侧“+”号，按下你想设的新组合键（如
Ctrl+Shift+F） - 如果提示冲突，换一个（比如
Ctrl+Alt+L），改完立刻生效，无需重启
真正容易被忽略的是：远程开发（WSL/SSH）时，格式化扩展必须装在远程环境里，本地装的插件对远程文件完全无效。哪怕快捷键、配置、语言模式全对，只要扩展没在远程窗口里启用，editor.action.formatDocument 就只能返回静默失败。
