VSCode怎么解决ESLint与Prettier冲突 - 规则覆盖与红黄波浪线终极消灭法

老墨大大_5783

老墨大大_5783

2026-03-20

796人浏览

原创

ESLint 与 Prettier 冲突的根本原因是职责未分离:需禁用 ESLint 中所有格式类规则,通过 eslint-config-prettier 统一交由 Prettier 处理格式,VSCode 中仅启用 Prettier 格式化、关闭 ESLint auto-fix,确保规则加载顺序正确且配置生效一致。

vscode怎么解决eslint与prettier冲突 - 规则覆盖与红黄波浪线终极消灭法

ESLint 报错但 Prettier 自动格式化后又报错

这是最典型的冲突表现:保存文件时,Prettier 把代码按自己规则重排(比如改缩进、加尾逗号),ESLint 却立刻用另一套规则检查,发现“不符合 eslint-config-airbnb 的 indent 规则”或“comma-dangle 不该有”,于是红波浪线反复闪现。

根本原因不是二者不能共存,而是没明确「谁管校验、谁管格式」。必须让 ESLint 完全信任 Prettier 的格式结果,不重复检查格式类规则。

  • 删掉 ESLint 配置里所有和格式相关的规则,例如:"indent"、"quotes"、"semi"、"comma-dangle"、"arrow-spacing"
  • 安装并启用 eslint-config-prettier:它会主动关闭 ESLint 中与 Prettier 冲突的全部规则
  • 在 .eslintrc.js 的 extends 数组末尾加上 "prettier"(注意:必须放最后,否则会被前面的配置覆盖)

VSCode 保存时只触发 Prettier,不跑 ESLint auto-fix

很多人以为装了 ESLint 和 Prettier 插件就自动协同,其实 VSCode 默认不会让它们协商谁来改代码。保存时若两个插件都启用了 “Format on Save”,就会互相打架——Prettier 格式化完,ESLint 立刻按旧规则修一版,再触发 Prettier 又修一遍。

正确做法是:只留一个格式化入口,把 ESLint 的 auto-fix 降级为纯检查(报错/警告),格式动作全交给 Prettier。

  • 关掉 ESLint 插件的自动修复:在 VSCode 设置中搜 eslint.autoFixOnSave,设为 false
  • 确保 editor.formatOnSave 为 true,且 editor.defaultFormatter 设为 esbenp.prettier-vscode
  • 如需手动触发 ESLint 修复(比如修逻辑错误),用快捷键 Ctrl+Shift+P → 输入 ESLint: Fix all auto-fixable Problems,而不是依赖保存

项目里 .prettierrc 和 .eslintrc 同时存在,但规则还是对不上

常见于老项目迁移:.prettierrc 里写了 "semi": false,但 ESLint 仍报“missing semicolon”。这说明 ESLint 没读到 eslint-config-prettier,或者读到了但被其他配置覆盖。

VSCode
VSCode

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

下载

关键不是文件有没有,而是加载顺序和生效范围是否一致。尤其注意工作区设置和全局设置的优先级差异。

  • 检查 .eslintrc.js 中 extends 是否包含 "prettier",且它出现在数组最后一个位置
  • 确认没有在 package.json 的 eslintConfig 字段里重复定义规则,导致覆盖了 .eslintrc
  • 运行 npx eslint --print-config path/to/file.js 查看最终合并后的规则,确认 semi、quotes 等已被设为 off

保存后红波浪线消失但黄波浪线还在(ESLint warning 不消失)

黄波浪线通常是 ESLint 的 warning 级别提示,比如 no-console、no-unused-vars。这类问题和 Prettier 无关,但容易误以为是冲突——其实是 ESLint 正常工作,只是你没处理或没忽略。

VSCode 默认显示 warning,但很多人只盯着 red,忽略了 yellow 其实也在说话。

  • 检查 .eslintrc.js 中对应规则的 level,是 "warn" 还是 "error";想彻底隐藏 yellow,可临时改为 "off",但不推荐
  • 如果 warning 是合理提醒(如开发环境允许 console.log,但生产禁用),可在代码行尾加注释关闭:// eslint-disable-line no-console
  • 确保 VSCode 的 eslint.packageManager 设置正确(如 "npm" 或 "pnpm"),否则可能加载了旧版本 ESLint,规则解析不一致

真正难的不是配通,而是每次新增依赖、升级插件、切分支时,这些配置容易悄无声息地失效。建议把 npx eslint --print-config 当成日常快检动作,比盯着波浪线猜更省时间。

相关文章

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

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

下载

相关标签:

vscode

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2335

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3842

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1276

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4459

7

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end='\n', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.27

3480

5

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

2026.02.03

269

24

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1869

3

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.06.27

1231

7

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

1069

5

热门下载

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

精品课程

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