右键菜单无“Format Document”选项主因是插件默认禁用上下文菜单注册，如Prettier v12需设"prettier.enableContextMenu": true，Volar 2.x需设"volar.enableContextMenu": true，并确认语言模式正确、格式化器已为对应语言ID激活。
右键菜单里没有“Format Document”选项
这不是格式化功能坏了，而是 VSCode 根本没把格式化命令注册进右键上下文菜单。新版插件（尤其是 Volar 2.x、ESLint 插件更新后）常会禁用默认右键项，或只保留快捷键入口。
先确认是否真缺失：右键任意代码文件 → 看菜单底部有没有 Format Document 或 Format Selection。如果没有，说明上下文菜单项被插件主动移除了。
- 打开
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON)，检查是否有类似"editor.contextmenu": false的全局禁用项（极少见，但某些企业策略插件会加） - 更常见的是插件自身控制：比如
esbenp.prettier-vscode从 v12 起默认不注册右键项，需手动开启 —— 在settings.json中加："prettier.enableContextMenu": true
- Volar 2.x 同样默认关闭右键菜单，启用方式是：
"volar.enableContextMenu": true
- 如果用了多个格式化插件（如 Prettier + ESLint），它们可能互相屏蔽右键项；临时禁用其中一个，看菜单是否恢复
右键能点开但 Format Document 置灰或报错
菜单显示了，但点击无反应、变灰、或弹出 There is no formatter for 'javascript'-files installed.，说明格式化能力存在，但当前文件没被识别为可格式化语言，或对应格式化器未激活。
- 检查右下角语言模式：必须是
JavaScript、TypeScript、Vue等，不能是Plain Text或JSONC；误识别时按Ctrl+Shift+P→Change Language Mode手动切对 - 运行
Ctrl+Shift+P→Format Document With...，看列表里有没有你期望的格式化器（如esbenp.prettier-vscode）。若没有，说明该插件没为当前语言 ID 注册服务 - 语言 ID 可能已变：Volar 2.x 把
vue换成vue-html，Prettier 配置就得同步改："[vue-html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 某些插件（如
dbaeumer.vscode-eslint）要求显式开启格式化开关："eslint.format.enable": true
Format Document With… 列表为空或只有“None”
这代表 VSCode 没发现任何可用的格式化扩展，不是菜单问题，而是格式化器根本没加载成功。开发者工具里通常会报 command 'editor.action.formatDocument' not found。
- 打开
Ctrl+Shift+P→Developer: Toggle Developer Tools→ 切到Console标签页，再触发一次右键 →Format Document，看是否有红色报错 - 常见报错：
Cannot find module 'prettier'（Prettier 插件依赖未安装完整）、Failed to activate extension volar（Volar 启动失败） - 检查输出面板：
Ctrl+Shift+U→ 切换到Vue Language Server或Prettier日志，看是否有初始化失败提示 - 插件更新后可能要求重启 VSCode 才生效；若仍无效，尝试禁用所有插件 → 仅启用
language support+formatter插件 → 重启验证
右键菜单显示正常但格式化结果不对
菜单和命令都通了，但缩进变 2 空格、单引号被强转双引号、HTML 空行全没了——这是格式化器执行了，但规则没按你预期走，大概率是配置层冲突或插件规则变更。
- Prettier 3.x 默认启用
htmlWhitespaceSensitivity: 'ignore'，旧项目若依赖'strict'行为，必须在.prettierrc显式写死 - 工作区
.vscode/settings.json中的editor.defaultFormatter若指向 ESLint，而eslint.format.enable是false，它会 fallback 到 VSCode 内置格式器（效果极简） - 检查是否有
.editorconfig文件，它的indent_style、quote_type等设置会被 Prettier 尊重，也可能覆盖你期望的风格 - 多格式化器共存时，VSCode 实际调用哪个，取决于
Format Document With…当前选中的项，而非defaultFormatter设置；右键菜单里选错一项，结果就完全跑偏
最易被忽略的一点：右键菜单的格式化入口和快捷键（Shift+Alt+F）走的是同一套注册逻辑，但它们的启用状态可以不同。有人关了右键项却留着快捷键，也有人反过来——排查时别只盯菜单，得连带验证命令是否真能被调用。
