eslint配置

eslint中文官网:http://eslint.cn/

 首先安装eslint

pnpm i eslint -D

生成配置文件:.eslint.cjs

npx eslint --init

.eslint.cjs配置文件

module.exports = {
   //运行环境
    "env": { 
        "browser": true,//浏览器端
        "es2021": true,//es2021
    },
    //规则继承
    "extends": [ 
       //全部规则默认是关闭的,这个配置项开启推荐规则,推荐规则参照文档
       //比如:函数不能重名、对象不能出现重复key
        "eslint:recommended",
        //vue3语法规则
        "plugin:vue/vue3-essential",
        //ts语法规则
        "plugin:@typescript-eslint/recommended"
    ],
    //要为特定类型的文件指定处理器
    "overrides": [
    ],
    //指定解析器:解析器
    //Esprima 默认解析器
    //Babel-ESLint babel解析器
    //@typescript-eslint/parser ts解析器
    "parser": "@typescript-eslint/parser",
    //指定解析器选项
    "parserOptions": {
        "ecmaVersion": "latest",//校验ECMA最新版本
        "sourceType": "module"//设置为"script"(默认),或者"module"代码在ECMAScript模块中
    },
    //ESLint支持使用第三方插件。在使用插件之前,您必须使用npm安装它
    //该eslint-plugin-前缀可以从插件名称被省略
    "plugins": [
        "vue",
        "@typescript-eslint"
    ],
    //eslint规则
    "rules": {
    }
}

vue3环境代码校验插件

# 让所有与prettier规则存在冲突的Eslint rules失效,并使用prettier进行代码检查
"eslint-config-prettier": "^8.6.0",
"eslint-plugin-import": "^2.27.5",
"eslint-plugin-node": "^11.1.0",
# 运行更漂亮的Eslint,使prettier规则优先级更高,Eslint优先级低
"eslint-plugin-prettier": "^4.2.1",
# vue.js的Eslint插件(查找vue语法错误,发现错误指令,查找违规风格指南
"eslint-plugin-vue": "^9.9.0",
# 该解析器允许使用Eslint校验所有babel code
"@babel/eslint-parser": "^7.19.1",

安装指令

pnpm install -D eslint-plugin-import eslint-plugin-vue eslint-plugin-node eslint-plugin-prettier eslint-config-prettier eslint-plugin-node @babel/eslint-parser

修改.eslintrc.cjs配置文件

module.exports = {
  env: {
    browser: true,
    es2021: true,
    node: true,
    jest: true,
  },
  /* 指定如何解析语法 */
  parser: 'vue-eslint-parser',
  /** 优先级低于 parse 的语法解析配置 */
  parserOptions: {
    ecmaVersion: 'latest',
    sourceType: 'module',
    parser: '@typescript-eslint/parser',
    jsxPragma: 'React',
    ecmaFeatures: {
      jsx: true,
    },
  },
  /* 继承已有的规则 */
  extends: [
    'eslint:recommended',
    'plugin:vue/vue3-essential',
    'plugin:@typescript-eslint/recommended',
    'plugin:prettier/recommended',
  ],
  plugins: ['vue', '@typescript-eslint'],
  /*
   * "off" 或 0    ==>  关闭规则
   * "warn" 或 1   ==>  打开的规则作为警告(不影响代码执行)
   * "error" 或 2  ==>  规则作为一个错误(代码不能执行,界面报错)
   */
  rules: {
    // eslint(https://eslint.bootcss.com/docs/rules/)
    'no-var': 'error', // 要求使用 let 或 const 而不是 var
    'no-multiple-empty-lines': ['warn', { max: 1 }], // 不允许多个空行
    'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
    'no-unexpected-multiline': 'error', // 禁止空余的多行
    'no-useless-escape': 'off', // 禁止不必要的转义字符

    // typeScript (https://typescript-eslint.io/rules)
    '@typescript-eslint/no-unused-vars': 'error', // 禁止定义未使用的变量
    '@typescript-eslint/prefer-ts-expect-error': 'error', // 禁止使用 @ts-ignore
    '@typescript-eslint/no-explicit-any': 'off', // 禁止使用 any 类型
    '@typescript-eslint/no-non-null-assertion': 'off',
    '@typescript-eslint/no-namespace': 'off', // 禁止使用自定义 TypeScript 模块和命名空间。
    '@typescript-eslint/semi': 'off',

    // eslint-plugin-vue (https://eslint.vuejs.org/rules/)
    'vue/multi-word-component-names': 'off', // 要求组件名称始终为 “-” 链接的单词
    'vue/script-setup-uses-vars': 'error', // 防止<script setup>使用的变量<template>被标记为未使用
    'vue/no-mutating-props': 'off', // 不允许组件 prop的改变
    'vue/attribute-hyphenation': 'off', // 对模板中的自定义组件强制执行属性命名样式
  },
}

 .eslintignore忽略文件

dist
node_modules

运行脚本

package.json新增两个运行脚本

"scripts": {
    "lint": "eslint src",
    "fix": "eslint src --fix",
}
<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或者插件如vue、react。引用[3]和[4]提到在React和Vue项目中的最佳实践,所以需要分别说明如何配置这些框架的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 ``` 根据提示选择配置风格(如 JavaScript、React、Vue 等)[^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
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值