先确认按键是否进到VS Code:若Developer Tools控制台无日志,说明系统层已截断;再检查语言模式与defaultFormatter是否匹配,二者缺一不可。

快捷键按了完全没反应:先确认按键是否进到 VS Code
VS Code 根本收不到按键,就谈不上格式化逻辑。这不是插件或配置的问题,而是输入在系统层就被截断了。
打开命令面板 Ctrl+Shift+P(Win)或 Cmd+Shift+P(Mac),运行 Developer: Toggle Developer Tools,切到 Console 标签页,再按一次 Shift+Alt+F(Win/Linux)或 Shift+Option+F(Mac)。如果控制台空空如也,说明按键根本没送达编辑器。
- Windows 上搜狗、QQ 拼音默认用
Shift+Alt切中英文,进「设置 → 时间和语言 → 语言 → 键盘 → 输入法热键」关掉 - macOS 要检查「系统设置 → 键盘 → 快捷键」里 Spotlight、辅助功能、输入源是否占用了
Cmd+Shift+F或Shift+Option+F - 远程桌面、Logitech Options、AutoHotkey、PicGo 等工具常全局劫持组合键,临时退出再试
快捷键变灰或点不动:语言模式和 defaultFormatter 没配对
右下角显示 Plain Text 或错配成 JSONC(而你写的是 .ts),editor.action.formatDocument 命令压根不会注册,快捷键自然不可用。
- 点击右下角语言标识 → 手动输入真实语言名,如
vue、typescriptreact、python - 检查
settings.json是否写了"[vue]": { "editor.defaultFormatter": "Vue.volar" }—— 注意引号、大小写、ID 是否与扩展一致 - 运行
Ctrl+Shift+P→ 输入Format Document With...,列表为空说明语言识别失败或 formatter 未启用
报 “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(pnpm/yarn)而非全局路径 - Vue/HTML/Markdown 需额外插件支持:
prettier-plugin-html要装进devDependencies,且在prettier.config.js中显式启用
keybindings.json 里藏着带减号的禁用项
很多人复制粘贴快捷键配置时,不小心引入了 {"key": "shift+alt+f", "command": "-editor.action.formatDocument"} 这种带减号的条目——它不是重绑定,而是显式禁用。
- 按
Ctrl+K Ctrl+S(Win/Linux)或Cmd+K Cmd+S(Mac)打开快捷键界面,搜索format document - 点击右上角「打开键盘快捷方式 JSON」图标,检查
keybindings.json是否存在带-前缀的命令项 - 删掉可疑项,保存后无需重启,VS Code 会立即重新加载绑定
最容易被忽略的其实是语言模式和 defaultFormatter 的双重校验:VS Code 不会退而求其次,它要么严格匹配,要么直接放弃。哪怕你装了十个格式化插件,只要当前文件的语言 ID 和配置里的 key 对不上,就等于没装。


















