VS Code格式化失效主因是语言模式识别正确但未绑定对应格式化器，需为每种语言（如javascript、typescript）单独配置"[language]": {"editor.defaultFormatter": "id"}，且editor.formatOnSave可能被更细粒度设置覆盖。

Format Document With 列表为空或灰色不可点

这说明 VS Code 识别出了当前文件的语言模式（比如右下角显示 JavaScript），但没找到能干活的格式化器。不是插件没装，而是没“认领”这个语言。

必须为每种语言单独绑定格式化器 ID，editor.defaultFormatter 顶层设置对 .js、.ts 等文件完全无效。

• 打开一个 .js 文件 → 右键编辑器 → Format Document With… → Configure Default Formatter…
• 在弹出列表中选 Prettier - Code formatter，并勾选 Set as default
• VS Code 会自动生成类似这样的配置：

  "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }

• 重复该操作，为 typescript、json、html、markdown 等语言分别配一次
• 注意 language ID 必须精确：React 文件是 typescriptreact，Vue 单文件组件是 vue，不是 html

editor.formatOnSave 开了但保存后没反应

开关开了 ≠ 生效。它可能被更细粒度的设置覆盖，或者压根没连上语言和格式化器。

VSCode

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

下载

• 检查工作区 .vscode/settings.json 是否写了 "[javascript]": { "editor.formatOnSave": false } —— 这行会直接屏蔽 JS 文件的自动格式化
• 确认 editor.formatOnSaveMode 是 file（默认值），不是 modifications（只格式化修改行，容易误判为“没动”）
• 某些格式化器（如 Prettier）默认不强制读配置；加一行 "prettier.requireConfig": true 到用户 settings.json 顶层，再配好项目根目录的 prettier.config.js，才能真正锁定规则
• 运行 npx prettier --debug-check index.js，能立刻暴露 .prettierrc 里语法错误（比如用了单引号、注释、尾逗号）

快捷键 Shift+Alt+F 没响应或报 “No formatter installed”

这个错误信息很关键：它表示 VS Code 找到了语言模式，但找不到可用的 formatter 扩展，或者扩展根本没加载成功。

• 先禁用所有插件（Ctrl+Shift+P → Developer: Disable All Installed Extensions），再试快捷键 —— 如果恢复，说明有插件冲突或劫持了命令
• 检查系统级热键冲突：Windows 上搜狗/微软拼音常把 Shift+Alt 当中英文切换；macOS 上 Spotlight 默认占用了 Cmd+Shift+F
• 右下角语言模式必须匹配：点它 → Configure Language Mode → 选对 typescript 而不是 Plain Text 或 typescriptreact（后者需单独配）
• HTML、Vue、YAML 等非标准语言，Prettier 需额外插件支持；例如 HTML 必须在项目中装 prettier-plugin-html，且 prettier.config.js 里声明 plugins: ['prettier-plugin-html']

Python/Go 等语言格式化仍不生效

这类语言的格式化链更长：VS Code 不直接调用 Prettier，而是依赖语言专属扩展提供的 formatter 接口。

• Python：必须同时满足三项 —— 安装 ms-python.python（或 ms-python.black-formatter）、设 "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }、且本地已 pip install black
• Go：需安装 golang.go 扩展，并确保 go.formatTool 设为 "gofumpt" 或 "goimports"，不能只靠 Prettier
• ESLint 用户注意：dbaeumer.vscode-eslint 的格式化能力需手动开启：eslint.format.enable: true，否则即使绑了 ESLint 也不会响应格式化命令
• 多个 formatter 共存时（如 Prettier + ESLint），VS Code 不保证执行顺序；禁用不用的扩展比靠配置“压优先级”更可靠

实际修复中最容易被跳过的环节是 language ID 的精确匹配和配置文件的静默失败 —— Prettier 遇到 .prettierrc 解析错误时不会报错，只会彻底不干活。