VSCode编码规范插件的自动修复设置

老敏吖_4610

老敏吖_4610

2026-08-31

807人浏览

原创

vscode自动修复代码必须依赖插件+精确配置,核心开关是editor.codeactionsonsave;eslint.autofixonsave已废弃;需正确配置验证语言、规则文件路径、本地eslint包及插件版本,并区分可修复与不可修复规则。

vscode编码规范插件的自动修复设置

VSCode 本身不自动修复代码,所有“保存即修”行为都依赖插件 + 精确配置,缺一不可。光装 ESLint 或 Stylelint 插件,但没开 editor.codeActionsOnSave,等于关着水龙头拧开水阀。

必须配 editor.codeActionsOnSave 才能触发自动修复

这个设置是唯一有效的开关,eslint.autoFixOnSave 已废弃(VSCode 1.80+ 不再识别)。它不是可选项,而是硬性前提。

  • "editor.codeActionsOnSave": { "source.fixAll.eslint": true } —— JavaScript/TypeScript 项目只走这条路径
  • "editor.codeActionsOnSave": { "source.fixAll.stylelint": true } —— CSS/SCSS 项目用这个(需安装官方 Stylelint 插件)
  • "editor.codeActionsOnSave": { "source.fixAll": true } —— 小心!这会同时调 ESLint、Prettier、TypeScript 等所有可用修复器,极易冲突
  • 如果项目同时用 ESLint 和 Prettier,必须禁用 Prettier 的保存修复:"editor.formatOnSave": false,否则分号刚加上,立刻被删掉

插件得认得你的文件类型,否则规则压根不跑

ESLint 默认只校验 .js 文件,.vue、.ts、.html 都要显式声明,否则状态栏显示 “ESLint is running”,但你写满 template 也不会报错。

VSCode
VSCode

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

下载
  • Vue 项目必须加:"eslint.validate": ["javascript", "typescript", "vue", {"language": "vue", "autoFix": true}]
  • TypeScript 项目要确保 parser 正确:parser: '@typescript-eslint/parser',且已安装 @typescript-eslint/eslint-plugin
  • CSS 类文件若用 Stylelint,需在 settings.json 中加:"stylelint.enable": true,并确认 .stylelintrc.* 存在
  • 状态栏右下角没出现 ESLint / Stylelint 图标,或悬停提示 “No config found”,说明配置文件路径或命名错了(如写成 .eslintrc 而非 .eslintrc.js)

不是所有规则都能修,得看文档里有没有 ✅ Fixable

ESLint 官网每条规则页右上角标有 ✅ 表示支持自动修复;❌ 就算配对了也白搭。别指望它帮你重写逻辑、补全 hook 依赖或把 alert() 换成 toast()。

  • 可修的常见规则:semi、quotes、indent、no-trailing-spaces、no-unused-vars(仅删除未使用变量,不改引用)
  • 不可修的典型规则:react-hooks/exhaustive-deps(依赖数组漏项)、complexity(圈复杂度超限)、no-alert(删掉 alert 是修,但替换成用户友好的提示不是)
  • 运行 npx eslint --print-config src/App.tsx 可验证当前文件实际生效的规则和 fixable 值,比猜靠谱

本地 ESLint 包必须存在,插件只是个遥控器

VSCode ESLint 插件不会自带 eslint 可执行文件,它只是启动一个子进程去调你项目里的 node_modules/.bin/eslint。没装,就卡在 “ESLint is working” 或直接报错。

  • 项目级安装优先:npm install eslint --save-dev(不要全局装,避免版本错乱)
  • 若用 eslint.config.js(ESLint v8.52+ 新格式),插件版本必须 ≥ v2.4.10,旧版直接不识别
  • 报 Failed to load config?先检查 node_modules 是否完整,再确认 VSCode 当前工作区打开的是项目根目录(不是某层子文件夹)
  • 插件装完必须重启 VSCode,否则 eslint.validate 可能不生效,尤其 Vue 项目里 <script setup></script> 块不标错,基本就是这原因

最常被忽略的一点:自动修复只发生在“保存”那一刻,它不干预你敲代码的过程,也不重写业务逻辑。能修的只是风格类、语法糖类问题;真正影响运行时的错误(比如拼错变量名但同名变量恰好存在),静态工具根本不敢动。

相关文章

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

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

下载

相关标签:

vscode插件设置 vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

热门下载

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

精品课程

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