ESLint 配置

时间  2019-11-10
标签 eslint 配置 繁體版
原文   原文链接

ESLint 配置

ESlint 被设计为彻底可配置的，这意味着你能够关闭每个规则而只运行基本语法验证，或混合和匹配 ESLint 默认绑定的规则和你的自定义规则，以让 ESLint 更适合你的项目。有两种主要的方式来配置 ESLint：javascript

  1. Configuration Comments - 使用 JavaScript 注释把配置信息直接嵌入到一个代码源文件中。
  2. Configuration Files - 使用 JavaScript、JSON 或者 YAML 文件为整个目录和它的子目录指定配置信息。能够配置一个独立的 .eslintrc.* 文件，或者直接在 package.json 文件里的 eslintConfig 字段指定配置，ESLint 会查找和自动读取它们，再者，你能够在命令行运行时指定一个任意的配置文件。

有不少信息能够配置：php

  • Environments - 指定脚本的运行环境。每种环境都会有一组特定的预约义全局变量。
  • Globals - 脚本在执行期间访问的额外的全局变量。
  • Rules - 启用的规则及其各自的错误级别。

全部这些选项让你能够细粒度地控制 ESLint 如何对待你的代码。css

指定解析器选项

ESLint 容许你指定你想要支持的 JavaScript 语言选项。默认状况下，ESLint 支持 ECMAScript 5 语法。你能够覆盖该设置，以启用对 ECMAScript 其它版本和 JSX 的支持。java

请注意，对 JSX 语法的支持不用于对 React 的支持。React 使用了一些特定的 ESLint 没法识别的 JSX 语法。若是你正在使用 React 而且想要 React 语义支持，咱们推荐你使用 eslint-plugin-react。node

一样的，支持 ES6 语法并不意味着同时支持新的 ES6 全局变量或类型（好比 Set 等新类型）。使用 { "parserOptions": { "ecmaVersion": 6 } } 来启用 ES6 语法支持；要额外支持新的 ES6 全局变量，使用 { "env":{ "es6": true } }(这个设置会同时自动启用 ES6 语法支持)。react

解析器选项能够在 .eslintrc.* 文件使用 parserOptions 属性设置。可用的选项有：jquery

  • ecmaVersion - 默认设置为 5， 你可使用 三、五、六、7 或 8 来指定你想要使用的 ECMAScript 版本。你也能够用使用年份命名的版本号指定为 2015（同 6），2016（同 7），或 2017（同 8）
  • sourceType - 设置为 "script" (默认) 或 "module"（若是你的代码是 ECMAScript 模块)。
  • ecmaFeatures - 这是个对象，表示你想使用的额外的语言特性:globalReturn - 容许在全局做用域下使用 return 语句impliedStrict - 启用全局 strict mode (若是 ecmaVersion 是 5 或更高)jsx - 启用 JSXexperimentalObjectRestSpread - 启用实验性的 object rest/spread properties 支持。(重要：这是一个实验性的功能,在将来可能会有明显改变。 建议你写的规则 不要 依赖该功能，除非当它发生改变时你愿意承担维护成本。)

.eslintrc.json 文件示例：git

{
    "parserOptions": { "ecmaVersion": 6, "sourceType": "module", "ecmaFeatures": { "jsx": true } }, "rules": { "semi": 2 } }

设置解析器选项能帮助 ESLint 肯定什么是解析错误，全部语言选项默认都是 false。es6

指定解析器

ESLint 默认使用Espree做为其解析器，你能够在配置文件中指定一个不一样的解析器，只要该解析器符合下列要求：github

  1. 它必须是本地安装的一个 npm 模块。
  2. 它必须有兼容 Esprima 的接口（它必须输出一个 parse() 方法）
  3. 它必须产出兼容 Esprima 的 AST 和 token 对象。

注意，即便知足这些兼容性要求，也不能保证一个外部解析器能够与 ESLint 正常配合工做，ESLint 也不会修复与其它解析器不兼容的相关 bug。

为了代表使用该 npm 模块做为你的解析器，你须要在你的 .eslintrc 文件里指定 parser 选项。例如，下面的配置指定了 Esprima 做为解析器：

{
    "parser": "esprima", "rules": { "semi": "error" } }

如下解析器与 ESLint 兼容：

  • Esprima
  • Babel-ESLint - 一个对Babel解析器的包装，使其可以与 ESLint 兼容。
  • typescript-eslint-parser(实验) - 一个把 TypeScript 转换为 ESTree 兼容格式的解析器，这样它就能够在 ESLint 中使用了。这样作的目的是经过 ESLint 来解析 TypeScript 文件（尽管不必定必须经过全部的 ESLint 规则）。

注意，在使用自定义解析器时，为了让 ESLint 在处理非 ECMAScript 5 特性时正常工做，配置属性 parserOptions 仍然是必须的。解析器会被传入 parserOptions，可是不必定会使用它们来决定功能特性的开关。

指定环境

一个“环境”定义了一组预约义的全局变量。可用的环境包括：

  • browser - 浏览器环境中的全局变量。
  • node - Node.js 全局变量和 Node.js 做用域。
  • commonjs - CommonJS 全局变量和 CommonJS 做用域 (通常用于 Browserify/WebPack 打包的只在浏览器中运行的代码)。
  • shared-node-browser - Node 和 Browser 通用全局变量。
  • es6 - 启用除了 modules 之外的全部 ECMAScript 6 特性（该选项会自动设置 ecmaVersion 解析器选项为 6）。
  • worker - Web Workers 全局变量。
  • amd - 将 require() 和 define() 定义为像 amd 同样的全局变量。
  • mocha - 添加全部的 Mocha 测试全局变量。
  • jasmine - 添加全部的 Jasmine 版本 1.3 和 2.0 的测试全局变量。
  • jest - Jest 全局变量。
  • phantomjs - PhantomJS 全局变量。
  • protractor - Protractor 全局变量。
  • qunit - QUnit 全局变量。
  • jquery - jQuery 全局变量。
  • prototypejs - Prototype.js 全局变量。
  • shelljs - ShellJS 全局变量。
  • meteor - Meteor 全局变量。
  • mongo - MongoDB 全局变量。
  • applescript - AppleScript 全局变量。
  • nashorn - Java 8 Nashorn 全局变量。
  • serviceworker - Service Worker 全局变量。
  • atomtest - Atom 测试全局变量。
  • embertest - Ember 测试全局变量。
  • webextensions - WebExtensions 全局变量。
  • greasemonkey - GreaseMonkey 全局变量。

这些环境并非互斥的，因此你能够同时定义多个。

能够在源文件里、在配置文件中或使用 命令行 的 --env 选项来指定环境。

要在你的 JavaScript 文件中使用注释来指定环境，格式以下：

/* eslint-env node, mocha */

该设置启用了 Node.js 和 Mocha 环境。

要在配置文件里指定环境，使用 env 关键字指定你想启用的环境，并设置它们为 true。例如，如下示例启用了 browser 和 Node.js 的环境：

{
    "env": { "browser": true, "node": true } }

或在 package.json 文件中：

{
    "name": "mypackage", "version": "0.0.1", "eslintConfig": { "env": { "browser": true, "node": true } } }

在 YAML 文件中：

---
  env:
    browser: true node: true

若是你想在一个特定的插件中使用一种环境，确保提早在 plugins 数组里指定了插件名，而后在 env 配置中不带前缀的插件名后跟一个 / ，紧随着环境名。例如：

{
    "plugins": ["example"], "env": { "example/custom": true } }

或在 package.json 文件中

{
    "name": "mypackage", "version": "0.0.1", "eslintConfig": { "plugins": ["example"], "env": { "example/custom": true } } }

在 YAML 文件中：

---
  plugins:
    - example
  env:
    example/custom: true

指定全局变量

当访问当前源文件内未定义的变量时，no-undef 规则将发出警告。若是你想在一个源文件里使用全局变量，推荐你在 ESLint 中定义这些全局变量，这样 ESLint 就不会发出警告了。你可使用注释或在配置文件中定义全局变量。

要在你的 JavaScript 文件中，用注释指定全局变量，格式以下：

/* global var1, var2 */

这里定义了两个全局变量：var1 和 var2。若是你想指定这些变量不该被重写（只读），你能够将它们设置为 false：

/* global var1:false, var2:false */

在配置文件里配置全局变量时，使用 globals 指出你要使用的全局变量。将变量设置为 true 将容许变量被重写，或 false 将不容许被重写。好比：

{
    "globals": { "var1": true, "var2": false } }

在 YAML 中：

---
  globals:
    var1: true var2: false

在这些例子中 var1 容许被重写，var2 不容许被重写。

注意： 要启用no-global-assign规则来禁止对只读的全局变量进行修改。

配置插件

ESLint 支持使用第三方插件。在使用插件以前，你必须使用 npm 安装它。

在配置文件里配置插件时，可使用 plugins 关键字来存放插件名字的列表。插件名称能够省略 eslint-plugin- 前缀。

{
    "plugins": [ "plugin1", "eslint-plugin-plugin2" ] }

在 YAML 中：

---
  plugins:
    - plugin1
    - eslint-plugin-plugin2

注意：全局安装的 ESLint 只能使用全局安装的插件。本地安装的 ESLint 不只可使用本地安装的插件，也可使用全局安装的插件。

配置规则

ESLint 附带有大量的规则。你可使用注释或配置文件修改你项目中要使用的规则。要改变一个规则设置，你必须将规则 ID 设置为下列值之一：

  • "off" 或 0 - 关闭规则
  • "warn" 或 1 - 开启规则，使用警告级别的错误：warn (不会致使程序退出)
  • "error" 或 2 - 开启规则，使用错误级别的错误：error (当被触发的时候，程序会退出)

为了在文件注释里配置规则，使用如下格式的注释：

/* eslint eqeqeq: "off", curly: "error" */

在这个例子里，eqeqeq 规则被关闭，curly 规则被打开，定义为错误级别。你也可使用对应的数字定义规则严重程度：

/* eslint eqeqeq: 0, curly: 2 */

这个例子和上个例子是同样的，只不过它是用的数字而不是字符串。eqeqeq 规则是关闭的，curly 规则被设置为错误级别。

若是一个规则有额外的选项，你可使用数组字面量指定它们，好比：

/* eslint quotes: ["error", "double"], curly: 2 */

这条注释为规则 quotes 指定了 “double”选项。数组的第一项老是规则的严重程度（数字或字符串）。

还可使用 rules 连同错误级别和任何你想使用的选项，在配置文件中进行规则配置。例如：

{
    "rules": { "eqeqeq": "off", "curly": "error", "quotes": ["error", "double"] } }

在 YAML 中：

---
rules:
  eqeqeq: off
  curly: error
  quotes:
    - error
    - double

配置定义在插件中的一个规则的时候，你必须使用 插件名/规则ID 的形式。好比：

{
    "plugins": [ "plugin1" ], "rules": { "eqeqeq": "off", "curly": "error", "quotes": ["error", "double"], "plugin1/rule1": "error" } }

在 YAML 中：

---
plugins:
  - plugin1
rules:
  eqeqeq: 0
  curly: error
  quotes:
    - error
    - "double" plugin1/rule1: error

在这些配置文件中，规则 plugin1/rule1 表示来自插件 plugin1 的 rule1 规则。你也可使用这种格式的注释配置，好比：

/* eslint "plugin1/rule1": "error" */

注意：当指定来自插件的规则时，确保删除 eslint-plugin- 前缀。ESLint 在内部只使用没有前缀的名称去定位规则。

使用行注释禁用规则

能够在你的文件中使用如下格式的块注释来临时禁止规则出现警告：

/* eslint-disable */ alert('foo'); /* eslint-enable */

你也能够对指定的规则启用或禁用警告:

/* eslint-disable no-alert, no-console */ alert('foo'); console.log('bar'); /* eslint-enable no-alert, no-console */

若是在整个文件范围内禁止规则出现警告，将 /* eslint-disable */ 块注释放在文件顶部：

/* eslint-disable */ alert('foo');

你也能够对整个文件启用或禁用警告:

/* eslint-disable no-alert */ // Disables no-alert for the rest of the file alert('foo');

能够在你的文件中使用如下格式的行注释在某一特定的行上禁用全部规则：

alert('foo'); // eslint-disable-line // eslint-disable-next-line alert('foo');

在某一特定的行上禁用某个指定的规则：

alert('foo'); // eslint-disable-line no-alert // eslint-disable-next-line no-alert alert('foo');

在某个特定的行上禁用多个规则：

alert('foo'); // eslint-disable-line no-alert, quotes, semi // eslint-disable-next-line no-alert, quotes, semi alert('foo');

上面的全部方法一样适用于插件规则。例如，禁止 eslint-plugin-example 的 rule-name 规则，把插件名（example）和规则名（rule-name）结合为 example/rule-name：

foo(); // eslint-disable-line example/rule-name

注意：为文件的某部分禁用警告的注释，告诉 ESLint 不要对禁用的代码报告规则的冲突。ESLint 仍解析整个文件，然而，禁用的代码仍须要是有效的 JavaScript 语法。

添加分享配置

ESLint 支持在配置文件添加共享设置。你能够添加 settings 对象到配置文件，它将提供给每个将被执行的规则。若是你想添加的自定义规则并且使它们能够访问到相同的信息，这将会颇有用，而且很容易配置。

在 JSON 中：

{
    "settings": { "sharedData": "Hello" } }

在 YAML 中：

---
  settings:
    sharedData: "Hello"

使用配置文件

有两种方式可使用配置文件。第一种是将文件保存到你喜欢的地方，而后将它的位置使用 -c 选项传递命令行，好比：

eslint -c myconfig.json myfiletotest.js

第二种方式是经过 .eslintrc.* 和 package.json。ESLint 将自动在要检测的文件目录里寻找它们，紧接着是父级目录，一直到文件系统的根目录。当你想对一个项目的不一样部分的使用不一样配置，或当你但愿别人可以直接使用 ESLint，而无需记住要在配置文件中传递什么，这种方式就颇有用。

每种状况，配置文件都会覆盖默认设置。

配置文件文件格式

ESLint 支持几种格式的配置文件：

  • JavaScript - 使用 .eslintrc.js 而后输出一个配置对象。
  • YAML - 使用 .eslintrc.yaml 或 .eslintrc.yml 去定义配置的结构。
  • JSON - 使用 .eslintrc.json 去定义配置的结构，ESLint 的 JSON 文件容许 JavaScript 风格的注释。
  • (不推荐) - 使用 .eslintrc，可使 JSON 也能够是 YAML。
  • package.json - 在 package.json 里建立一个 eslintConfig属性，在那里定义你的配置。

若是同一个目录下有多个配置文件，ESLint 只会使用一个。优先级顺序以下：

  1. .eslintrc.js
  2. .eslintrc.yaml
  3. .eslintrc.yml
  4. .eslintrc.json
  5. .eslintrc
  6. package.json

配置的层级和继承

当使用 .eslintrc.* 和 package.json文件的配置时，你能够利用层叠配置。例如，假如你有如下结构：

your-project ├── .eslintrc ├── lib │ └── source.js └─┬ tests ├── .eslintrc └── test.js

层叠配置使用离要检测的文件最近的 .eslintrc文件做为最高优先级，而后才是父目录里的配置文件，等等。当你在这个项目中容许 ESLint 时，lib/下面的全部文件将使用项目根目录里的 .eslintrc 文件做为它的配置文件。当 ESLint 遍历到 test/ 目录，your-project/.eslintrc 以外，它还会用到 your-project/tests/.eslintrc。因此 your-project/tests/test.js 是基于它的目录层次结构中的两个.eslintrc 文件的组合，而且离的最近的一个优先。经过这种方式，你能够有项目级 ESLint 设置，也有覆盖特定目录的 ESLint 设置。

一样的，若是在根目录的 package.json 文件中有一个 eslintConfig 字段，其中的配置将使用于全部子目录，可是当 tests 目录下的 .eslintrc 文件中的规则与之发生冲突时，就会覆盖它。

your-project ├── package.json ├── lib │ └── source.js └─┬ tests ├── .eslintrc └── test.js

若是同一目录下 .eslintrc 和 package.json 同时存在，.eslintrc 优先级高会被使用，package.json 文件将不会被使用。

注意：若是在你的主目录下有一个自定义的配置文件 (~/.eslintrc) ，若是没有其它配置文件时它才会被使用。由于我的配置将适用于用户目录下的全部目录和文件，包括第三方的代码，当 ESLint 运行时可能会致使问题。

默认状况下，ESLint 会在全部父级目录里寻找配置文件，一直到根目录。若是你想要你全部项目都遵循一个特定的约定时，这将会颇有用，但有时候会致使意想不到的结果。为了将 ESLint 限制到一个特定的项目，在你项目根目录下的 package.json 文件或者 .eslintrc.* 文件里的 eslintConfig 字段下设置 "root": true。ESLint 一旦发现配置文件中有 "root": true，它就会中止在父级目录中寻找。

{
    "root": true }

在 YAML 中：

---
  root: true

例如，projectA 的 lib/ 目录下的 .eslintrc 文件中设置了 "root": true。这种状况下，当检测 main.js 时，lib/ 下的配置将会被使用，projectA/ 下的 .eslintrc 将不会被使用。

home
└── user
    ├── .eslintrc <- Always skipped if other configs present └── projectA ├── .eslintrc <- Not used └── lib ├── .eslintrc <- { "root": true } └── main.js

完整的配置层次结构，从最高优先级最低的优先级，以下:

  1. 行内配置
    1. /*eslint-disable*/ 和 /*eslint-enable*/
    2. /*global*/
    3. /*eslint*/
    4. /*eslint-env*/
  2. 命令行选项：
    1. --global
    2. --rule
    3. --env
    4. -c、--config
  3. 项目级配置：
    1. 与要检测的文件在同一目录下的 .eslintrc.* 或 package.json 文件
    2. 继续在父级目录寻找 .eslintrc 或 package.json文件，直到根目录（包括根目录）或直到发现一个有"root": true的配置。
    3. 若是不是（1）到（3）中的任何一种状况，退回到 ~/.eslintrc 中自定义的默认配置。

扩展配置文件

一个配置文件能够被基础配置中的已启用的规则继承。

extends 属性值能够是：

  • 在配置中指定的一个字符串
  • 字符串数组：每一个配置继承它前面的配置

ESLint 递归地进行扩展配置，因此一个基础的配置也能够有一个 extends 属性。

rules 属性能够作下面的任何事情以扩展（或覆盖）规则：

  • 启用额外的规则
  • 改变继承的规则级别而不改变它的选项：
    • 基础配置："eqeqeq": ["error", "allow-null"]
    • 派生的配置："eqeqeq": "warn"
    • 最后生成的配置："eqeqeq": ["warn", "allow-null"]
  • 覆盖基础配置中的规则的选项
    • 基础配置："quotes": ["error", "single", "avoid-escape"]
    • 派生的配置："quotes": ["error", "single"]
    • 最后生成的配置："quotes": ["error", "single"]

使用 eslint:recommended

值为 "eslint:recommended" 的 extends 属性启用一系列核心规则，这些规则报告一些常见问题，在 规则页面 中被标记为 。这个推荐的子集只能在 ESLint 主要版本进行更新。

若是你的配置集成了推荐的规则：在你升级到 ESLint 新的主版本以后，在你使用命令行的 --fix 选项以前，检查一下报告的问题，这样你就知道一个新的可修复的推荐的规则将更改代码。

eslint --init 命令能够建立一个配置，这样你就能够继承推荐的规则。

JavaScript 格式的一个配置文件的例子：

module.exports = { "extends": "eslint:recommended", "rules": { // enable additional rules "indent": ["error", 4], "linebreak-style": ["error", "unix"], "quotes": ["error", "double"], "semi": ["error", "always"], // override default options for rules from base configurations "comma-dangle": ["error", "always"], "no-cond-assign": ["error", "always"], // disable rules from base configurations "no-console": "off", } }

使用可共享的配置包

可共享的配置 是一个 npm 包，它输出一个配置对象。要确保这个包安装在 ESLint 能请求到的目录下。

extends 属性值能够省略包名的前缀 eslint-config-。

eslint --init 命令能够建立一个配置，这样你就能够扩展一个流行的风格指南（好比，eslint-config-standard）。

YAML 格式的一个配置文件的例子：

extends: standard
rules:
  comma-dangle:
    - error
    - always
  no-empty: warn

使用插件中的配置

插件 是一个 npm 包，一般输出规则。一些插件也能够输出一个或多个命名的 配置。要确保这个包安装在 ESLint 能请求到的目录下。

plugins 属性值 能够省略包名的前缀 eslint-plugin-。

extends 属性值能够由如下组成：

  • plugin:
  • 包名 (省略了前缀，好比，react)
  • /
  • 配置名称 (好比 recommended)

JSON 格式的一个配置文件的例子：

{
    "plugins": [ "react" ], "extends": [ "eslint:recommended", "plugin:react/recommended" ], "rules": { "no-set-state": "off" } }

使用一个配置文件

extends 属性值能够是基本配置文件的绝对路径或相对路径。

ESLint 解析基本配置文件的相对路径相对你你使用的配置文件，除非那个文件在你的主目录或非 ESLint 安装目录的父级目录。在这些状况下，ESLint 解析基本配合文件的相对路径相对于被检测的 项目目录（尤为是当前工做目录）。

JSON 格式的一个配置文件的例子：

{
    "extends": [ "./node_modules/coding-standard/eslintDefaults.js", "./node_modules/coding-standard/.eslintrc-es6", "./node_modules/coding-standard/.eslintrc-jsx" ], "rules": { "eqeqeq": "warn" } }

使用 eslint:all

extends 属性值能够是 "eslint:all"，启用当前安装的 ESLint 中全部的核心规则。这些规则能够在 ESLint 的任何版本进行更改。

重要：这些配置 不推荐在产品中使用，由于它随着 ESLint 版本进行更改。使用的话，请本身承担风险。

若是你配置 ESLint 升级时自动地启用新规则，当源码没有任何改变时，ESLint 能够报告新问题，所以任何 ESLint 的新的小版本好像有破坏性的更改。

当你决定在一个项目上使用的规则和选项，尤为是若是你不多覆盖选项或禁用规则，你可能启用全部核心规则做为一种快捷方式使用。规则的默认选项并非 ESLint 推荐的（例如，quotes 规则的默认选项并不意味着双引号要比单引号好）。

若是你的配置扩展了全部的核心规则：在你升级到一个新的大或小的 ESLint 版本，在你使用命令行的 --fix 选项以前，检查一下报告的问题，这样你就知道一个新的可修复的规则将更改代码。

JavaScript 格式的一个配置文件的例子：

module.exports = { "extends": "eslint:all", "rules": { // override default options "comma-dangle": ["error", "always"], "indent": ["error", 2], "no-cond-assign": ["error", "always"], // disable now, but enable in the future "one-var": "off", // ["error", "never"] // disable "init-declarations": "off", "no-console": "off", "no-inline-comments": "off", } }

基于 glob 模式的配置

有时，你可能须要更精细的配置，好比，若是同一个目录下的文件须要有不一样的配置。所以，你能够在配置中使用 overrides 键，它只适用于匹配特定的 glob 模式的文件，使用你在命令行上传递的格式 (e.g., app/**/*.test.js)。

怎么工做

  • Glob 模式覆盖只能在配置文件 (.eslintrc.* 或 package.json) 中进行配置。
  • 模式应用于相对于配置文件的目录的文件路径。 好比，若是你的配置文件的路径为 /Users/john/workspace/any-project/.eslintrc.js 而你要检测的路径为 /Users/john/workspace/any-project/lib/util.js，那么你在 .eslintrc.js 中提供的模式是相对于 lib/util.js 来执行的.
  • 在相同的配置文件中，Glob 模式覆盖比其余常规配置具备更高的优先级。 同一个配置中的多个覆盖将按顺序被应用。也就是说，配置文件中的最后一个覆盖会有最高优先级。
  • 一个 glob 特定的配置几乎与 ESLint 的其余配置相同。覆盖块能够包含常规配置中的除了 extends、overrides 和 root 以外的其余任何有效配置选项，
  • 能够在单个覆盖块中提供多个 glob 模式。一个文件必须匹配至少一个配置中提供的模式。
  • 覆盖块也能够指定从匹配中排除的模式。若是一个文件匹配了任何一个排除模式，该配置将再也不被应用。

相对 glob 模式

project-root ├── app │ ├── lib │ │ ├── foo.js │ │ ├── fooSpec.js │ ├── components │ │ ├── bar.js │ │ ├── barSpec.js │ ├── .eslintrc.json ├── server │ ├── server.js │ ├── serverSpec.js ├── .eslintrc.json

app/.eslintrc.json 文件中的配置定义了 glob 模式 **/*Spec.js。该模式是相对 app/.eslintrc.json 的基本目录的。所以，该模式将匹配 app/lib/fooSpec.js 和 app/components/barSpec.js 但 不匹配 server/serverSpec.js。若是你在项目根目录下的 .eslintrc.json 文件中定义了一样的模式，它将匹配这三个 *Spec 文件。

配置示例

在你的 .eslintrc.json 文件中：

{
  "rules": { "quotes": [ 2, "double" ] }, "overrides": [ { "files": [ "bin/*.js", "lib/*.js" ], "excludedFiles": "*.test.js", "rules": { "quotes": [ 2, "single" ] } } ] }

在配置文件中注释

JSON 和 YAML 配置文件格式都支持注释 ( package.json 文件不该该包括注释)。你能够在其余类型的文件中使用 JavaScript 风格的注释或使用 YAML 风格的注释，ESLint 会忽略它们。这容许你的配置更加人性化。例如：

{
    "env": { "browser": true }, "rules": { // Override our default settings just for this directory "eqeqeq": "warn", "strict": "off" } }

指定须要检查的文件扩展名

目前，告诉 ESLint 哪一个文件扩展名要检测的惟一方法是使用 --ext 命令行选项指定一个逗号分隔的扩展名列表。注意，该标记只在与目录一块儿使用时有效，若是使用文件名或 glob 模式，它将会被忽略。

忽略文件和目录

你能够经过在项目根目录建立一个 .eslintignore 文件告诉 ESLint 去忽略特定的文件和目录。.eslintignore 文件是一个纯文本文件，其中的每一行都是一个 glob 模式代表哪些路径应该忽略检测。例如，如下将忽略全部的 JavaScript 文件：

**/*.js

当 ESLint 运行时，在肯定哪些文件要检测以前，它会在当前工做目录中查找一个 .eslintignore 文件。若是发现了这个文件，当遍历目录时，将会应用这些偏好设置。一次只有一个 .eslintignore 文件会被使用，因此，不是当前工做目录下的 .eslintignore 文件将不会被用到。

Globs 匹配使用 node-ignore，因此大量可用的特性有：

  • 以 # 开头的行被看成注释，不影响忽略模式。
  • 路径是相对于 .eslintignore 的位置或当前工做目录。这也会影响经过 --ignore-pattern传递的路径。
  • 忽略模式同 .gitignore 规范
  • 以 ! 开头的行是否认模式，它将会从新包含一个以前被忽略的模式。

除了 .eslintignore 文件中的模式，ESLint老是忽略 /node_modules/* 和 /bower_components/* 中的文件。

例如：把下面 .eslintignore 文件放到当前工做目录里，将忽略 node_modules，bower_components 以及 build/ 目录下除了 build/index.js 的全部文件。

# /node_modules/* and /bower_components/* ignored by default # Ignore built files except build/index.js build/* !build/index.js

使用备用文件

若是相比于当前工做目录下 .eslintignore 文件，你更想使用一个不一样的文件，你能够在命令行使用 --ignore-path 选项指定它。例如，你可使用 .jshintignore 文件，由于它有相同的格式：

eslint --ignore-path .jshintignore file.js

你也可使用你的 .gitignore 文件：

eslint --ignore-path .gitignore file.js

任何文件只要知足标准忽略文件格式均可以用。记住，指定 --ignore-path 意味着任何现有的 .eslintignore 文件将不被使用。请注意，.eslintignore 中的匹配规则比 .gitignore 中的更严格。

在 package.json 中使用 eslintConfig

{
  "name": "mypackage", "version": "0.0.1", "eslintConfig": { "env": { "browser": true, "node": true } }, "eslintIgnore": ["hello.js", "world.js"] }

忽略文件告警

当您将目录传递给 ESLint 时，文件和目录将被忽略。若是将特定文件传递给ESLint，则会看到一条警告，指示该文件已被跳过。例如，假设你有一个 .eslintignore 文件，以下所示：

foo.js

而后，您执行：

eslint foo.js

您将会看到如下告警：

foo.js 0:0 warning File ignored because of your .eslintignore file. Use --no-ignore to override. ✖ 1 problem (0 errors, 1 warning)

发生此消息是由于ESLint不肯定是否要检查该文件。如消息所示，您可使用 --no-ignore 省略使用忽略规则。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程