VSCode“保存时运行”功能可自动执行ESLint检查与Prettier格式化。需开启Format On Save、配置默认格式化器及eslint.run:onSave,并推荐按“先ESLint修复、后格式化”顺序执行,通过editor.codeActionsOnSave控制链式调用,且建议使用工作区.settings.json实现项目级独立配置。

VSCode 的“保存时运行”功能,能让你在 Ctrl+S(或 Cmd+S)的瞬间自动完成代码检查(如 ESLint)和格式化(如 Prettier),无需手动触发,既省事又确保团队代码风格统一。
启用保存时格式化
这是最常用的基础设置。VSCode 自带格式化支持,但需明确开启并指定默认格式化工具:
- 打开设置(Ctrl+,),搜索 format on save,勾选 Editor: Format On Save
- 确保项目中已安装并配置好格式化扩展(如 Prettier),且在工作区或用户设置中设为默认:
"editor.defaultFormatter": "esbenp.prettier-vscode" - 如需仅对特定语言生效,可用语言专属设置,例如:
"[javascript]": { "editor.formatOnSave": true }
保存时运行代码检查(ESLint)
ESLint 默认不自动修复,需配合保存动作启用“保存即修复”:
- 安装 ESLint 扩展,并在项目根目录有有效配置(.eslintrc.js 或 eslint.config.js)
- 在设置中开启:
"eslint.run": "onSave"(控制何时触发检查)
"eslint.codeActionOnSave.mode": "all"(启用所有可自动修复的问题) - 注意:部分规则(如 no-console)无法自动修复,只会标出警告;而 semi、quotes 等则会直接修正
组合使用:先检查再格式化,还是反过来?
顺序很重要——错误的执行顺序可能导致格式化覆盖 ESLint 修复,或产生冲突:
- 推荐顺序:先 ESLint 自动修复,再格式化。因为 ESLint 的修复更语义化(如重命名变量、补全 return),而格式化专注空格缩进等样式
- 通过设置控制执行链:
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }
该配置会优先触发 ESLint 修复,之后再走 formatOnSave 流程 - 若发现格式异常,可临时禁用某一项测试顺序,或检查扩展间是否冲突(如 Prettier 和 ESLint 规则重复)
按项目开关,避免影响其他工程
不同项目可能用不同规范(如 Vue 项目配 Vetur + ESLint,Python 项目用 Black + Flake8),应优先使用工作区设置:
- 在项目根目录创建 .vscode/settings.json,写入当前项目专用配置
- 例如:
{
"editor.formatOnSave": true,
"eslint.run": "onSave",
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }
} - 这样切换到其他文件夹时,不会沿用旧规则,也方便把配置纳入 Git 协作










