Eslint和Prettier的配置与冲突处理

前言

统一的前端开发规范,可有助于代码质量提升与团队协作效率提高。通常做法是eslint与prettier的配合进行实现。

  • eslint中包含三类规则:代码质量检查、代码错误检查、代码风格检查
  • prettier包含:代码风格检查

代码风格部分会冲突,我们会对冲突部分进行处理

Eslint

  1. 安装
bash 复制代码
npm i eslint -D
npm init @eslint/config

按照提示完成初始配置,生成.eslintrc.json配置文件

  1. 使用
  • 通过命令的形式修复代码
bash 复制代码
npx eslint . --fix
  • vscode插件,使得vscode调用eslint能力,实现实时问题提示,以及保存触发修复

插件安装后,修改vscode配置文件setting.json

json 复制代码
"editor.codeActionsOnSave": { 
  "source.fixAll.eslint": "explicit" // 保存使用eslint进行修复
}

Prettier

eslint的代码格式做的不够彻底,需要prettier进行增强。并且prettier支持更多的文件格式的格式化。

  1. 安装
bash 复制代码
npm i prettier -D

配置.prettierrc.json

2. 使用

  • 通过命令的形式修复代码
bash 复制代码
npx prettier --write .
  • vscode插件,使得vscode调用prettier能力,实现保存触发修复

插件安装后,修改vscode配置文件setting.json

json 复制代码
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",

冲突处理

在进行上述配置后,vscode中保存后,出现风格规则不一致,eslint报错问题,现在来解决冲突

  1. 关掉与Prettier产生冲突的ESlint格式相关配置

使用eslint-config-prettier这个规则集,关闭eslint和prettier冲突的规则设置

bash 复制代码
npm i eslint-config-prettier -D

.eslintrc.json加入perttier规则集

json 复制代码
{
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended",
    "prettier" // 覆盖eslint格式配置,写在最后
  ],
}
  1. 不再单独运行prettier,将prettier集成到eslint中,作为一项rule进行提示与修复

使用eslint-plugin-prettier这个插件

bash 复制代码
npm i eslint-plugin-prettier -D

.eslintrc.json加入perttier插件

json 复制代码
{
  "plugins": ["@typescript-eslint", "prettier"], // 注册插件
    "rules": {
      "prettier/perttier": "error", // 加入prettier规则
    }
}
  1. 将上面两个步骤合在一起就是下面的配置,也是官方的推荐配置
json 复制代码
{
  "extends": ["plugin:prettier/recommended"]
}

plugin:prettier/recommended帮我们做了如下事情:

json 复制代码
{
  "extends": ["prettier"], // 使用eslinst-config-prettier中的配置项
  "plugins": ["prettier"], // 注册该prettier插件
  "rules": {
    "prettier/prettier": "error", // 在eslint中运行prettier,并启用该插件提供的规则
    "arrow-body-style": "off", // 关闭规则
    "prefer-arrow-callback": "off" // 关闭规则
  }
}

总结

eslint 和 prettier 配置使用需要进行如下操作:

  1. 首先下载 eslint, prettier, eslint-config-prettier, eslint-plugin-prettier
bash 复制代码
npm install --save-dev eslint prettier eslint-config-prettier eslint-plugin-prettier
  1. 项目根目录添加 .eslintrc.js 和 .prettierrc
json 复制代码
// .eslintrc.json
{
  "extends": ["plugin:prettier/recommended"]
}
// .prettierrc.json
{
  "singleQuote": true // 根据需要配置
}
  1. 补充 ESLint 从 v8.53.0 起,将弃用代码风格相关规则

参考:

  1. juejin.cn/post/705012...
  2. juejin.cn/post/715689...
  3. juejin.cn/post/692456...
  4. juejin.cn/post/732251...
  5. cloud.tencent.com/developer/a...
相关推荐
小兵张健8 小时前
价值1000的 AI 工作流:Codex 通用前端协作模式
前端·aigc·ai编程
sunny_9 小时前
面试踩大坑!同一段 Node.js 代码,CJS 和 ESM 的执行顺序居然是反的?!99% 的人都答错了
前端·面试·node.js
拉不动的猪9 小时前
移动端调试工具VConsole初始化时的加载阻塞问题
前端·javascript·微信小程序
ayqy贾杰11 小时前
Agent First Engineering
前端·vue.js·面试
IT_陈寒11 小时前
SpringBoot实战:5个让你的API性能翻倍的隐藏技巧
前端·人工智能·后端
iceiceiceice11 小时前
iOS PDF阅读器段评实现:如何从 PDFSelection 精准还原一个自然段
前端·人工智能·ios
大金乄11 小时前
封装一个vue2的elementUI 表格组件(包含表格编辑以及多级表头)
前端·javascript
葡萄城技术团队12 小时前
【性能优化篇】面对万行数据也不卡顿?揭秘协同服务器的“片段机制 (Fragments)”
前端
程序员阿峰12 小时前
2026前端必备:TensorFlow.js,浏览器里的AI引擎,不写Python也能玩转智能
前端
Jans13 小时前
Shipfe — Rust 写的前端静态部署工具:一条命令上线 + 零停机 + 可回滚 + 自动清理
前端