webstorm引⽤ESLint进⾏静态代码检查
安装
ESLint 基于 Node 平台,所以 Nodejs 是必须安装的,然后通过 npm 安装 ESLint 包,⾄于全局安装还是作为开发依赖安装,取决于个⼈。
然后在 WebStorm 中,打开设置(File>Setting或者Alt+F7),按路径进⼊ ESLint 的配置界⾯(Languages&Frameworks>JavaScript>Code Quality Tools>ESLint)。开启 ESLint,并配置相应路径,配置⽂件默认使⽤.eslintrc。
配置
ESLint 的配置分为六⼤块,分别是:
1. (解析器选项)。涉及语⾔版本等参数。ESLin t默认只⽀持 ES5,如果需要⽀持 ES6,需要在这配置。
2. (解析器选择)。可以让你⾃⼰选择ESLint的解析器。ESLint 默认使⽤作为作为解析器,强烈不推荐修改
3. (语⾔环境选项)。⽐如borwser,node,jquery,meteor等等
4. (全局变量)。⽐如你⾃⼰写了插件,需要全局使⽤,需要在这个选项中声明。
5. (第三⽅插件)。引⼊的第三⽅插件,为了防⽌误杀,需要在这个选项中申明(但限于 npm 插件,如果是 jquery 插件等前端插件,建议在Globals选择中声明)。
6. (语法规则)。这个是 ESLint 的重点,同时也是整个配置中最丰富的地⽅,⽐如结尾分号检测,单双引号,严格格式等。
规范代码
JavaScript 的代码检查⼯具有:JSLint,JSHint, JSCS, ESLint,本⽂着重介绍 ESLint。
ESLint 在⼀系列的代码质量检查⼯具中,是最年轻的⼀个,当然也是最现代化的。配置多样,⽀持 JavaScript, JSON 以及 YAML 格式的 .eslintrc.*⽂件,同时也⽀持
在package.json⽤eslintConfig字段配置()。
安装
ESLint 基于 Node 平台,所以 Nodejs 是必须安装的,然后通过 npm 安装 ESLint 包,⾄于全局安装还是作为开发依赖安装,取决于个⼈。
然后在 WebStorm 中,打开设置(File>Setting或者Alt+F7),按路径进⼊ ESLint 的配置界⾯(Languages&Frameworks>JavaScript>Code Quality Tools>ESLint)。开启 ESLint,并配置相应路径,配置⽂件默认使⽤.eslintrc。
配置
ESLint 的配置分为六⼤块,分别是:
1. (解析器选项)。涉及语⾔版本等参数。ESLin t默认只⽀持 ES5,如果需要⽀持 ES6,需要在这配置。
2. (解析器选择)。可以让你⾃⼰选择ESLint的解析器。ESLint 默认使⽤作为作为解析器,强烈不推荐修改
3. (语⾔环境选项)。⽐如borwser,node,jquery,meteor等等
4. (全局变量)。⽐如你⾃⼰写了插件,需要全局使⽤,需要在这个选项中声明。
5. (第三⽅插件)。引⼊的第三⽅插件,为了防⽌误杀,需要在这个选项中申明(但限于 npm 插件,如果是 jquery 插件等前端插件,建议在Globals选择中声明)。
6. (语法规则)。这个是 ESLint 的重点,同时也是整个配置中最丰富的地⽅,⽐如结尾分号检测,单双引号,严格格式等。
语法规则(Rules)配置
在官⽅⽂档中,语法规则的配置⼜分六⼤类:
1. ,常见错误。
2. ,最佳实践
3. ,严格模式
4. ,变量声明相关,⽐如不允许未定义的变量
5.
6. ,代码样式,⽐如单双引号,单⾏长度,嵌套深度等等
7. ,ES6相关语法,箭头函数,⽣成器等等。
语法规则(Rules)配置
在官⽅⽂档中,语法规则的配置⼜分六⼤类:
1. ,常见错误。
2. ,最佳实践
3. ,严格模式
4. ,变量声明相关,⽐如不允许未定义的变量
5.
6. ,代码样式,⽐如单双引号,单⾏长度,嵌套深度等等
7. ,ES6相关语法,箭头函数,⽣成器等等。
使⽤键值对编写,语⾔规则字段(rule ID)作为键,通过不同的值来影响规则字段。规则字体的值必须是以下三种之⼀:
"off"或者0——不检查这个规则
"warn"或者1——开启这个规则,规则⽣效时,作为提醒告诉⽤户
"error"或者2——开启这个规则,规则⽣效时,作为错误告诉⽤户
⽤以下简短的规则配置做说明:
1 2 3 4 5 6 7{
"rules": {
"quotes": ["2", "single"], "no-undef": [2],
"no-multi-spaces": [1] }
}
这个配置规则对应如下:
要求使⽤单引号,如果不是,显⽰错误信息
如果使⽤了未声明的变量,显⽰错误信息
如果变量与操作符之间出现多个空格,显⽰提醒信息
.eslintignore
如果你有 Git 的使⽤经验,那.eslintignore⽂件的功能也就很容易理解了。类似于.gitignore,⽤于排除⽂件与⽬录,⽐如npm的node_modules⽬录等,以及⼀些第三⽅插件。对于这些⽬录与⽂件,不执⾏代码质量检查。
开始介绍EsLint的详细⽤法
parserOptions
EsLint通过parserOptions,允许指定校验的ecma的版本,及ecma的⼀些特性
{
"parserOptions": {
"ecmaVersion": 6, //指定ECMAScript⽀持的版本,6为ES6
"sourceType": "module", //指定来源的类型,有两种”script”或”module”
"ecmaFeatures": {
"jsx": true//启动JSX
},
}
}
Parser
EsLint默认使⽤esprima做脚本解析,当然你也切换他,⽐如切换成babel-eslint解析
{
"parser": "esprima" //默认,可以设置成babel-eslint,⽀持jsx
}
Environments
Environment可以预设好的其他环境的全局变量,如brower、node环境变量、es6环境变量、mocha环境变量等
{
"env": {
"browser": true,
"node": true
}
}
如果你想使⽤插件中的环境变量,你可以使⽤plugins指定,如下
{
"plugins": ["example"],
"env": {
"example/custom": true
}
}
Globals
指定你所要使⽤的全局变量,true代表允许重写、false代表不允许重写
{
"globals": {
"var1": true,
"var2": false
}
}
Plugins
EsLint允许使⽤第三⽅插件
{
"plugins": [
"react"
]
}
Rules
⾃定义规则,⼀般格式:”规则名称”:error级别系数。系数0为不提⽰(off)、1为警告(warn)、2为错误抛出(error),可指定范围,如[1,4]
可以包括Strict模式、也可以是code的⽅式提醒,如符号等。还可以是第三⽅的校验,如react。
{
"plugins": [
"react"
],
"rules": {
//Javascript code 默认校验
"eqeqeq": "off", //off = 0
"curly": "error", //error = 2
"quotes": ["warn", "double"], //warn = 1
//使⽤第三⽅插件的校验规则
"react/jsx-quotes": 0
}
}
所有引⽤规则均可参考:
参考配置如下:
{
"parserOptions": {
"ecmaVersion": 6,
"sourceType": "module",
"ecmaFeatures": {
"jsx": true
}
},
"env": {
"browser": true,
"node": true,
"commonjs": true,
"meteor": true,
"mongo": true,
"jquery": true,
"amd": true
},
"globals": {},
"rules": {
"no-alert": 0,//禁⽌使⽤alert confirm prompt
"no-array-constructor": 2,//禁⽌使⽤数组构造器
"no-bitwise": 0,//禁⽌使⽤按位运算符
"no-caller": 1,//禁⽌使⽤arguments.caller或arguments.callee
"no-catch-shadow": 2,//禁⽌catch⼦句参数与外部作⽤域变量同名
"no-class-assign": 2,//禁⽌给类赋值
"no-cond-assign": 2,//禁⽌在条件表达式中使⽤赋值语句
"no-console": 2,//禁⽌使⽤console
"no-const-assign": 2,//禁⽌修改const声明的变量
"no-constant-condition": 2,//禁⽌在条件中使⽤常量表达式 if(true) if(1)
"no-continue": 0,//禁⽌使⽤continue
"no-control-regex": 2,//禁⽌在正则表达式中使⽤控制字符
"no-debugger": 2,//禁⽌使⽤debugger
"no-delete-var": 2,//不能对var声明的变量使⽤delete操作符
"no-div-regex": 1,//不能使⽤看起来像除法的正则表达式/=foo/
"no-dupe-keys": 2,//在创建对象字⾯量时不允许键重复 {a:1,a:1}
"no-dupe-args": 2,//函数参数不能重复
"no-duplicate-case": 2,//switch中的case标签不能重复
"no-else-return": 2,//如果if语句⾥⾯有return,后⾯不能跟else语句
"no-empty": 2,//块语句中的内容不能为空
"no-empty-character-class": 2,//正则表达式中的[]内容不能为空
"no-empty-label": 2,//禁⽌使⽤空label
"no-eq-null": 2,//禁⽌对null使⽤==或!=运算符
"no-eval": 1,//禁⽌使⽤eval
"no-ex-assign": 2,//禁⽌给catch语句中的异常参数赋值
"no-extend-native": 2,//禁⽌扩展native对象
"no-extra-bind": 2,//禁⽌不必要的函数绑定
"no-extra-boolean-cast": 2,//禁⽌不必要的bool转换
"no-extra-parens": 2,//禁⽌⾮必要的括号
"no-extra-semi": 2,//禁⽌多余的冒号
"no-fallthrough": 1,//禁⽌switch穿透
"no-floating-decimal": 2,//禁⽌省略浮点数中的0 .5 3.
"no-func-assign": 2,//禁⽌重复的函数声明
"no-implicit-coercion": 1,//禁⽌隐式转换
"no-implied-eval": 2,//禁⽌使⽤隐式eval
"no-inline-comments": 0,//禁⽌⾏内备注
"no-inner-declarations": [2, "functions"],//禁⽌在块语句中使⽤声明(变量或函数)
"no-invalid-regexp": 2,//禁⽌⽆效的正则表达式
"no-invalid-this": 2,//禁⽌⽆效的this,只能⽤在构造器,类,对象字⾯量
"no-irregular-whitespace": 2,//不能有不规则的空格
"no-iterator": 2,//禁⽌使⽤__iterator__ 属性
"no-label-var": 2,//label名不能与var声明的变量名相同
"no-labels": 2,//禁⽌标签声明
"no-lone-blocks": 2,//禁⽌不必要的嵌套块
"no-lonely-if": 2,//禁⽌else语句内只有if语句
"no-loop-func": 1,//禁⽌在循环中使⽤函数(如果没有引⽤外部变量不形成闭包就可以)
"no-mixed-requires": [0, false],//声明时不能混⽤声明类型
"no-mixed-spaces-and-tabs": [2, false],//禁⽌混⽤tab和空格
"linebreak-style": [0, "windows"],//换⾏风格
"no-multi-spaces": 1,//不能⽤多余的空格
"no-multi-str": 2,//字符串不能⽤\换⾏
"no-multiple-empty-lines": [1, {"max": 2}],//空⾏最多不能超过2⾏
"no-native-reassign": 2,//不能重写native对象
"no-negated-in-lhs": 2,//in 操作符的左边不能有!
"no-nested-ternary": 0,//禁⽌使⽤嵌套的三⽬运算
"no-new": 1,//禁⽌在使⽤new构造⼀个实例后不赋值
"no-new-func": 1,//禁⽌使⽤new Function
"no-new-object": 2,//禁⽌使⽤new Object()
"no-new-require": 2,//禁⽌使⽤new require
"no-new-wrappers": 2,//禁⽌使⽤new创建包装实例,new String new Boolean new Number
"no-obj-calls": 2,//不能调⽤内置的全局对象,⽐如Math() JSON()
"no-octal": 2,//禁⽌使⽤⼋进制数字
"no-octal-escape": 2,//禁⽌使⽤⼋进制转义序列
"no-param-reassign": 2,//禁⽌给参数重新赋值
"no-path-concat": 0,//node中不能使⽤__dirname或__filename做路径拼接
"no-plusplus": 0,//禁⽌使⽤++,--
"no-process-env": 0,//禁⽌使⽤v
"no-process-exit": 0,//禁⽌使⽤it()
"no-proto": 2,//禁⽌使⽤__proto__属性
"no-redeclare": 2,//禁⽌重复声明变量
"no-regex-spaces": 2,//禁⽌在正则表达式字⾯量中使⽤多个空格 /foo bar/
"no-restricted-modules": 0,//如果禁⽤了指定模块,使⽤就会报错
"no-return-assign": 1,//return 语句中不能有赋值表达式
"no-script-url": 0,//禁⽌使⽤javascript:void(0)
"no-self-compare": 2,//不能⽐较⾃⾝
"no-sequences": 0,//禁⽌使⽤逗号运算符
"no-shadow": 2,//外部作⽤域中的变量不能与它所包含的作⽤域中的变量或参数同名
"no-shadow-restricted-names": 2,//严格模式中规定的限制标识符不能作为声明时的变量名使⽤
"no-spaced-func": 2,//函数调⽤时函数名与()之间不能有空格
"no-sparse-arrays": 2,//禁⽌稀疏数组, [1,,2]
"no-sync": 0,//nodejs 禁⽌同步⽅法
"no-ternary": 0,//禁⽌使⽤三⽬运算符
"no-trailing-spaces": 1,//⼀⾏结束后⾯不要有空格
"no-this-before-super": 0,//在调⽤super()之前不能使⽤this或super
"no-throw-literal": 2,//禁⽌抛出字⾯量错误 throw "error";
"no-undef": 1,//不能有未定义的变量
"no-undef-init": 2,//变量初始化时不能直接给它赋值为undefined
"no-undefined": 2,//不能使⽤undefined
"no-unexpected-multiline": 2,//避免多⾏表达式
"no-underscore-dangle": 1,//标识符不能以_开头或结尾
"no-unneeded-ternary": 2,//禁⽌不必要的嵌套 var isYes = answer === 1 ? true : false;
"no-unreachable": 2,//不能有⽆法执⾏的代码
"no-unused-expressions": 2,//禁⽌⽆⽤的表达式
"no-unused-vars": [2, {"vars": "all", "args": "after-used"}],//不能有声明后未被使⽤的变量或参数
"no-use-before-define": 2,//未定义前不能使⽤
"no-useless-call": 2,//禁⽌不必要的call和apply
"no-void": 2,//禁⽤void操作符
"no-var": 0,//禁⽤var,⽤let和const代替
"no-warning-comments": [1, { "terms": ["todo", "fixme", "xxx"], "location": "start" }],//不能有警告备注 "no-with": 2,//禁⽤with
"array-bracket-spacing": [2, "never"],//是否允许⾮空数组⾥⾯有多余的空格
"arrow-parens": 0,//箭头函数⽤⼩括号括起来
"arrow-spacing": 0,//=>的前/后括号
"accessor-pairs": 0,//在对象中使⽤getter/setter
"block-scoped-var": 0,//块语句中使⽤var
"brace-style": [1, "1tbs"],//⼤括号风格
"callback-return": 1,//避免多次调⽤回调什么的
"camelcase": 2,//强制驼峰法命名
"comma-dangle": [2, "never"],//对象字⾯量项尾不能有逗号
"comma-spacing": 0,//逗号前后的空格
"comma-style": [2, "last"],//逗号风格,换⾏时在⾏⾸还是⾏尾
"complexity": [0, 11],//循环复杂度
"computed-property-spacing": [0, "never"],//是否允许计算后的键名什么的
"consistent-return": 0,//return 后⾯是否允许省略
"consistent-this": [2, "that"],//this别名
"constructor-super": 0,//⾮派⽣类不能调⽤super,派⽣类必须调⽤super
"curly": [2, "all"],//必须使⽤ if(){} 中的{}
"default-case": 2,//switch语句最后必须有default
"dot-location": 0,//对象访问符的位置,换⾏的时候在⾏⾸还是⾏尾
"dot-notation": [0, { "allowKeywords": true }],//避免不必要的⽅括号
"eol-last": 0,//⽂件以单⼀的换⾏符结束
"eqeqeq": 2,//必须使⽤全等
"func-names": 0,//函数表达式必须有名字
"func-style": [0, "declaration"],//函数风格,规定只能使⽤函数声明/函数表达式
"generator-star-spacing": 0,//⽣成器函数*的前后空格
"guard-for-in": 0,//for in循环要⽤if语句过滤
"handle-callback-err": 2,//nodejs 处理错误
"id-length": 0,//变量名长度
"indent": [2, 4],//缩进风格
"init-declarations": 0,//声明时必须赋初值
"key-spacing": [0, { "beforeColon": false, "afterColon": true }],//对象字⾯量中冒号的前后空格 "lines-around-comment": 0,//⾏前/⾏后备注
"max-depth": [0, 4],//嵌套块深度
"max-len": [0, 80, 4],//字符串最⼤长度
"max-nested-callbacks": [0, 2],//回调嵌套深度
"max-params": [0, 3],//函数最多只能有3个参数
"max-statements": [0, 10],//函数内最多有⼏个声明
"new-cap": 2,//函数名⾸⾏⼤写必须使⽤new⽅式调⽤,⾸⾏⼩写必须⽤不带new⽅式调⽤
"new-parens": 2,//new时必须加⼩括号
"newline-after-var": 2,//变量声明后是否需要空⼀⾏
"object-curly-spacing": [0, "never"],//⼤括号内是否允许不必要的空格
"object-shorthand": 0,//强制对象字⾯量缩写语法
"one-var": 1,//连续声明
"operator-assignment": [0, "always"],//赋值运算符 += -=什么的
"operator-linebreak": [2, "after"],//换⾏时运算符在⾏尾还是⾏⾸
"padded-blocks": 0,//块语句内⾏⾸⾏尾是否要空⾏
"prefer-const": 0,//⾸选const
"prefer-spread": 0,//⾸选展开运算
"prefer-reflect": 0,//⾸选Reflect的⽅法
"quotes": [1, "single"],//引号类型 `` "" ''
"quote-props":[2, "always"],//对象字⾯量中的属性名是否强制双引号
"radix": 2,//parseInt必须指定第⼆个参数
"id-match": 0,//命名检测
"require-yield": 0,//⽣成器函数必须有yield
"semi": [2, "always"],//语句强制分号结尾
"semi-spacing": [0, {"before": false, "after": true}],//分号前后空格
"sort-vars": 0,//变量声明时排序
"space-after-keywords": [0, "always"],//关键字后⾯是否要空⼀格
"space-before-blocks": [0, "always"],//不以新⾏开始的块{前⾯要不要有空格
"space-before-function-paren": [0, "always"],//函数定义时括号前⾯要不要有空格
"space-in-parens": [0, "never"],//⼩括号⾥⾯要不要有空格
"space-infix-ops": 0,//中缀操作符周围要不要有空格
"space-return-throw-case": 2,//return throw case后⾯要不要加空格
"space-unary-ops": [0, { "words": true, "nonwords": false }],//⼀元运算符的前/后要不要加空格 "spaced-comment": 0,//注释风格要不要有空格什么的
"strict": 2,//使⽤严格模式
"use-isnan": 2,//禁⽌⽐较时使⽤NaN,只能⽤isNaN()
js assign"valid-jsdoc": 0,//jsdoc规则
"valid-typeof": 2,//必须使⽤合法的typeof的值
"vars-on-top": 2,//var必须放在作⽤域顶部
"wrap-iife": [2, "inside"],//⽴即执⾏函数表达式的⼩括号风格
"wrap-regex": 0,//正则表达式字⾯量⽤⼩括号包起来
"yoda": [2, "never"]//禁⽌尤达条件
}
}
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论