VSCode格式化失效通常因语言识别错误、默认格式化器未设置、扩展未启用或保存格式化开关关闭。需依次检查右下角语言模式、settings.json中files.associations和editor.defaultFormatter配置、Format Document With命令列表可用性，以及editor.formatOnSave等触发设置。
VSCode格式化不起作用，通常不是插件“坏了”，而是某个环节没接上——语言识别错了、格式化工具没指定、配置被覆盖，或者扩展之间互相卡住了。找准断点，三分钟就能恢复。
确认当前文件的语言模式是否正确
VSCode一切格式化行为都从“这是什么语言”开始。如果它把 .vue 当成 HTML，或把 .ts 当成 JavaScript，就根本不会调用对应格式化器。
- 看右下角状态栏：显示的是 Vue 还是 HTML？是 TypeScript 还是 JavaScript？不对就点击它，选对语言模式
- 检查
settings.json是否有强制映射，比如：
{ "files.associations": { "*.vue": "vue" } } - 对自定义后缀（如
.api、.cfg），必须手动关联语言，否则格式化直接跳过
检查默认格式化程序是否已设置并启用
VSCode不会自动猜你用 Prettier 还是 ESLint，必须明确告诉它：“这个语言，交给你来格式化”。
- 打开设置（Ctrl+,），搜 Default Formatter，为对应语言选好扩展（如
esbenp.prettier-vscode或dbaeumer.vscode-eslint） - 更稳妥的方式是写进
.vscode/settings.json：
{ "editor.defaultFormatter": "esbenp.prettier-vscode" } - 注意：若工作区设置了该值，用户级设置会被覆盖；多层嵌套项目中，优先读取最内层的
.vscode
验证格式化扩展是否真正生效
装了≠启用了≠能用了。尤其升级 VSCode 后，部分扩展会静默禁用或 API 失效。
- 按 Ctrl+Shift+P，输入 Format Document With，看列表里有没有你的格式化器（如 “Prettier”）
- 如果灰色不可选，说明当前语言未注册该提供者——可能是扩展未激活，或语言服务器没起来（常见于 C++、XML、Swift）
- 临时禁用其他格式化类扩展（Beautify、Auto Rename Tag 等），再测试，排除冲突
检查保存格式化开关与触发条件
很多人只开了 formatOnSave，却忽略了它其实有“生效前提”。
- 确保设置了：
{ "editor.formatOnSave": true } - 可加一行防冲突：
"editor.formatOnSaveMode": "modifications"（只格式化改动行，避免全文件重排） - 某些语言（如 XML、Groovy）需额外安装服务端工具（Red Hat XML Server、CodeNarc），仅装插件不够
- 快捷键 Shift+Alt+F 失效？先试命令面板里的 Format Document，确认是快捷键问题还是功能本身挂了
基本上就这些。不用重启、不用重装，多数情况改两行 JSON + 点一次右下角语言模式，立刻回来。
