eslint 配置

本文详细介绍了如何在Vue和React项目中配置ESLint和Prettier,包括安装、配置文件设定、与编辑器(VSCode)的集成以及解决两者冲突的方法,确保代码风格统一和规范。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Vue项目eslint配置

要求
ESLint v6.2.0 及以上
Node.js v12.22.x、v14.17.x、v16.x 及以上

  1. 在项目中安装 eslint eslint-plugin-vue
    # npm 
    npm install --save-dev eslint eslint-plugin-vue
    # yarn
    yarn add -D eslint eslint-plugin-vue
    
  2. 配置 .eslintrc.* 文件配置规则 (以 .eslintrc.js 为例 )
    module.exports = {
      extends: [
      	/* vue 2 配置 */
        "plugin:vue/recommended",
    	"plugin:vue/essential",
    	"plugin:vue/strongly-recommended",
    	/* vue 3 配置 */
    	// "plugin:vue/vue3-recommended"
    	// "plugin:vue/vue3-essential"
    	// "plugin:vue/vue3-strongly-recommended"
      ],
      rules: {
        'vue/no-unused-vars': 'error'
      }
    }
    
  3. 与编辑器集成 (vs code)
    • 安装 dbaeumer.vscode-eslint 微软官方提供的扩展。
    • 在项目根目录创建 .vscode 文件夹,并添加 settings.json 文件如下图
      在这里插入图片描述
    • settings.json 文件添加如下配置 在这里插入图片描述
      代码如下:
      {
      	"editor.formatOnSave": true,
      	"eslint.validate": [
      		"javascript",
      		"javascriptreact",
      		"vue"
      	],
      	"vetur.validation.template": false
      }
      
  4. 协调 Prettier 冲突
    • 安装 eslint-config-prettier
      # npm
      npm install --save-dev eslint-config-prettier
      # yarn
      yarn add --dev eslint-config-prettier
      
    • .eslintrc.js 文件中添加如下图配置
      在这里插入图片描述
      vue 项目eslint配置完成

react 项目配置eslint

初始化:npx create-react-app app-ts --template typescript

基础eslint配置

我们以使用cra初始化的项目为例(见下图)
在这里插入图片描述

  1. 执行如下命令行
    npm install eslint --save-dev
    然后再执行
    npx eslint --init
    会进入问答模式,下图选项仅供参考在这里插入图片描述2. 你想如何使用 ESLint?To check syntax and find problems在这里插入图片描述3. 您的项目使用什么类型的模块?JavaScript modules (import/export)在这里插入图片描述
  2. 你的代码在哪里运行? Browser
    在这里插入图片描述
  3. 您希望您的配置文件采用什么格式? 放在单独的 JavaScript 文件里
    在这里插入图片描述
  4. 选择Yes
    在这里插入图片描述
    完成后会增加一个eslintrc.js文件
    在这里插入图片描述
    我们发现上图文件 eslintrc.js 文件中第一行有报错,我们在添加一个 .eslintignore 文件来修复这个问题,把.eslintrc.js 添加到忽略文件即可
    在这里插入图片描述
    这里需要注意⚠️ 不要把module.exports 改成 export default 会导致配置文件失效。。。
    在这里插入图片描述

进阶eslint配置

打开vscode设置,按照下图选择
在这里插入图片描述
根目录下会增加一个.vscode 文件夹,作用是仅在当前项目下配置有效
在这里插入图片描述
在vscode 扩展里安装eslint 插件
在这里插入图片描述
使用默认设置就可以,关闭eslint格式化功能(默认是关闭的)
在这里插入图片描述

配置 prettier

  1. 项目安装 pretter
    npm install --save-dev --save-exact prettier
  2. 创建 pretter 配置文件
    echo {}> .prettierrc.json
    {
    	"useTabs": true,
    	"arrowParens": "avoid",
    	"printWidth": 120,
    	"tabWidth": 2,
    	"semi": true,
    	"singleQuote": true,
    	"bracketSpacing": true,
    	"endOfLine": "auto",
    	"trailingComma": "none"
    }
    
  3. vscode 安装 pretter (点击跳转)
    pretter-vscode
  4. 安装 eslint-config-prettier 解决 pretter 与 eslint 冲突问题
    npm install --save-dev eslint-config-prettier在这里插入图片描述
    5. 设置默认使用 prettier 格式化程序
    在这里插入图片描述

react 项目配置 完成了

<think>嗯,用户想了解如何配置ESLint的详细教程和最佳实践。首先,我需要整理ESLint的基本配置步骤,包括安装、初始化配置文件、核心配置项这些内容。根据引用[1],用户可能需要从零开始配置,所以得先介绍安装过程,使用npm或者yarn安装ESLint。然后运行eslint --init生成配置文件,这里可能会有不同的配置文件格式,比如.eslintrc.js或者.json,需要解释它们的区别,如引用[2]提到的配置格式。 接下来,核心配置项是关键。env、parserOptions、rules这些部分要详细说明,比如设置env为browser和es2021,parserOptions的ecmaVersion和sourceType。rules部分要强调如何覆盖默认规则,比如关闭no-unused-vars或者调整缩进,引用[2]里提到的配置项功能需要在这里展开。 然后是扩展配置,用户可能不知道如何利用现有规则集,比如eslint:recommended或者插件如vuereact。引用[3]和[4]提到在ReactVue项目中的最佳实践,所以需要分别说明如何配置这些框架的ESLint,比如使用eslint-plugin-react或者eslint-plugin-vue,以及对应的parser设置。 集成Prettier也是一个重点,引用[1]和[5]都提到与Prettier的结合使用,需要介绍安装eslint-config-prettier来关闭冲突规则,并创建.prettierrc文件。这部分要说明如何避免格式冲突,确保两者协同工作。 自动化运行部分,用户可能希望将ESLint整合到开发流程中,比如在package.json中添加lint脚本,或者与Husky、lint-staged搭配使用,进行提交前的检查。引用[3]和[4]提到的自动化工具集成需要在这里举例说明,比如Husky的配置步骤。 最佳实践方面,需要强调团队统一配置的重要性,比如使用共享的配置文件或扩展名,定期更新规则,以及按需配置避免过度严格。引用[3]和[4]中的项目实践可以支持这些建议,比如在React中使用airbnb规则,在Vue中启用vue/essential规则。 最后,用户可能遇到的问题,比如如何解决与Prettier的冲突,或者处理TypeScript项目,需要给出解决方案,例如正确安装@typescript-eslint/parser和插件,调整parser配置。引用[2]中的高级配置可能涉及这些内容。 生成相关问题的时候,要覆盖不同框架的配置、性能优化、规则定制、与构建工具集成等,确保覆盖用户可能进一步探索的方向。例如,如何配置Vue项目的ESLint,或者提升检查性能的技巧,引用[2]和[5]中的内容可以作为相关问题的依据。 总之,需要结构清晰,分步骤讲解配置过程,结合不同框架的最佳实践,引用相关教程中的内容,确保信息准确可靠,同时解答用户可能遇到的常见问题,帮助他们有效配置ESLint。</think>### 如何配置 ESLint 详细教程和最佳实践 #### 一、基础配置步骤 1. **安装 ESLint** 使用 npm 或 yarn 全局或局部安装: ```bash npm install eslint --save-dev ``` 2. **初始化配置文件** 运行命令生成配置文件(如 `.eslintrc.js` 或 `.eslintrc.json`): ```bash npx eslint --init ``` 根据提示选择配置风格(如 JavaScriptReactVue 等)[^1][^2]。 3. **核心配置项解析** - **`env`**:定义代码运行环境(如 `browser: true`、`es2021: true`) - **`parserOptions`**:指定语法解析配置(如 `ecmaVersion: 13`、`sourceType: "module"`) - **`rules`**:自定义规则(如 `"no-unused-vars": "warn"`) ```javascript module.exports = { env: { browser: true, es2021: true }, parserOptions: { ecmaVersion: 13 }, rules: { "indent": ["error", 2] } }; ``` --- #### 二、扩展配置与最佳实践 1. **扩展推荐规则集** 使用 `extends` 继承社区最佳实践,如: ```javascript extends: ["eslint:recommended", "plugin:react/recommended"] ``` - `eslint:recommended`:ESLint 官方推荐规则 - `plugin:vue/essential`:Vue 项目基础规则[^4] 2. **框架特定配置** - **React 项目**:添加 `eslint-plugin-react` 并配置 `parser` 为 `@babel/eslint-parser`[^3] - **Vue 项目**:使用 `eslint-plugin-vue` 并设置 `parser: "vue-eslint-parser"`[^4] 3. **集成 Prettier** 安装 `eslint-config-prettier` 关闭与 Prettier 冲突的规则: ```bash npm install prettier eslint-config-prettier --save-dev ``` 配置 `.eslintrc.js`: ```javascript extends: ["prettier"] ``` 创建 `.prettierrc` 定义代码风格[^1][^5]。 --- #### 三、自动化运行与优化 1. **添加脚本命令** 在 `package.json` 中配置: ```json "scripts": { "lint": "eslint src/**/*.{js,jsx}" } ``` 2. **结合 Husky 实现提交前检查** 安装 Husky 并配置预提交钩子: ```bash npx husky-init && npm install ``` 在 `.husky/pre-commit` 中添加: ```bash npm run lint ``` 3. **性能优化技巧** - 使用 `--cache` 标志启用缓存 - 通过 `.eslintignore` 忽略无需检查的文件(如 `node_modules/`)[^2] --- #### 四、最佳实践总结 1. **团队一致性** - 共享配置文件(如发布为 npm 包) - 定期更新规则以适应项目需求 2. **按需配置** - 避免过度严格,逐步增加规则 - 针对项目类型选择扩展(如 TypeScript 项目需添加 `@typescript-eslint/parser`) ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Gleason.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值