vscode保存时自动格式化需同时满足三个条件：开启editor.formatonsave、明确指定对应语言的editor.defaultformatter、安装并正确识别该格式化插件；缺一不可。
VSCode 保存时自动格式化不是“装个插件就完事”，它必须同时满足三个条件：editor.formatOnSave 开启、对应语言的 editor.defaultFormatter 明确指定、该 formatter 插件已安装并被 VSCode 正确识别。缺一个，Ctrl+S 就只是保存，不会动一行代码。
确认当前文件有可用的格式化提供者
VSCode 自身不带格式化逻辑，全靠扩展提供。右下角状态栏显示的语言模式（比如 JavaScript React）必须匹配你装的 formatter 扩展支持范围。
- 按
Ctrl+Shift+P输入Format Document With，如果列表为空或只有None，说明没装对扩展，或扩展没激活 - JS/TS 项目常见遗漏：装了
esbenp.prettier-vscode，但没在工作区启用；或者装了多个（如 Prettier + ESLint + js-beautify），导致冲突静默失败 - Python 用户注意：
ms-python.python是语言支持包，不是格式化器；真正干活的是ms-python.black-formatter或配置python.formatting.provider为black - Go、Rust 等需官方插件（如
golang.go）且gopls启动成功后才提供格式化能力，可查输出面板中对应日志
开启 editor.formatOnSave 并配对语言设置
这个开关默认是 false，不手动开，永远不触发。但只开它还不够——VSCode 不知道该叫谁来干活。
- 全局开启（不推荐用于团队项目）：
"editor.formatOnSave": true写进用户settings.json - 更稳妥的做法是按语言覆盖：
"[javascript]": {"editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode"} - 语言 ID 必须小写、准确，比如是
typescriptreact而不是tsx；可在右下角点击语言名确认 - 项目根目录下的
.vscode/settings.json会覆盖全局设置；如果里面写了"editor.formatOnSave": false，整个项目都失效
处理多 formatter 共存时的冲突
当一个文件类型被多个扩展声称能格式化（比如 JS 同时装了 Prettier 和 ESLint 插件），VSCode 可能卡住、跳光标，甚至格式错乱——它会尝试让所有可用 formatter 都跑一遍。
- 右键编辑器空白处 →
Format Document With→ 选中你要的 → 点Configure Default Formatter，这会在.vscode/settings.json中写入类似"[javascript]": {"editor.defaultFormatter": "esbenp.prettier-vscode"} - 禁用非主力扩展：比如确定用 Prettier，就停用
HookyQR.beautify或旧版 ESLint 的自动格式化功能 - ESLint 建议只做检查，修复交给
editor.codeActionsOnSave控制："source.fixAll.eslint": true，而不是让它也参与formatOnSave - 大项目里格式化慢？改用延迟触发：
"editor.formatOnSaveAfterDelay": 750，避免保存卡顿
最容易被忽略的点是：语言设置和 formatter 扩展必须严格匹配。比如你给 [python] 配了 esbenp.prettier-vscode，保存时只会静默失败——VSCode 不报错，也不提示，它只是跳过。真正生效前，务必手动执行一次 Format Document（Shift+Alt+F）验证工具是否就位。
