先启动Developer: Toggle Keybinding Troubleshooter——按Ctrl+Shift+P输入并执行该命令，再按目标快捷键（如Shift+Alt+F），面板中带▶的绿色条目即为实际生效命令及来源扩展；灰色条目仅表示when条件不满足，非失效主因。
按快捷键没反应？先启动按键排查器
VS Code 自带的 Developer: Toggle Keybinding Troubleshooter 是唯一直接看到“谁在抢键”的工具。它不靠猜，而是你一按 Shift+Alt+F（Windows/Linux）或 Shift+Command+F（macOS），就立刻列出所有匹配命令、来源扩展、when 条件是否满足，以及有没有被覆盖。
实操建议：
- 按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入并执行该命令 - 立刻按下你的格式化快捷键（比如
Shift+Alt+F） - 看面板里带 ▶ 的绿色条目——那是真正在执行的；灰色条目只是条件不满足（比如当前焦点不在编辑器），不是失效
- 重点检查命令 ID 是否为
editor.action.formatDocument，如果不是，说明被别的扩展劫持了（常见如 GitLens、Prettier 插件早期版本、Remote - SSH）
keybindings.json 里藏着静默失效的坑
手动改过 keybindings.json 却没生效？大概率栽在三个地方：JSON 语法错误、when 表达式拼错、或者减号规则写法不对。VS Code 对这些错误完全不报错，直接整条忽略，你根本不知道它早就不干活了。
实操建议：
- 务必通过
Ctrl+K Ctrl+S→ 右上角「打开键盘快捷方式(JSON)」入口编辑，别手写路径或复制粘贴到错误文件 - 想禁用某个扩展的绑定，必须写成完整减号规则：
{"key":"shift+alt+f","command":"-gitlens.showQuickFileHistory"}，command字段不能为空或null -
when条件要严格匹配，比如"editorTextFocus && editorLangId == 'javascript'"，少个s（如editorTextFocu）就静默失效 - 改完保存，无需重启，但若涉及远程窗口或焦点切换，可执行
Developer: Reload Window确认
语言模式错配会让 format 命令根本注册不上
右下角显示 Plain Text 或 HTML 却编辑的是 .vue 文件？那 editor.action.formatDocument 命令压根不会被 VS Code 注册，快捷键自然灰色或无响应——这不是快捷键问题，是功能入口都没打开。
实操建议：
- 点击右下角语言标识，手动选对真实语言 ID（比如
vue、typescriptreact、jsonc） - 验证是否成功：按
Ctrl+Shift+P→ 输入Format Document With…，列表非空才说明语言识别到位 - 长期方案是在
settings.json中加"files.associations": { "*.vue": "vue", "*.ts": "typescript" }，避免每次手动切 - 注意大小写和拼写：
"[vue]": { "editor.defaultFormatter": "Vue.volar" }里的Vue.volar必须和扩展 ID 完全一致（可在扩展页 URL 或package.json中确认）
No formatter installed for 'xxx' 其实是路径或配置断链
这个提示常让人误以为“没装插件”，其实 VS Code 已识别语言，只是找不到能执行格式化的可执行体。尤其在用 Prettier、Black、gofumpt 这类 CLI 工具时，路径解析失败非常隐蔽。
实操建议：
- 在终端运行
which prettier（macOS/Linux）或where prettier（Windows），结果必须非空；若为空，重装时勾选「Add to PATH」 - 检查项目级配置：
prettier.prettierPath是否指向一个真实存在的路径，比如"./node_modules/.bin/prettier"而不是全局安装路径 - Vue/HTML/Markdown 等非 JS/TS 语言，仅装
esbenp.prettier-vscode不够，还需npm install --save-dev prettier-plugin-html并在prettier.config.js中启用 - 确认
editor.defaultFormatter在对应语言专属设置里已明确指定，不能只写全局值，也不能留空
最易被忽略的点：系统输入法（尤其是 Windows 的搜狗、QQ 拼音）默认把 Shift+Alt 绑定为中英文切换，它根本不会把组合键传给 VS Code——这时候再怎么调 keybindings.json 都没用。
