VS Code editor.codeActionsOnSave 怎样配置保存时自动修复

如果你希望 VS Code 在保存文件时顺手整理导入或执行修复动作，核心设置就是 editor.codeActionsOnSave。它不负责凭空提供修复能力，真正可执行的动作仍然来自当前语言服务或扩展；设置项只决定哪些动作在什么保存场景下触发。

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

本文按一个具体任务完成配置：先找到设置入口，再写入动作键，最后分别确认手动保存、自动保存和禁用状态。你不需要修改扩展源码，也不需要把所有动作都设成自动执行。

先确认动作来源，再打开设置入口

保存动作是否有效，第一关不是复制配置，而是确认当前环境真的提供了目标 Code Action。例如整理导入通常由语言服务提供，某些“修复全部”动作则由对应扩展提供。如果动作列表里没有它，单改 JSON 不会产生效果。

1. 打开一个已经启用语言服务的项目，先在编辑器中制造或打开一个能提供 Quick Fix 的位置。
2. 按 ⇧⌘P（Windows/Linux 为 Ctrl+Shift+P），执行 Preferences: Open Settings (UI)。
3. 搜索 code actions on save，定位到 Editor: Code Actions On Save。如果只想让当前项目生效，接着切换到工作区设置；希望所有项目共享时保留在用户设置。
4. 需要精确填写动作值时，点击设置编辑器右上角的“打开设置(JSON)”入口，进入 settings.json。

进入 JSON 前先确定作用域很重要：个人习惯放用户设置，团队项目规则放工作区设置。这样可以避免把只适用于一个项目的修复动作意外带到所有仓库。

用 settings.json 写入保存动作

下面的配置把两个动作绑定到保存事件。source.organizeImports 表示整理导入，source.fixAll 表示执行当前环境提供的全部修复；动作是否出现仍取决于语言服务或扩展。

{
  "editor.codeActionsOnSave": {
    "source.organizeImports": "explicit",
    "source.fixAll": "always"
  }
}

这是严格 JSON，所以示例里不插入注释；字段含义放在代码外解释。VS Code 当前推荐用三个字符串值表达触发范围：

• explicit：显式保存时执行，适合希望按下保存快捷键才修改文件的场景。
• always：显式保存以及自动保存触发时都执行，适合结果稳定、不会频繁改写文件的动作。
• never：保存时不执行，可暂时关闭某一项而不删除配置。

多个动作会按配置中的顺序执行。建议先放整理导入，再放依赖整理后内容的修复动作；如果团队对格式化和修复有明确约定，就把这段配置写进项目的工作区设置。

保存后按三种场景核对结果

写完配置后不要只看设置项是否存在，要按触发模式做一次短核对。

1. 显式保存：把某个动作设为 explicit，修改文件后按 ⌘S 或 Ctrl+S。只有这次明确保存应触发该动作。
2. 自动保存：把动作临时设为 always，再使用窗口失焦或自动保存策略触发保存。动作应在自动保存和显式保存时都参与。
3. 禁用保存动作：设为 never 后保存同一文件，保存本身仍然有效，但该 Code Action 不应再由保存事件触发。

如果你看到文件没有变化，不要直接判断配置失效：有些文件本来就没有可整理的导入，有些扩展只在特定语言或工作区状态下提供动作。可以把动作先改成 explicit，手动保存并观察 Code Action 是否出现在命令面板中。

三个常见问题

为什么配置了 source.fixAll 却没有修复？

先确认当前语言服务或扩展是否提供名为 source.fixAll 的动作，再检查配置是否写在实际生效的用户或工作区范围。设置项只负责调度，不会替扩展增加能力。

为什么自动保存时文件总被改动？

通常是把动作值设成了 always。如果只想在自己确认后修改，把它改成 explicit；如果只需暂时停用，改成 never，不必删除整个对象。

多个 Code Action 的顺序能不能调整？

可以，按配置对象中的顺序排列。仍然要注意动作之间是否相互影响，并在团队项目中把最终顺序写进工作区设置，避免每个人的用户配置不同。

这套配置的关键不是把所有修复都自动化，而是先确认动作来源，再选择正确的设置作用域和触发值。个人项目可以从 explicit 开始，确认结果稳定后，再对适合自动执行的动作单独使用 always。