真正卡住快捷键的是when条件错误、defaultformatter未配准或系统/输入法劫持键位；需检查三类配置：when条件、editor.defaultformatter扩展id、语言专属设置，并确保远程开发时插件装在远程环境。
直接改快捷键不解决问题，真正卡住你的是 when 条件没写对、editor.defaultFormatter 没配准、或者系统/输入法把键劫走了。
为什么按了自定义快捷键却没反应
不是 VS Code 坏了，而是它根本没收到“该我干活”的信号。常见原因有三个：
-
when条件太松或太紧：比如只写"when": "editorTextFocus"，那在终端里按也会触发；但若写成"when": "editorHasSelection && editorTextFocus"，没选中代码就完全静默 - 快捷键被系统级热键覆盖：Windows 上搜狗输入法默认用
Shift+Alt切换中英文，Mac 上 Spotlight 默认占Cmd+Space，而Shift+Option+F也常被系统截图工具拦截 - 扩展冲突：多个格式化插件（如 Prettier + Beautify + ESLint）同时注册了
editor.action.formatDocument，VS Code 不知道听谁的，干脆不响
怎么让 F1 / Ctrl+F 真正可用
别只改 key，必须补全 command 和 when，否则就是“看起来配了，实际按了没反应”。推荐这两组实测有效的配置：
方案一（功能键，适合不常按 F1 的人）：
[<br> {<br> "key": "f1",<br> "command": "editor.action.formatSelection",<br> "when": "editorTextFocus && editorHasSelection"<br> },<br> {<br> "key": "shift+f1",<br> "command": "editor.action.formatDocument",<br> "when": "editorTextFocus && !editorHasSelection"<br> }<br>]
方案二（Ctrl+F，避开输入法劫持）：
[<br> {<br> "key": "ctrl+f",<br> "command": "editor.action.formatSelection",<br> "when": "editorTextFocus && editorHasSelection"<br> },<br> {<br> "key": "ctrl+shift+f",<br> "command": "editor.action.formatDocument",<br> "when": "editorTextFocus && !editorHasSelection"<br> }<br>]
注意：ctrl+shift+f 在 Windows 默认是全局搜索，如果冲突，可先在系统设置里关掉「在文件资源管理器中打开搜索」。
格式化结果不一致？关键看这三个配置项
快捷键只是门铃，真正干活的是背后这三样东西：
-
editor.defaultFormatter：必须填扩展 ID，不能填名字。例如 Prettier 是esbenp.prettier-vscode，Volar 是Vue.volar，填错就静默失败 -
[javascript]或[typescript]语言专属设置：它们会覆盖全局设置。比如你全局开了formatOnSave，但在[typescript]里写了"editor.formatOnSave": false，那 .ts 文件就永远不自动格式化 -
html.format.*类设置：对.vue或.html文件影响极大。Vetur 要靠vetur.format.defaultFormatter.html指定用js-beautify-html；Volar 则忽略这个，只认prettier.config.js或html.format.wrapLineLength
别碰 editor.formatOnSave 就完事了
很多人以为开这个就一劳永逸，结果保存时代码来回跳、分号忽有忽无——其实是 Prettier 和 ESLint 在打架。正确做法是：
- 明确分工：Prettier 只管样式（缩进、空格、换行），ESLint 只管逻辑（未定义变量、
console检查） - 禁用 Prettier 对 ESLint 已控项的干预：
"prettier.semi": false、"prettier.singleQuote": false - 把修复动作交给 ESLint：
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，而不是靠 format - 绝对别开
editor.formatOnPaste：粘贴一段 JSX 或 Vue 模板时，它会强行重排，破坏语义结构
最易被忽略的一点：远程开发（SSH/WSL）时，格式化扩展必须装在远程环境里，本地装了等于没装——右下角语言模式显示正常，但按快捷键就是没反应，十次有九次栽在这儿。
