VSCode格式化快捷键无反应，90%是按键未送达或格式化链路中断。需依次检查：按键是否被系统/输入法拦截；右下角语言模式是否正确；是否存在“No formatter installed”提示及对应插件、路径、权限问题；keybindings.json中是否误删绑定。
VSCode格式化快捷键没反应，90% 不是 VS Code 坏了，而是按键根本没传到编辑器里，或格式化链路在某个环节断了。
快捷键按下后完全无反应？先看按键是否送达
这是最常被忽略的第一步。VS Code 没收到按键，后续所有排查都白搭。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Developer: Toggle Developer Tools，打开控制台 - 再按一次
Shift+Alt+F（Win）或Shift+Option+F（macOS）——如果控制台 没有任何日志输出，说明系统/输入法/其他软件已拦截该组合键 - Windows 上重点关掉搜狗、微软拼音的「Shift+Alt 切换中英文」；macOS 上检查「系统设置 → 键盘 → 快捷键 → Spotlight」是否占用了
Cmd+Shift+F - 临时禁用所有非必要后台工具：PowerToys、Alfred、Raycast、Logitech Options、AutoHotkey 脚本
右下角语言模式显示 Plain Text？格式化直接被禁用
VS Code 只对明确识别的语言启用格式化功能。状态栏显示 Plain Text 或 Unknown，Shift+Alt+F 就会静默失效，不报错也不执行。
- 点击右下角语言标识，手动选对语言（例如
.ts文件必须选TypeScript，不是JavaScript） - 检查文件后缀是否被正确关联：在
settings.json中确认"files.associations"是否写了"*.vue": "vue"这类映射 - 运行
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，看右上角显示的languageId是什么（比如是typescriptreact而非typescript），再核对editor.defaultFormatter是否按这个 ID 配置
弹出 “No formatter installed for 'xxx'”？路径、权限、插件三者缺一不可
这个提示说明 VS Code 认出了语言，但找不到能干活的格式化程序。常见于 Prettier、Black、ESLint 等依赖 CLI 的工具。
- 在终端中运行
which prettier（macOS/Linux）或where prettier（Windows），结果必须非空；为空说明全局未安装或 PATH 未生效 - 检查扩展是否启用：打开
Ctrl+Shift+X，搜esbenp.prettier-vscode，确认状态不是「工作区禁用」 - 项目级配置可能覆盖：查看项目根目录下的
.vscode/settings.json，是否存在"editor.defaultFormatter": null或"[html]": { "editor.formatOnSave": false }这类显式禁用项 - 某些格式化器需额外插件支持：比如 Prettier 处理 HTML，必须装
prettier-plugin-html并在prettier.config.js中启用plugins: ['prettier-plugin-html']
keybindings.json 里有减号？等于主动废掉快捷键
很多人自己改过快捷键后忘记清理，导致命令被显式取消绑定。
- 按
Ctrl+K Ctrl+S（Win）或Cmd+K Cmd+S（macOS）打开快捷键面板，搜索editor.action.formatDocument - 打开
keybindings.json（通过Preferences: Open Keyboard Shortcuts (JSON)），查找是否含"-editor.action.formatDocument"——开头那个减号就是“取消绑定”，相当于把快捷键删了 - 检查
when条件是否过于严格：比如写了"when": "editorTextFocus && editorLangId == 'javascript'，那在 TypeScript 文件里就永远不会触发 - Mac 用户注意：
Shift+Alt+F在 macOS 对应的是Shift+Option+F，别在 Windows 习惯下误查Alt键
真正卡住的地方，往往不是“怎么配”，而是“谁在悄悄关掉它”——输入法劫持、工作区设置覆盖、语言 ID 匹配偏差、甚至 prettierPath 指向了一个已卸载的全局版本。每一步都要验证，而不是跳着配。
