先启动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 注册，快捷键自然灰色或无响应——这不是快捷键问题，是功能入口都没打开。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

实操建议：

• 点击右下角语言标识，手动选对真实语言 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 都没用。