VSCode格式化失效八成因右下角语言模式为Plain Text或Unknown——此时格式化链路完全中断，快捷键灰掉、保存无响应；须点击右下角手动切换为正确语言ID（如typescriptreact、jsonc），并检查files.associations配置与文件后缀匹配性。

右下角语言模式显示 Plain Text 就别往下看了

VSCode 格式化根本不会对 Plain Text 或 Unknown 语言触发——这不是配置问题，是 VSCode 压根没识别出这是什么文件。快捷键变灰、Format Document With… 列表为空、保存不响应，八成卡在这一步。

点击右下角语言标识（比如写着 Plain Text 的小标签），输入真实语言 ID 回车确认。注意大小写和拼写：typescriptreact ≠ typescript，jsonc ≠ json。临时切换后若格式化恢复，说明问题锁定在语言识别环节。

• 检查文件后缀是否匹配：比如 vite.config.ts 被当成 JavaScript，会导致 TS 特有规则（如 prettier.importOrderParserPlugins）被忽略
• 自定义后缀或配置文件需手动关联："files.associations": { "vite.config.*": "typescript", "*.config.js": "javascript" }
• pnpm/yarn v4+ 的 symlink 路径可能被 VSCode 拒绝加载语言服务，此时手动切换语言是最直接绕过手段

Format Document With… 列表里没有 Prettier？绑定断了

插件更新（尤其是 Volar 2.x、ESLint、XML Tools）常改语言 ID 或禁用默认绑定。Volar 2.x 已弃用 vue，改用 vue-html 或 vue-postcss；ESLint 插件若开启 eslint.format.enable，会接管 JS/TS 文件，但前提是 editor.defaultFormatter 必须指向 dbaeumer.vscode-eslint，而非 Prettier。

运行 Ctrl+Shift+P → Format Document With…，看列表是否为空或缺失目标格式化器。若为空：

• 打开 settings.json，确认对应语言块存在且拼写准确："[vue-html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
• HTML、MDX、Vue 等非标准语言 ID 不走全局设置，必须显式声明语言块，不能只靠全局 editor.defaultFormatter
• 某些插件（如 Red Hat XML）升级后默认关闭 xml.format.enable，需手动设为 true

格式化命令执行但无变化？配置文件静默失败

.prettierrc 或 prettier.config.js 语法错误时，Prettier 不报错，直接退回到“什么都不做”状态——看起来像失效，其实是连规则都没读进去。

常见静默失败点：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• .prettierrc 用了单引号、JS 注释、尾随逗号（JSON 不允许）
• 键名拼错：trailingcomma 应为 trailingComma；endOfLine 值写成 "LF"（应为 "lf"）
• prettier.requireConfig 设为 true 但项目里没放合法配置文件（它只找当前文件所在目录往上第一个）
• monorepo 中子 package 缺配置，只在仓库根目录放一个 .prettierrc 不够

验证方式：npx prettier --debug-check index.js 会明确指出哪行、哪个键解析失败；npx prettier --find-config-path . 看它是否真能定位到配置。

开发者工具 Console 报 command not found？格式化器没注册

打开 Ctrl+Shift+P → Developer: Toggle Developer Tools，切到 Console 标签页，再触发一次格式化。若出现 command 'editor.action.formatDocument' not found，说明对应格式化器根本没注册成功——不是配置问题，是扩展生命周期或兼容性断点。

这时该做的不是调设置，而是排查环境：

• 临时禁用所有非必要插件（只留 esbenp.prettier-vscode + 语言支持插件），重启 VSCode 后逐个启用，定位干扰源
• 检查插件是否被禁用于当前工作区（扩展视图里看状态是否为“启用”）
• 某些新版插件要求显式启用服务，比如 Volar 需开启 volar.enable，否则不激活语言功能

语言模式对、格式化器在列表里、配置文件也合法，但 Console 仍报未注册——大概率是插件自身激活失败或与 VSCode 内核版本不兼容，别硬调配置，先降级插件或等修复补丁。