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 不报错，直接退回到“什么都不做”状态——看起来像失效，其实是连规则都没读进去。
常见静默失败点：
-
.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 内核版本不兼容，别硬调配置，先降级插件或等修复补丁。
