重庆工信部网站四川省住房和城乡建设厅网站官网
前言
在现代前端开发中，代码质量与代码风格的统一是两个非常重要的方面。良好的代码质量能减少 bug 的产生，而统一的代码风格则能提高团队协作的效率。为了实现这两个目标，我们通常会使用一些工具。
为了保证代码的可读性和维护性，我们通常会使用代码检查工具（如 ESLint）和代码格式化工具（如 Prettier）。然而，这两者在结合使用时可能会产生一些冲突。那么，如何高效地结合 ESLint 和 Prettier 呢？
工具介绍
ESLint
ESLint 是一种静态代码分析工具，用于识别和报告 JavaScript 代码中的模式和问题。它可以帮助我们找出代码中的潜在错误（如未使用的变量、未定义的变量等），并且能够根据配置的规则提示代码风格问题。
Prettier
Prettier 是一个代码格式化工具，它可以根据预定义的规则自动格式化代码，使代码风格一致。Prettier 是一种“有意见的”（opinionated）格式化工具，它会覆盖代码风格相关的 ESLint 规则。
为什么要结合使用？
虽然 ESLint 和 Prettier 都涉及代码风格问题，但它们有不同的侧重点：
- eslint 专注于代码质量和潜在的错误检测。它能捕获逻辑错误和潜在的 bug，比如未定义的变量、未使用的变量等。
- prettier 专注于代码格式。它能确保代码风格一致，比如缩进、单引号与双引号的使用、分号的添加等。
通过结合使用 ESLint 和 Prettier，我们可以既保证代码质量，又保证代码风格一致。
冲突情况
尽管我们已经做了很多工作来避免冲突，但在实际使用中仍然可能会遇到一些问题。以下是常见的冲突及其解决方法：
1. 规则覆盖问题
某些情况下，ESLint 和 Prettier 的规则可能会相互覆盖，比如缩进、分号等。通过使用 eslint-config-prettier，我们已经禁用了所有可能与 Prettier 冲突的 ESLint 规则。
2. 配置不一致
确保 ESLint 和 Prettier 的配置文件都存在并且配置一致。比如，如果 Prettier 配置了使用单引号，而 ESLint 没有相应的配置，会导致冲突。
// .eslintrc
{"extends": ["plugin:prettier/recommended"]
}// prettier.config.js
module.exports = {singleQuote: true
}
3. 编辑器插件冲突
有时，编辑器中的 ESLint 和 Prettier 插件可能会产生冲突。确保你使用的插件版本是最新的，并且配置正确。
使用步骤
步骤一：安装依赖
首先，我们需要安装必要的依赖。假设你已经有一个基于 Node.js 的项目，执行以下命令安装 ESLint 和 Prettier：
npm install --save-dev eslint prettier eslint-config-prettier eslint-plugin-prettier
上述命令安装了以下几个包：
- eslint：ESLint 核心库。
- prettier：Prettier 核心库。
- eslint-config-prettier：禁用所有可能与 Prettier 冲突的 ESLint 规则。
- eslint-plugin-prettier：将 Prettier 作为 ESLint 的一个规则，方便在 ESLint 中运行 Prettier 并报告格式化错误。
步骤二：配置 ESLint
在项目根目录下创建或编辑 .eslintrc 文件，添加以下配置：
{"extends": ["eslint:recommended","plugin:prettier/recommended"],"plugins": ["prettier"],"rules": {"prettier/prettier": "error"}
}
这段配置做了几件事：
- 扩展了 ESLint 推荐的规则集。
- 使用 eslint-plugin-prettier 提供的推荐配置。
- 将 Prettier 的格式化规则作为 ESLint 的一部分，任何 Prettier 格式化问题都会被报告为 ESLint 错误。
步骤三：配置 Prettier
在项目根目录下创建或编辑 prettier.config.js 文件，添加 Prettier 的配置：
module.exports = {semi: false,singleQuote: true,trailingComma: "es5",printWidth: 80,tabWidth: 2
}
你可以根据自己的代码风格需求调整这份配置。
步骤四：在编辑器中集成
大多数现代代码编辑器（如 VSCode）都支持 ESLint 和 Prettier 插件。确保你安装并启用了相关插件，以便在编码时能够实时看到格式化和检查结果。
总结
eslint 和 prettier 分别在代码质量和代码格式化方面发挥着重要作用。通过结合使用它们，我们可以在保证代码高质量的同时，确保代码风格的一致性，从而提升开发效率，减少团队协作中的摩擦。