VSCode无法格式化代码的根源在于格式化指令未正确传达：语言模式错误、defaultFormatter未指定、formatOnSave被覆盖、扩展冲突或工具链未就绪。
VSCode 无法格式化代码，**不是功能坏了，而是“指令没传达到位”**——它压根不知道该用谁、对什么、在什么时候格式化。下面按真实排查顺序，直击最常卡住的几个环节。
确认语言模式是否正确（.js 被当成 Plain Text？）
VSCode 所有格式化行为都从右下角状态栏的语言标识开始。如果显示的是 Plain Text、HTML 或 JSON，而不是你期望的 TypeScript、Vue、XML，那格式化器根本不会被调用。
- 点击右下角语言名称，手动选择正确类型（例如
JavaScript React对应.tsx文件） - 若每次打开都错，加配置到
.vscode/settings.json：{ "files.associations": { "*.vue": "vue", "*.api": "jsonc", ".env": "shellscript" } } - 快捷键
Ctrl+Shift+P→ 输入Change Language Mode，可快速切换并设为默认
检查 defaultFormatter 是否指定且生效（Prettier ID 拼错？）
VSCode 不会自动猜你用哪个格式化器。即使装了 Prettier，没告诉它“JavaScript 就交给你”，它就完全无视。
- 打开设置（
Ctrl+,），搜default formatter，找到对应语言项（如[javascript]），选esbenp.prettier-vscode - 更可靠的做法：写进项目级
.vscode/settings.json，避免被用户设置覆盖{ "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } } - 注意 ID 必须精确：
esbenp.prettier-vscode（不是prettier-vscode或prettier）
验证 formatOnSave 是否真启用（被工作区禁用？）
"editor.formatOnSave": true 看似简单，但极易被多层配置覆盖。常见陷阱是：用户设置开了，但项目里 .vscode/settings.json 中写了 "editor.formatOnSave": false，结果保存时静默失效。
- 按
Ctrl+Shift+P，输入Format Document With，看列表中是否有你的格式化器（如Prettier）。灰色不可选 = 未注册或语言不匹配 - 确保配置写对位置：
工作区 > 用户 > 默认，优先检查.vscode/settings.json - 推荐加一行防冲突：
"editor.formatOnSaveMode": "modifications"，只格式化改动行，避免全文件重排引发大量 diff
排除扩展冲突与配置拦截（Beautify / ESLint 抢了入口？）
多个格式化扩展共存时，VSCode 可能随机选一个，甚至因冲突直接放弃。尤其 Beautify、Auto Rename Tag、未配好 eslint-plugin-prettier 的 ESLint，都会干扰流程。
- 临时禁用所有格式化类扩展，只留
Prettier或rust-analyzer等目标工具，再测试 - 检查 Prettier 设置：
prettier.requireConfig若为true，但项目缺.prettierrc，它就会沉默退出——设为false先验证基础能力 - 对 XML、Go、C++ 等语言，仅装插件不够，还需确认服务端工具就绪（如
Red Hat XML依赖 JDK，Go Nightly需gopls运行正常）
