右键“格式化文档”变灰或无反应，需同时满足语言模式正确、格式化插件成功注册、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 没对上号，或者路径写错。

VSCode

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

下载

• 在设置里搜 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 绑定。修一个不等于全通，得逐层验证。