VS Code保存时自动格式化失效，主因是editor.formatOnSave启用但未为对应语言配置editor.defaultFormatter。需在工作区settings.json中按语言（如[javascript]）指定已安装的格式化器ID，且确保右下角语言模式正确；避免全局设置defaultFormatter引发冲突；Prettier与ESLint共存时应禁用eslint.format.enable以防规则覆盖。
保存时自动格式化不会生效，99% 是因为 editor.formatOnSave 开了但没配对 editor.defaultFormatter。 VS Code 本身不格式化代码，它只负责调用你指定的工具（比如 Prettier、Black、dartfmt），而“调谁”必须按语言显式声明，不能靠猜。
为什么按 Ctrl+S 没反应，但 Shift+Alt+F 可以？
这说明格式化工具本身是可用的，只是 VS Code 没在保存时主动调用它。关键检查点：
-
editor.formatOnSave必须为true（全局或工作区 settings.json 中） - 对应语言必须有
[javascript]或[python]这类语言作用域配置，且其中editor.defaultFormatter明确指向已安装的扩展 ID，例如："esbenp.prettier-vscode"或"ms-python.black-formatter" - 别写全局
"editor.defaultFormatter": "..."—— 这会让 .py 文件也尝试用 Prettier，直接报错No formatter installed for 'python' - 右下角状态栏显示的语言模式必须匹配，比如 .jsx 文件要识别为
JavaScript React，不是Plain Text
怎么给不同语言配不同的默认格式化器？
最稳妥的方式是编辑项目根目录下的 .vscode/settings.json，内容类似：
{
"editor.formatOnSave": true,
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter"
},
"[dart]": {
"editor.defaultFormatter": "Dart-Code.dart-code"
}
}
注意：[dart] 必须用官方 Dart 插件，且依赖本地 dart 命令可用；[python] 还需确保 python.formatting.provider 设为 "black"，否则即使 defaultFormatter 正确也可能静默失败。
格式化后代码“越整越乱”，大概率是规则冲突
Prettier 和 ESLint 同时启用格式化能力时，会反复覆盖彼此的缩进、分号、引号等规则，导致光标乱跳、保存后多出空行。解决方式很直接：
- 停用 ESLint 的格式化功能：在 settings.json 中加
"eslint.format.enable": false - 保留 ESLint 的修复能力：用
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，让它只修错误，不碰风格 - 项目里有
.prettierrc或pyproject.toml，就别在 settings.json 里零散设semi、tabWidth等——这些文件优先级更高，本地设置会被忽略 - Dart 项目完全不用配规则：格式由 SDK 自带的
dartfmt决定，.prettierrc对它无效，强行加只会让人误以为能调参
真正容易被忽略的是：VS Code 的格式化行为由三层配置叠加决定——编辑器级、语言级、工作区级。哪怕你全局开了 formatOnSave，只要项目根目录的 .vscode/settings.json 里写了 "[javascript]": { "editor.formatOnSave": false }，它就会立刻失效，而且不会报错、不会提醒。
