VS Code 怎样把保存操作绑定到格式化动作

在 VS Code 中，把保存操作绑定到格式化动作，核心就是开启 editor.formatOnSave。前提是当前语言已经有可用的默认格式化器或扩展提供格式化能力；配置生效后，按下保存或触发自动保存，编辑器就会在保存流程中尝试格式化当前文件。

官方地址：https://code.visualstudio.com/

最小配置是 "editor.formatOnSave": true。先手动执行一次 Format Document 确认格式化器可用，再决定把设置放在用户级、工作区级还是语言级。下面的界面图是原创操作说明图，不是 VS Code 实际截图。

先确认当前文件有可用格式化器

打开一个需要整理排版的文件，在编辑器中打开命令面板，执行 Format Document。也可以在编辑器中使用格式化命令；官方文档把它和 Format Selection 区分开，前者处理整个活动文件，后者只处理选中范围。

如果命令执行后出现格式化器选择框，先选定适合当前语言的格式化器。若没有可选项，保存时格式化不会凭空产生，应该先安装或启用对应语言的格式化扩展，或者确认该语言是否由 VS Code 自带格式化支持。

• 手动 Format Document 能改变排版：可以继续配置保存触发。
• 命令找不到格式化器：先解决格式化器本身，不要只反复修改 formatOnSave。
• 多个格式化器都可用：先明确默认格式化器，避免每次保存都弹选择框。

在设置中开启保存时格式化

按 Ctrl+Shift+P（macOS 为 ⇧⌘P）打开命令面板，选择 Preferences: Open User Settings (JSON)，加入下面这段配置。它适用于当前用户打开的 VS Code 工作区。

{
  "editor.formatOnSave": true
}

如果你只想在当前项目启用，可以改为打开项目的 .vscode/settings.json，把同一个键写进去。设置 JSON 必须保持合法 JSON，不能在里面加入注释；配置旁边的说明应写在文档或团队约定中。

保存设置文件后，回到目标代码文件，修改一处缩进或换行，再保存。可见的成功信号是文件排版发生变化，且没有再次出现选择格式化器的提示。

让配置只作用于需要的语言和工作区

全局开启适合个人习惯，但团队项目往往需要更窄的范围。工作区级配置会随项目生效，语言级配置可以只约束某一种语言。例如只对 JavaScript 开启，可以在设置 JSON 中使用语言标识块：

{
  "[javascript]": {
    "editor.formatOnSave": true
  }
}

这里的关键不是把所有配置都复制三遍，而是先确定“谁需要这个行为”：个人所有项目使用用户级；某个仓库统一使用工作区级；只有特定语言需要时使用语言级。若同一设置出现在多个作用域，优先检查当前工作区和语言级块是否覆盖了你的预期。

保存后没有格式化时按这个顺序排查

1. 先手动运行 Format Document。如果手动也不能格式化，问题在格式化器、语言识别或扩展状态。
2. 打开设置搜索 format on save，确认当前作用域的开关确实为启用状态，并检查是否有语言级配置覆盖。
3. 通过命令面板执行 Format Document With...，确认默认格式化器，而不是让多个扩展互相竞争。
4. 查看当前文件的语言模式。文件被识别成纯文本时，针对 JavaScript、Go 或 JSON 的语言级配置不会按预期命中。
5. 如果格式化器本身报错，先处理扩展输出中的错误；保存触发只是调用入口，不会修复格式化器的依赖或语法问题。

还要区分“保存时格式化”和“自动保存”：editor.formatOnSave 负责保存触发，files.autoSave 负责什么时候自动保存。开启前者并不等于自动保存，反过来也一样。

常见问题

开启后为什么保存没有任何变化？最常见原因是当前语言没有可用格式化器，或文件语言模式与语言级配置不匹配。先手动执行 Format Document，再检查作用域。

能不能只对一个项目开启？可以，把配置写入项目的 .vscode/settings.json。这样不会把同一偏好带到所有工作区。

保存时总是弹出格式化器选择怎么办？通过 Format Document With... 选择并设置默认格式化器，然后再次保存确认。

结论很简单：先确认格式化器能手动工作，再开启 editor.formatOnSave，最后用工作区和语言级作用域控制影响范围。这样保存动作才会稳定地绑定到正确的格式化动作。