ESLint 的使用和.eslintrc.js配置

在团队协作中,为避免低级 Bug、产出风格统一的代码,会预先制定编码规范。使用 Lint 工具和代码风格检测工具,则可以辅助编码规范执行,有效控制代码质量。

ESLint 简介

ESLint 由 JavaScript 红宝书 作者 Nicholas C. Zakas 编写, 2013 年发布第一个版本。 NCZ 的初衷不是重复造一个轮子,而是在实际需求得不到 JSHint 团队响应 的情况下做出的选择:以可扩展、每条规则独立、不内置编码风格为理念编写一个 lint 工具。

ESLint 主要有以下特点:

  • 默认规则包含所有 JSLint、JSHint 中存在的规则,易迁移;
  • 规则可配置性高:可设置「警告」、「错误」两个 error 等级,或者直接禁用;
  • 包含代码风格检测的规则
  • 支持插件扩展、自定义规则

使用 ESLint

ESLint 详尽使用参见 官方文档 http://eslint.org/docs/user-guide/configuring

配置 ESLint

可以通过以下三种方式配置 ESLint:

  • 使用 .eslintrc 文件(支持 JSON 和 YAML 两种语法);
  • 在 package.json 中添加 eslintConfig 配置块;
  • 直接在代码文件中定义。

.eslintrc 文件示例:

{
  "env": {
    "browser": true,
  },
  "globals": {
    "angular": true,
  },
  "rules": {
    "camelcase": 2,
    "curly": 2,
    "brace-style": [2, "1tbs"],
    "quotes": [2, "single"],
    "semi": [2, "always"],
    "space-in-brackets": [2, "never"],
    "space-infix-ops": 2,
  }
}

.eslintrc 放在项目根目录,则会应用到整个项目;如果子目录中也包含 .eslintrc 文件,则子目录会忽略根目录的配置文件,应用该目录中的配置文件。这样可以方便地对不同环境的代码应用不同的规则。

package.json 示例:

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

文件内配置

代码文件内配置的规则会覆盖配置文件里的规则。

.eslintrc 文件示例和解释:

  {  
    "env": {  
      "browser": true,  
      "node": true,  
      "commonjs": true  
    },  
    "ecmaFeatures": {  
      // lambda表达式  
      "arrowFunctions": true,  
      // 解构赋值  
      "destructuring": true,  
      // class  
      "classes": true,  
      // http://es6.ruanyifeng.com/#docs/function#函数参数的默认值  
      "defaultParams": true,  
      // 块级作用域,允许使用let const  
      "blockBindings": true,  
      // 允许使用模块,模块内默认严格模式  
      "modules": true,  
      // 允许字面量定义对象时,用表达式做属性名  
      // http://es6.ruanyifeng.com/#docs/object#属性名表达式  
      "objectLiteralComputedProperties": true,  
      // 允许对象字面量方法名简写  
      /*var o = {
          method() {
            return "Hello!";
          }
       };

       等同于

       var o = {
         method: function() {
           return "Hello!";
         }
       };
      */  
      "objectLiteralShorthandMethods": true,  
      /*
        对象字面量属性名简写
        var foo = 'bar';
        var baz = {foo};
        baz // {foo: "bar"}

        // 等同于
        var baz = {foo: foo};
      */  
      "objectLiteralShorthandProperties": true,  
      // http://es6.ruanyifeng.com/#docs/function#rest参数  
      "restParams": true,  
      // http://es6.ruanyifeng.com/#docs/function#扩展运算符  
      "spread": true,  
      // http://es6.ruanyifeng.com/#docs/iterator#for---of循环  
      "forOf": true,  
      // http://es6.ruanyifeng.com/#docs/generator  
      "generators": true,  
      // http://es6.ruanyifeng.com/#docs/string#模板字符串  
      "templateStrings": true,  
      "superInFunctions": true,  
      // http://es6.ruanyifeng.com/#docs/object#对象的扩展运算符  
      "experimentalObjectRestSpread": true  
    },  

    "rules": {  
      // 定义对象的set存取器属性时,强制定义get  
      "accessor-pairs": 2,  
      // 指定数组的元素之间要以空格隔开(,后面), never参数:[ 之前和 ] 之后不能带空格,always参数:[ 之前和 ] 之后必须带空格  
      "array-bracket-spacing": [2, "never"],  
      // 在块级作用域外访问块内定义的变量是否报错提示  
      "block-scoped-var": 0,  
      // if while function 后面的{必须与if在同一行,java风格。  
      "brace-style": [2, "1tbs", { "allowSingleLine": true }],  
      // 双峰驼命名格式  
      "camelcase": 2,  
      // 数组和对象键值对最后一个逗号, never参数:不能带末尾的逗号, always参数:必须带末尾的逗号,  
      // always-multiline:多行模式必须带逗号,单行模式不能带逗号  
      "comma-dangle": [2, "never"],  
      // 控制逗号前后的空格  
      "comma-spacing": [2, { "before": false, "after": true }],  
      // 控制逗号在行尾出现还是在行首出现  
      // http://eslint.org/docs/rules/comma-style  
      "comma-style": [2, "last"],  
      // 圈复杂度  
      "complexity": [2,9],  
      // 以方括号取对象属性时,[ 后面和 ] 前面是否需要空格, 可选参数 never, always  
      "computed-property-spacing": [2,"never"],  
      // 强制方法必须返回值,TypeScript强类型,不配置  
      "consistent-return": 0,  
      // 用于指统一在回调函数中指向this的变量名,箭头函数中的this已经可以指向外层调用者,应该没卵用了  
      // e.g [0,"that"] 指定只能 var that = this. that不能指向其他任何值,this也不能赋值给that以外的其他值  
      "consistent-this": 0,  
      // 强制在子类构造函数中用super()调用父类构造函数,TypeScrip的编译器也会提示  
      "constructor-super": 0,  
      // if else while for do后面的代码块是否需要{ }包围,参数:  
      //    multi  只有块中有多行语句时才需要{ }包围  
      //    multi-line  只有块中有多行语句时才需要{ }包围, 但是块中的执行语句只有一行时,  
      //                   块中的语句只能跟和if语句在同一行。if (foo) foo++; else doSomething();  
      //    multi-or-nest 只有块中有多行语句时才需要{ }包围, 如果块中的执行语句只有一行,执行语句可以零另起一行也可以跟在if语句后面  
      //    [2, "multi", "consistent"] 保持前后语句的{ }一致  
      //    default: [2, "all"] 全都需要{ }包围  
      "curly": [2, "all"],  
      // switch语句强制default分支,也可添加 // no default 注释取消此次警告  
      "default-case": 2,  
      // 强制object.key 中 . 的位置,参数:  
      //      property,'.'号应与属性在同一行  
      //      object, '.' 号应与对象名在同一行  
      "dot-location": [2, "property"],  
      // 强制使用.号取属性  
      //    参数: allowKeywords:true 使用保留字做属性名时,只能使用.方式取属性  
      //                          false 使用保留字做属性名时, 只能使用[]方式取属性 e.g [2, {"allowKeywords": false}]  
      //           allowPattern:  当属性名匹配提供的正则表达式时,允许使用[]方式取值,否则只能用.号取值 e.g [2, {"allowPattern": "^[a-z]+(_[a-z]+)+$"}]  
      "dot-notation": [2, {"allowKeywords": true}],  
      // 文件末尾强制换行  
      "eol-last": 2,  
      // 使用 === 替代 ==  
      "eqeqeq": [2, "allow-null"],  
      // 方法表达式是否需要命名  
      "func-names": 0,  
      // 方法定义风格,参数:  
      //    declaration: 强制使用方法声明的方式,function f(){} e.g [2, "declaration"]  
      //    expression:强制使用方法表达式的方式,var f = function() {}  e.g [2, "expression"]  
      //    allowArrowFunctions: declaration风格中允许箭头函数。 e.g [2, "declaration", { "allowArrowFunctions": true }]  
      "func-style": 0,  
      "generator-star-spacing": [2, { "before": true, "after": true }],  
      "guard-for-in": 0,  
      "handle-callback-err": [2, "^(err|error)$" ],  
      "indent": [2, 2, { "SwitchCase": 1 }],  
      "key-spacing": [2, { "beforeColon": false, "afterColon": true }],  
      "linebreak-style": 0,  
      "lines-around-comment": 0,  
      "max-nested-callbacks": 0,  
      "new-cap": [2, { "newIsCap": true, "capIsNew": false }],  
      "new-parens": 2,  
      "newline-after-var": 0,  
      "no-alert": 0,  
      "no-array-constructor": 2,  
      "no-caller": 2,  
      "no-catch-shadow": 0,  
      "no-cond-assign": 2,  
      "no-console": 0,  
      "no-constant-condition": 0,  
      "no-continue": 0,  
      "no-control-regex": 2,  
      "no-debugger": 2,  
      "no-delete-var": 2,  
      "no-div-regex": 0,  
      "no-dupe-args": 2,  
      "no-dupe-keys": 2,  
      "no-duplicate-case": 2,  
      "no-else-return": 0,  
      "no-empty": 0,  
      "no-empty-character-class": 2,  
      "no-empty-label": 2,  
      "no-eq-null": 0,  
      "no-eval": 2,  
      "no-ex-assign": 2,  
      "no-extend-native": 2,  
      "no-extra-bind": 2,  
      "no-extra-boolean-cast": 2,  
      "no-extra-parens": 0,  
      "no-extra-semi": 0,  
      "no-fallthrough": 2,  
      "no-floating-decimal": 2,  
      "no-func-assign": 2,  
      "no-implied-eval": 2,  
      "no-inline-comments": 0,  
      "no-inner-declarations": [2, "functions"],  
      "no-invalid-regexp": 2,  
      "no-irregular-whitespace": 2,  
      "no-iterator": 2,  
      "no-label-var": 2,  
      "no-labels": 2,  
      "no-lone-blocks": 2,  
      "no-lonely-if": 0,  
      "no-loop-func": 0,  
      "no-mixed-requires": 0,  
      "no-mixed-spaces-and-tabs": 2,  
      "no-multi-spaces": 2,  
      "no-multi-str": 2,  
      "no-multiple-empty-lines": [2, { "max": 1 }],  
      "no-native-reassign": 2,  
      "no-negated-in-lhs": 2,  
      "no-nested-ternary": 0,  
      "no-new": 2,  
      "no-new-func": 0,  
      "no-new-object": 2,  
      "no-new-require": 2,  
      "no-new-wrappers": 2,  
      "no-obj-calls": 2,  
      "no-octal": 2,  
      "no-octal-escape": 2,  
      "no-param-reassign": 0,  
      "no-path-concat": 0,  
      "no-process-env": 0,  
      "no-process-exit": 0,  
      "no-proto": 0,  
      "no-redeclare": 2,  
      "no-regex-spaces": 2,  
      "no-restricted-modules": 0,  
      "no-return-assign": 2,  
      "no-script-url": 0,  
      "no-self-compare": 2,  
      "no-sequences": 2,  
      "no-shadow": 0,  
      "no-shadow-restricted-names": 2,  
      "no-spaced-func": 2,  
      "no-sparse-arrays": 2,  
      "no-sync": 0,  
      "no-ternary": 0,  
      "no-this-before-super": 2,  
      "no-throw-literal": 2,  
      "no-trailing-spaces": 2,  
      "no-undef": 2,  
      "no-undef-init": 2,  
      "no-undefined": 0,  
      "no-underscore-dangle": 0,  
      "no-unexpected-multiline": 2,  
      "no-unneeded-ternary": 2,  
      "no-unreachable": 2,  
      "no-unused-expressions": 0,  
      "no-unused-vars": [2, { "vars": "all", "args": "none" }],  
      "no-use-before-define": 0,  
      "no-var": 0,  
      "no-void": 0,  
      "no-warning-comments": 0,  
      "no-with": 2,  
      "object-curly-spacing": 0,  
      "object-shorthand": 0,  
      "one-var": [2, { "initialized": "never" }],  
      "operator-assignment": 0,  
      "operator-linebreak": [2, "after", { "overrides": { "?": "before", ":": "before" } }],  
      "padded-blocks": 0,  
      "prefer-const": 0,  
      "quote-props": 0,  
      "quotes": [2, "single", "avoid-escape"],  
      "radix": 2,  
      "semi": [2, "never"],  
      "semi-spacing": 0,  
      "sort-vars": 0,  
      "space-after-keywords": [2, "always"],  
      "space-before-blocks": [2, "always"],  
      "space-before-function-paren": [2, "always"],  
      "space-in-parens": [2, "never"],  
      "space-infix-ops": 2,  
      "space-return-throw-case": 2,  
      "space-unary-ops": [2, { "words": true, "nonwords": false }],  
      "spaced-comment": [2, "always", { "markers": ["global", "globals", "eslint", "eslint-disable", "*package", "!"] }],  
      "strict": 0,  
      "use-isnan": 2,  
      "valid-jsdoc": 0,  
      "valid-typeof": 2,  
      "vars-on-top": 0,  
      "wrap-iife": [2, "any"],  
      "wrap-regex": 0,  
      "yoda": [2, "never"]  
    }  
  }
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,937评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,503评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,712评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,668评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,677评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,601评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,975评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,637评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,881评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,621评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,710评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,387评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,971评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,947评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,189评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,805评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,449评论 2 342

推荐阅读更多精彩内容

  • ESLint 配置 ESlint 被设计为完全可配置的,这意味着你可以关闭每一个规则而只运行基本语法验证,或混合和...
    静默虚空阅读 41,236评论 3 14
  • 两个月之前在项目中就开始使用 Eslint ,当时直接 copy 别人的 .eslintrc.js 文件,感觉好复...
    dkvirus阅读 111,875评论 33 190
  • EsLint入门学习整理 这两天因为公司要求,就对ESLint进行了初步的了解,网上的内容基本上都差不多,但是内容...
    点柈阅读 26,007评论 3 42
  • ESLint 配置 中文官网 简介 ESLint 是在 ECMAScript/JavaScript 代码中识别和报...
    zcynine阅读 1,741评论 0 1
  • 通常在我们定义静态方法,返回实例对象时,将返回值类型定义成instancetype,除了instancetype修...
    ShenYj阅读 307评论 0 1