VSCode无法格式化代码的根源在于格式化指令未正确传达：语言模式错误、defaultFormatter未指定、formatOnSave被覆盖、扩展冲突或工具链未就绪。

确认语言模式是否正确（.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 运行正常）