vscode格式化失效主因是快捷键未进入编辑器、语言模式识别错误（如显示plain text）、格式化器未正确绑定；需依次排查系统/输入法劫持、手动切换语言模式、验证formatter路径及配置覆盖。
VSCode格式化失效不是插件坏了，而是三个环节断链：快捷键没进编辑器、语言模式没认对、格式化器没绑上。 临时救急能立刻恢复排版，但不解决根本——你按 Shift+Alt+F 没反应，大概率不是配置问题，是输入被系统吞了，或右下角显示 Plain Text。
快捷键按了完全没反应？先查输入是否进到 VS Code
控制台空空如也，说明组合键根本没触发任何命令。这不是格式化逻辑的问题，是操作系统或外设截胡了。
- Windows 上搜狗、QQ 拼音默认用
Shift+Alt切中英文，关掉「快捷键上屏」或切回微软拼音 - macOS 检查「系统设置 → 键盘 → 快捷键」里 Spotlight、辅助功能、输入源是否占用了
Shift+Option+F - 远程桌面、Logitech Options、AutoHotkey 等工具也可能劫持，临时禁用后重试
- 打开
Developer: Toggle Developer Tools→ Console 标签页，再按一次快捷键，看有没有日志输出
右下角显示 Plain Text，格式化直接不加载
VS Code 的格式化能力严格绑定语言 ID。哪怕文件后缀是 .vue 或 .json，只要状态栏显示 Plain Text，editor.action.formatDocument 命令就不会注册，快捷键自然灰色或无响应。
- 点击右下角语言标识 → 输入真实语言名（如
vue、json、typescriptreact）→ 回车确认 - 验证是否生效：按
Ctrl+Shift+P→ 运行Format Document With，列表不为空才说明语言识别成功 - 长期方案：在
settings.json中配"files.associations"，例如"*.vue": "vue"，避免每次手动切
报错 “No formatter installed for 'xxx'”，其实是路径或权限问题
这个提示不是说你没装插件，而是 VS Code 找不到能执行格式化的可执行体。尤其在使用 prettier、black、gofumpt 等 CLI 工具时，路径解析失败很常见。
- 终端运行
which prettier（macOS/Linux）或where prettier（Windows），结果必须非空；若为空，重装并勾选「Add to PATH」 - 检查项目级配置：
prettier.prettierPath是否指向一个不存在的路径，比如误写成全局安装路径但实际项目用的是pnpm+node_modules/.bin/prettier -
prettier-plugin-html、prettier-plugin-vue等需额外安装并显式启用，仅装esbenp.prettier-vscode不够
工作区 settings.json 里写了 "[javascript]": { "editor.formatOnSave": false }
这是最隐蔽也最常被忽略的一处：全局开了 editor.formatOnSave，但工作区配置直接把它关死了。JS/TS 文件保存时永远不格式化，且不会报错、不会提醒。
- 按
Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)，搜索formatOnSave，确认没有显式设为false - 如果只想对某类文件启用，必须写成语言专属形式：
"[typescript]": { "editor.formatOnSave": true }，不能笼统设全局 - HTML、Vue、MDX 等非标准语言 ID，得在
settings.json里手动加语言块，例如"[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
真正卡住人的从来不是“怎么开开关”，而是语言 ID 绑定错、路径写错、配置被覆盖——这些地方不报错、不弹窗、不提示，只静默失效。调试时优先看右下角语言模式和控制台日志，比翻 settings.json 更快定位根因。
