提升多人协同开发代码规范的VSCode快捷键保存触发器-VSCode-PHP中文网

vscode无法通过快捷键实现保存即检查，必须配置editor.codeactionsonsave；需确保eslint/prettier插件启用、语言匹配、命令为合法code action，且避免与editor.formatonsave冲突。

提升多人协同开发代码规范的vscode快捷键保存触发器

VSCode 本身没有“保存即触发代码规范检查”的快捷键，但可以通过 editor.codeActionsOnSave 配置实现等效效果——关键不在快捷键，而在保存行为的自动响应逻辑。

为什么不能靠快捷键绑定来实现保存触发？

VSCode 的快捷键系统（keybindings.json）只负责将按键组合映射到已有命令，比如 workbench.action.files.save 或 editor.action.formatDocument。它不支持“在按下 Ctrl+S 后额外执行 ESLint/Prettier”的链式操作——那是编辑器生命周期钩子要做的事，不是快捷键层能控制的。

Ctrl+S 默认只触发保存动作，不会自动调用格式化或修复命令
即使你把 editor.action.formatDocument 绑定到另一个快捷键（如 Ctrl+Alt+L），它仍需手动触发，无法和保存耦合
真正生效的保存后行为，必须通过 settings.json 中的 editor.codeActionsOnSave 控制

`editor.codeActionsOnSave` 怎么配才真正生效？

这个配置项是 VSCode 提供的“保存时自动执行代码操作”的唯一标准入口，但它有严格的前提条件：

对应工具（ESLint、Prettier）必须已安装且启用：比如 eslint 插件已启用，并在 eslint.validate 中声明了语言类型
when 条件隐含生效：只有当前文件属于被支持的语言（如 javascript）、且编辑器焦点在该文档中，才会触发
命令必须可被识别为“code action”：不是所有命令都支持挂载到 codeActionsOnSave，例如 git.commit 就不行

典型有效配置：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

[{
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true,
    "source.organizeImports": true
  }
}]

注意：source.fixAll.eslint 是 ESLint 插件注册的 code action ID，不是随便起的名字；而 editor.action.formatDocument 不能直接写在这里——它属于编辑器原生命令，需通过 "editor.formatOnSave": true 单独开启。

多人协作时容易踩的三个坑

团队统一配置后，常因以下细节导致“保存没反应”：

"editor.formatOnSave": true 和 "editor.codeActionsOnSave" 冲突：如果同时开了这两项，Prettier 和 ESLint 可能打架，建议只留一个（推荐用 codeActionsOnSave + ESLint 的 fix 功能）
语言模式未匹配：比如文件后缀是 .ts，但 eslint.validate 只写了 ["javascript"]，那保存时 ESLint 根本不介入
工作区覆盖用户设置：项目根目录下的 .vscode/settings.json 会优先于用户级设置，但若里面没写 codeActionsOnSave，就退回到用户默认值——新人容易漏掉这项