关掉 editor.formatonsave 需分三层:用户级、工作区级(.vscode/settings.json)、语言级;dart/flutter 项目需单独关 dart.formatonsave 或 dart.enablesdkformatter;插件如 prettier、eslint 也有独立开关。

直接关掉 editor.formatOnSave 就行,但得看关在哪一级
VS Code 的保存自动格式化不是“开关一按就全局失效”的简单逻辑——它有三层作用域:用户级(全局)、工作区级(项目根目录 .vscode/settings.json)、语言级(比如只对 [javascript] 生效)。你改了用户设置,但项目里有个 .vscode/settings.json 也写了 "editor.formatOnSave": true,那它就会覆盖你,关不掉。
实操建议:
- 先按
Ctrl + ,(Windows/Linux)或Cmd + ,(macOS)打开设置,搜format on save,取消勾选——这是最快验证是否生效的方式 - 如果勾掉后仍格式化,立刻检查项目根目录是否存在
.vscode/settings.json,打开它,删掉或改成"editor.formatOnSave": false - 想只关某语言?在 settings.json 里写:
"[python]": {"editor.formatOnSave": false},注意中括号和引号一个都不能少
Dart / Flutter 项目关不掉?别动 editor.formatOnSave,去查插件配置
Flutter 官方插件自带独立的格式化开关,它不走 VS Code 默认的 editor.formatOnSave 流程,所以你改了全局设置也没用。现象是:JS/Python 文件关掉了,但 .dart 文件一保存还是被重排、加空行、改花括号位置。
实操建议:
- 打开设置,搜
dart.formatOnSave,把它设为false - 或者搜
dart.enableSdkFormatter,关掉它(这会禁用 Dart SDK 自带的dart format) - 顺手检查
dart.previewLsp是否开启——LSP 模式下部分格式化行为由语言服务器控制,设置位置可能不同
关了还格式化?可能是某个插件在“偷偷干活”
装了 Prettier、ESLint、Black、Autopep8 这些插件后,它们往往自带“保存即格式化”子开关,哪怕 editor.formatOnSave 是 false,插件自己也能触发。右下角状态栏显示 “Prettier” 或 “ESLint”,说明当前文件正被插件接管。
实操建议:
- 搜
prettier.requireConfig,设为true—— 这会让 Prettier 只在项目有.prettierrc时才工作,没配置就安静 - 搜
eslint.format.enable,设为false—— 关闭 ESLint 的格式化能力(它默认只做校验) - 临时跳过一次?保存时按住
Alt(Windows/Linux)或Option(macOS),再按Ctrl+S,VS Code 会跳过本次格式化
不想全关,但又怕格式化“改太多”?试试延迟+最小干预
有些团队只要求统一缩进、空格、换行符,不希望 Prettier 把函数拆成多行、把链式调用重排、把 import 排序……这种“轻量格式化”需求,硬关 editor.formatOnSave 太粗暴,留着又太激进。
实操建议:
- 保留
"editor.formatOnSave": true,但指定一个极简 formatter,比如只用 VS Code 内置的vscode.typescript-language-features(对 TS/JS 有效) - 加个延迟防卡顿:
"editor.formatOnSaveTimeout": 750,避免大文件保存时界面假死 - 配合
"editor.formatOnSaveMode": "modifications"(VS Code 1.85+),只格式化你改过的行,不动全文
真正麻烦的从来不是“怎么关”,而是关哪一层、谁在背后调用、以及关完之后右下角状态栏还显示某个 formatter —— 那说明你还没找到真正的控制点。多看一眼状态栏,比反复改 settings.json 更省时间。










