右键“格式化文档”变灰或无反应，需同时满足语言模式正确、格式化插件成功注册、defaultFormatter 正确绑定三者；任一缺失都会导致失效。
右键菜单里“格式化文档”变灰或点击无反应，不是 VS Code 坏了，而是它根本没识别出当前文件该用谁来格式化——语言模式错、默认格式化器没绑、插件没加载成功，三者缺一不可。
右键“格式化文档”灰色不可点？先看右下角语言模式
VS Code 只在确认语言类型（如 typescript）且该语言已注册格式化提供者时，才启用右键菜单项。灰色 = 它不知道你是谁，更不知道该叫谁来干活。
- 点击右下角状态栏的语言标识（比如显示
Plain Text或Unknown），手动选成正确语言（TypeScript React、Vue、HTML等） - .vue 文件中，Volar 2.x 已弃用
vue语言 ID，改用vue-html和vue-script，若仍用[vue]配置 defaultFormatter，右键必然失效 - 新建一个
test.ts文件粘贴代码再右键——如果这时可点，说明原文件后缀未被语言关联（比如叫config或app）
Format Document With… 列表为空？检查 formatter 是否注册成功
右键菜单依赖插件是否真正激活并声明了格式化能力。列表空 ≠ 插件没装，而是它没向 VS Code “报到”。
- 按
Ctrl+Shift+P→ 输入Format Document With…，看列表里有没有你的格式化器（如esbenp.prettier-vscode） - 若消失，打开
Ctrl+Shift+P→Developer: Toggle Developer Tools，切到 Console 标签页，再触发一次格式化——出现command 'editor.action.formatDocument' not found表示插件根本没注册命令 - 某些插件（如 Red Hat XML Tools）升级后默认关闭
xml.format.enable，需手动设为true才能出现在列表中
右键能点但执行无反应？查 defaultFormatter 绑定和配置路径
点了没反应，往往是因为 VS Code 找到了语言，也找到了插件，但没把二者连起来——editor.defaultFormatter 没对上号，或者路径写错。
- 在设置里搜
default formatter，展开对应语言（如JavaScript），下拉选择具体扩展 ID：esbenp.prettier-vscode（注意拼写，不能是prettier或prettier-vscode） - HTML/Vue/MDX 等非标准语言需手动加语言块到
settings.json："[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 工作区
.vscode/settings.json可能覆盖全局设置，检查是否有"[javascript]": { "editor.defaultFormatter": null }这类清空操作
格式化结果异常或保存时不触发？配置文件和插件开关常被忽略
看起来“生效”了，但缩进错乱、引号不统一、空行消失——这不是右键问题，而是规则来源混乱；保存没反应，则可能是插件自己的开关关掉了。
-
.prettierrc里用了单引号、注释或尾随逗号？JSON 不支持，Prettier 会静默退出。改用prettier.config.js（支持 JS 语法）更稳妥 - ESLint 插件若开启
eslint.format.enable，它会接管 JS/TS 保存格式化，此时editor.defaultFormatter必须指向dbaeumer.vscode-eslint，否则冲突 - 运行
npx prettier --debug-check index.js，它会明确指出配置文件哪一行、哪个 key 出错（比如trailingcomma拼错）
最易被忽略的点：右键菜单是否出现、是否可用、是否真执行，分别由三个独立条件控制——语言模式识别、formatter 插件注册、defaultFormatter 绑定。修一个不等于全通，得逐层验证。
