VSCode安装ESLint插件实现代码规范自动修复

梦晨君_4258

梦晨君_4258

2026-09-05

609人浏览

原创

必须启用 editor.codeactionsonsave 并配置为 {"source.fixall.eslint": true},同时确保 eslint.validate 覆盖目标语言、项目存在生效的 eslint 配置文件且插件正确安装重启。

vscode安装eslint插件实现代码规范自动修复

装了插件但保存不自动修?不是插件没装好,而是 editor.codeActionsOnSave 没开、eslint.validate 没覆盖目标语言、或项目里压根没生效的 .eslintrc.* 文件。

必须启用 editor.codeActionsOnSave 才能保存时自动修复

VSCode 1.80+ 已废弃 eslint.autoFixOnSave,现在唯一有效的开关是 editor.codeActionsOnSave。它不是“可选项”,而是触发自动修复的唯一路径。

  • 在 settings.json 中必须写成:
    "editor.codeActionsOnSave": { "source.fixAll.eslint": true }
  • 别写成 "source.fixAll": true——这会拉上 Prettier、TypeScript 等所有格式化器一起上,大概率冲突报错
  • 也别写成 "source.fixAll.eslint": "explicit"——这只在手动按 Ctrl+(或 Cmd+)调出快速修复菜单时才生效,不响应保存
  • 如果同时用了 Prettier,editor.formatOnSave 必须设为 false,否则 ESLint 加完分号,Prettier 立刻删掉

eslint.validate 必须显式声明 vue 和 html 语言

默认只检查 .js 文件。哪怕你写了 <template></template> 或 <div class="foo">,也不会被校验——除非你告诉它这些也归 ESLint 管。 <ul> <li>正确写法(支持 Vue 单文件组件):<pre class="brush:php;toolbar:false;">&quot;eslint.validate&quot;: [&quot;javascript&quot;, &quot;typescript&quot;, &quot;vue&quot;, {&quot;language&quot;: &quot;vue&quot;, &quot;autoFix&quot;: true}]</pre> </li> <li>HTML 文件要参与校验,必须加:<code>{"language": "html", "autoFix": true},否则引号风格、空格等不会被修正

  • 错误写法:"eslint.validate": ["javascript"]——此时 .vue 文件完全不会触发 ESLint
  • Vue 3 + Vite 项目中,若用的是 Volar(非已过时的 Vetur),还需在 eslint.options.extensions 显式加上 ".ts" 和 ".tsx"
  • 项目必须有真正生效的 ESLint 配置文件

    插件装完不重启 VSCode,eslint.validate 很可能读不到 .vue 或 .html 文件;状态栏右下角没显示 “ESLint is running”,基本说明配置没加载成功。

    VSCode
    VSCode

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

    下载
    • 确认配置文件存在且命名正确:.eslintrc.js、.eslintrc.cjs、.eslintrc.json 或 package.json 中的 eslintConfig 字段
    • 运行 npx eslint --print-config src/App.js(替换为任意源文件路径),看输出是否含预期规则和 fixable 值
    • 插件名必须是 ESLint(作者:Microsoft),不是 eslint(小写)或其它同名插件;装完必须重启 VSCode 才生效
    • 若用 eslint.config.js(ESLint v8.52+ 新格式),VSCode 插件需 ≥ v2.4.10 才支持

    不是所有规则都支持自动修复,得看文档标不标 ✅ Fixable

    eslint --fix 只能修带 fixable: "problem" 或 fixable: "style" 的规则。圈复杂度、依赖数组漏写、no-alert 这类逻辑型问题,ESLint 不会、也不能帮你改代码逻辑。

    • 常用可修复规则:semi、quotes、indent、no-trailing-spaces、no-unused-vars(部分情况)
    • 不可修复规则:react-hooks/exhaustive-deps、vue/multi-word-component-names(它只在手动触发快速修复时给建议名,不静默重命名)
    • 验证某条规则是否当前可修复:在报错行按 Ctrl+.(Windows/Linux)或 Cmd+.(macOS),弹出菜单里出现 Fix 'xxx' problem 才算真支持
    • 规则配置必须是数组形式,例如 "semi": ["error", "always"];写成 "semi": "error" 在某些旧版本中会禁用修复能力

    最常被忽略的一点:规则可修复 ≠ 项目配置让它可修复。即使文档标了 ✅,如果 parserOptions.parser 没配对(比如 Vue 3 项目没设 @typescript-eslint/parser),或者 eslint-plugin-vue 版本和 Vue 版本不匹配,那些规则根本不会运行,更谈不上修复。

    相关文章

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    vscode是什么_vscode怎么安装配置
    vscode是什么_vscode怎么安装配置

    VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

    2023.06.30

    1395

    18

    vscode怎么运行代码
    vscode怎么运行代码

    vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

    2023.07.21

    2952

    3

    vscode使用的框架介绍
    vscode使用的框架介绍

    VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.14

    2009

    12

    vscode一般用来写什么语言
    vscode一般用来写什么语言

    VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.14

    1727

    8

    vscode可以写什么语言
    vscode可以写什么语言

    vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.15

    2607

    12

    vscode中文设置方法
    vscode中文设置方法

    方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.15

    1838

    14

    vscode用途介绍
    vscode用途介绍

    Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.15

    1262

    10

    vscode和visualstudio的区别
    vscode和visualstudio的区别

    Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.15

    1116

    8

    vscode设置中文界面不生效解决方法
    vscode设置中文界面不生效解决方法

    vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

    2024.03.15

    494

    5

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程