VSCode保存时自动格式化不生效，根本原因是未同时启用editor.formatOnSave并为对应语言指定editor.defaultFormatter，且语言模式识别错误、插件未启用或配置被工作区设置覆盖。
VSCode保存时自动格式化不会默认生效，哪怕你已经装了 Prettier 或 Black —— 它连“该用谁”都不知道，必须手动配对语言、格式化器和触发开关。
为什么 Ctrl+S 只保存不格式化？
常见错误是只开了 editor.formatOnSave，却没指定对应语言的 editor.defaultFormatter，或者当前文件类型没匹配上。
- 右下角状态栏显示的语言模式（如
JavaScript React）必须和你装的 formatter 插件支持范围一致；若显示None，说明 VSCode 找不到适配器 - 按
Ctrl+Shift+P输入Format Document With，如果列表为空或只有None，说明插件没装、没启用，或语言 ID 不匹配 - JS/TS 项目常见遗漏：装了
esbenp.prettier-vscode，但没在工作区启用；或同时装了多个 formatter（如 Prettier + ESLint + js-beautify），导致冲突静默失败 - Python 用户注意：
ms-python.python是语言支持包，不是格式化器；真正干活的是ms-python.black-formatter，且必须显式设置python.formatting.provider
怎么正确配置 editor.formatOnSave 和 editor.defaultFormatter？
这个开关默认是 false，不手动开，永远不触发。但只开它还不够——VSCode 不知道该叫谁来干活。
- 推荐直接编辑
settings.json（按Ctrl+,→ 右上角齿轮 → “Open Settings (JSON)”），加语言专属配置，例如： "[javascript]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" }"[typescript]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" }"[python]": { "editor.formatOnSave": true, "editor.defaultFormatter": "ms-python.black-formatter" }- 语言 ID 必须小写、准确，比如是
typescriptreact而不是tsx；可在右下角点击语言名确认 - 项目根目录下的
.vscode/settings.json会覆盖全局设置；如果里面写了"editor.formatOnSave": false，整个项目都失效
多 formatter 共存时怎么避免光标跳动或格式错乱？
当一个文件类型被多个扩展声称能格式化（比如 JS 同时装了 Prettier 和 ESLint 插件），VSCode 可能卡住、跳光标，甚至格式错乱——它会尝试让所有可用 formatter 都跑一遍。
- 右键编辑器空白处 →
Format Document With→ 选中你要的 → 点Configure Default Formatter，这会在.vscode/settings.json中写入对应语言配置 - 禁用非主力扩展：比如确定用 Prettier，就停用
HookyQR.beautify或旧版 ESLint 的自动格式化功能 - ESLint 建议只做检查，修复交给
editor.codeActionsOnSave控制："source.fixAll.eslint" - 不要把
editor.defaultFormatter设成全局值（如"editor.defaultFormatter": "esbenp.prettier-vscode"），否则.py或.yaml文件可能报错或静默失败
格式化没反应？先查 console 和状态栏，别急着重装插件
常见假性失效，其实不是插件坏了，而是环境链断了。
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），切到Console标签页，保存一次，看有没有类似这样的报错： Failed to format document: Error: No formatter registered for 'typescript'- 这意味着 VSCode 找不到能处理
.ts的格式化器——可能插件没装、没启用、或语言 ID 不匹配（比如你用的是typescriptreact，但只配了[typescript]） - 确保插件已启用：扩展面板搜
prettier或black，确认有绿色“已启用”标识 - Go、Rust 等需官方插件（如
golang.go）且gopls启动成功后才提供格式化能力，可查输出面板中对应日志
最易被忽略的一点：格式化行为依赖语言服务就位、插件启用、配置生效三者同时满足，缺一不可；而工作区设置（.vscode/settings.json）优先级高于用户设置，改了全局也可能白搭。
