VSCode保存时格式化失效主因是editor.formatOnSave未真正启用或被项目级配置覆盖，须检查全局及语言专属设置是否为true、右下角语言模式是否正确、对应语言是否明确配置editor.defaultFormatter且插件已启用。
保存时格式化失效，90% 是因为 editor.formatOnSave 没真正生效，或被更细粒度的配置覆盖了。 它不是“装了插件就自动开”，必须显式启用、绑定语言、避开覆盖陷阱。
检查 editor.formatOnSave 是否真开启
这个布尔值是总开关，但容易被误关或忽略：
- 打开设置（
Ctrl+,），搜format on save，确认勾选；或者直接看settings.json里有没有"editor.formatOnSave": true - 如果项目根目录存在
.vscode/settings.json，它会完全屏蔽用户级设置——务必打开该文件，检查里面是否写了"[javascript]": { "editor.formatOnSave": false }这类语句 - 语言专属设置优先级更高：即使全局开了，
[typescript]块里写"editor.formatOnSave": false，TS 文件照样不格式化
确认当前语言绑定了正确的 editor.defaultFormatter
VSCode 不会自动把刚装的 Prettier / Black / Clang-Format 当成默认工具，必须手动指定：
- 右下角状态栏看当前语言模式（比如显示
JavaScript而不是Plain Text），否则语言专属配置压根不触发 - 在
settings.json中为每种语言单独配："[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }、"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 别只设全局
"editor.defaultFormatter"—— VSCode 会忽略它，转而用内置 formatter（如 JS 自带的） - Vue/HTML/Markdown 等非标准语言 ID 必须显式加块：
"[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
验证格式化器是否加载成功
插件装了 ≠ 加载成功，静默失败很常见：
- 按
Ctrl+Shift+P→ 输入Format Document With，看列表里有没有对应工具（如Prettier或Black）。为空？说明插件没启用或语言识别失败 - 对 Python，检查
python.defaultInterpreterPath是否指向有效环境（black需 Python ≥ 3.7） - 对 C/C++，确认
editor.defaultFormatter设的是xaver.clang-format，不是ms-vscode.cpptools（后者不负责格式化） - 运行
npx prettier --debug-check index.js可暴露.prettierrc解析错误（比如用了单引号或尾随逗号）
最容易被忽略的是：语言模式识别失败和工作区配置覆盖。哪怕所有设置都对，只要右下角显示 Plain Text，editor.formatOnSave 就不会触发；哪怕全局开了开关，.vscode/settings.json 里一句 "[typescript]": { "editor.formatOnSave": false } 就能让整个 TS 项目失效。
