VSCode右键“格式化文档”与Shift+Alt+F本质是同一命令的两种触发方式，均依赖语言识别、格式化器配置及作用域控制；右键灰色或快捷键无效时，需检查语言模式、格式化器注册状态、选区范围、焦点位置及远程环境工具链是否就位。
VSCode 的右键菜单“格式化文档”和快捷键 Shift+Alt+F 本质是同一命令的两种触发方式，不是独立功能——按需格式化的关键不在操作入口，而在语言识别、格式化器配置和作用域控制。
右键菜单灰色不可点？先确认语言模式和格式化器注册状态
右键菜单项是否出现，取决于 VS Code 是否完成了两件事：识别出当前文件的语言类型（比如 javascript 而非 plaintext），且该语言已注册了至少一个格式化提供者（即插件实现了 provideDocumentFormattingEdits 接口）。
- 右下角状态栏显示
Plain Text或Unknown？点击它，手动选成目标语言（如TypeScript React） - 新建一个
test.ts文件粘贴代码再右键——如果这时可点，说明原文件后缀未被关联（比如叫config或app） -
.vue文件中，Volar 和 Vetur 对右键支持不同：script区域右键才显示格式化项，template区域可能只响应 HTML 相关格式化 - 打开「输出」面板（
Ctrl+Shift+U），切换到对应插件日志（如Prettier），看是否有Cannot find module 'prettier'或No configuration file found报错
Shift+Alt+F 没反应？排查作用域与冲突链
这个快捷键默认只对「当前活动编辑器」生效，且行为受多个隐性条件约束，不是按下就一定触发。
- 只选中了一段代码？
Shift+Alt+F默认格式化选区；想整文件，必须确保没有选中任何内容 - 焦点在终端、调试控制台或输出面板？快捷键完全不响应——必须让光标落在代码编辑器内
- 被输入法、远程桌面或笔记本
Fn键劫持？临时用命令面板验证：Ctrl+Shift+P→ 输入Format Document→ 回车执行 - 快捷键绑定被覆盖？打开键盘快捷方式设置（
Ctrl+K Ctrl+S），搜索editor.action.formatDocument，确认其when条件为editorTextFocus && !editorReadonly，且无禁用项
按需格式化真正可控的三个开关
所谓“按需”，不是靠记忆不同快捷键，而是通过组合配置实现精准触发：什么时候格式化、格式化哪部分、用谁来格式化。
-
"editor.formatOnSave": true—— 保存时自动格式化，但要搭配"editor.defaultFormatter"显式指定扩展 ID，否则可能 fallback 到内置（弱）格式器 -
"editor.formatOnType": false—— 关掉“键入时自动格式化”，避免 JSX 或模板字符串里打个{就重排整行 -
"[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }—— 按语言精确指定格式化器，比全局editor.defaultFormatter更可靠，尤其在多语言混编项目中
容易被忽略的硬伤：格式化器本身没装在正确位置
本地开发没问题，一上 WSL/SSH 远程环境就失效，90% 是因为格式化插件只装在了本地 VS Code，而远程服务器里没装对应 CLI 工具（如 prettier、black）或没加进 $PATH。
- 远程场景下，
prettier-vscode插件会尝试调用系统prettier命令，而非自带逻辑——检查远程终端能否执行prettier --version - Python 项目若用
black，需确保远程 Python 环境已运行pip install black，且 VS Code 的python.defaultInterpreterPath指向该环境 - 某些插件（如
rust-analyzer）要求语言服务器启动成功后才注册格式化能力，看「输出」→「Rust Analyzer」里有没有server started日志
