source.fixAll.eslint必须显式配置为true才能触发保存修复,且需配合eslint.validate和eslint.options.extensions支持.vue文件,parserOptions.parser须设为"@typescript-eslint/parser"并覆盖*.vue。

source.fixAll.eslint 必须显式开启,否则保存时不会触发任何修复 —— 这不是默认行为,也不是靠装了插件就自动生效。
editor.codeActionsOnSave 配置必须精准匹配 ESLint
VSCode 的保存修复动作是“按提供者注册”的,不是全局开关。很多人误写成 "source.fixAll": true,这只会触发 VSCode 内置的通用修复(比如重命名变量),跟 ESLint 无关。
- ✅ 正确写法(写在
settings.json中):"editor.codeActionsOnSave": { "source.fixAll.eslint": true } - ❌ 错误写法:
-
"source.fixAll": true(不指定提供者,ESLint 不响应) -
"source.fixAll.eslint": "auto"或true写成字符串"true"(JSON 布尔值不能加引号)
-
- 如果同时启用了 Prettier,不要再开
"source.fixAll": true,否则两者可能互相覆盖或冲突 - Vue 文件里
<script setup></script>中的 TS 代码,也依赖这个开关才能被修复
eslint.validate 和 eslint.options.extensions 要双保险
ESLint 插件默认只校验 .js 和 .jsx,对 .vue 是“视而不见”的,除非你明确告诉它:
-
eslint.validate告诉 VSCode:哪些语言模式要交给 ESLint 检查 -
eslint.options.extensions告诉 ESLint:哪些后缀名的文件要加载并解析
两者缺一不可,尤其在 Vue 项目中:
立即学习“前端免费学习笔记(深入)”;
- ✅ 必须包含:
"eslint.validate": ["javascript", "typescript", "vue"], "eslint.options": { "extensions": [".js", ".ts", ".vue"] } - ⚠️ 注意:
"vue"在validate列表中不是可选的 —— 它对应的是 Vetur 提供的vue语言模式,没有它,.vue文件根本不会进 ESLint 流程 - 如果用的是
eslint.config.js(Flat Config 新格式),还需额外加:"eslint.experimental.useFlatConfig": true
parserOptions.parser 不匹配会导致 .vue 里的 JS/TS 完全不修复
Vue 单文件组件中的 <script></script> 块,ESLint 默认不识别。它需要通过 eslint-plugin-vue + 正确 parser 才能拆解并分析。
常见失效场景:
-
parserOptions.parser留空或写错,比如:- 写成
"@typescript-eslint/eslint-parser"(已废弃,应为"@typescript-eslint/parser") - Vue 3 + TS 项目里没为
*.vue单独配 parser,导致它走默认 JS 解析器,类型检查和修复全部失效
- 写成
-
overrides没覆盖"*.vue",规则压根没应用到文件上
推荐写法(在 .eslintrc.js 中):
module.exports = {
// ...其他配置
overrides: [
{
files: ["*.vue"],
parserOptions: {
parser: "@typescript-eslint/parser", // Vue 3 + TS 必须这样写
ecmaVersion: 2020,
sourceType: "module"
}
}
]
}大多数“修复失败”其实是因为规则本身不可修
ESLint 的 --fix 只能处理语法层面、无歧义的格式类问题。保存时调用的正是这个能力,所以它有明确边界:
- ✅ 可自动修复的典型规则:
-
quotes(单双引号) -
semi(分号) -
comma-dangle(尾随逗号) -
no-unused-vars(删未使用变量)
-
- ❌ 不可修复但会持续报错的规则(保存时静默跳过):
-
vue/multi-word-component-names(不能自动重命名组件) -
no-console(不会删console.log,只报错) -
complexity(圈复杂度超限,无法自动降复杂) -
vue/require-default-prop(虽不可修,但点灯泡Ctrl+.可快速插入)
-
如果你发现某条规则总报红却不修复,先去 ESLint 官方规则文档 查它是否标有 ✅ “Fixable”。
真正容易被忽略的点是:你以为它该修,其实是规则设计上就不支持自动修复 —— 这不是配置问题,是能力边界。


















