eslint简单使用
Date: 2017-02-17
开始
eslint是在 ECMAScript/JavaScript 代码中识别和报告模式匹配的工具,它的目标是保证代码的一致性和避免错误。(官方翻译)
两种安装方式
- 全局
适用于所有项目文件
先全局安装ESLint插件
$ npm install -g eslint
初始化配置文件
eslint --init
使用
./node_modules/.bin/eslint file.js --fix
配置文件
- init 初始化配置文件后,项目中会得到一个.eslintrc.js的文件。当然还会有.json YAML等格式的。
module.exports = {
"extends": "airbnb",//拓展规则
"plugins": [//插件
"react",
"jsx-a11y",
"import"
],
"env": {//指定环境
"browser": true,
"node": true
},
"rules": {//规则
"semi": "error"
}
}
- package.json中使用
"name": "mypackage",
"version": "0.0.1",
"eslintConfig": {
"plugins": ["react"],
"env": {
"browser": true
}
}
Rules
- “off” 或 0 - 关闭规则
- “warn” 或 1 - 开启规则,使用警告级别的错误:warn (不会导致程序退出)
- “error” 或 2 - 开启规则,使用错误级别的错误:error (当被触发的时候,程序会退出)
如果采用了拓展规则,比如说airbnb,会有默认的,再node_module中都有rules,那配置文件就不用再多写了。但是我们可以写一些,覆盖拓展里的,以达到关闭某些规则的作用。
例如
这些规则都可以google一下
"rules": {
"react/jsx-filename-extension": [1, { "extensions": [".js", ".jsx"] }],
"react/forbid-prop-types": 0,
"react/no-array-index-key": 0,
"react/jsx-wrap-multilines": 0,
"react/prop-types": 1,
"jsx-a11y/no-static-element-interactions": 0,
"no-underscore-dangle": 0,
"no-script-url": 0,
"class-methods-use-this": 0,
"no-constant-condition": 0,
"max-len": 0,
"no-nested-ternary": 0,
"semi": 1,
"space-before-function-paren": 1
}
.eslintignore
可以在项目根目录创建,告诉ESLint忽略某些文件或者目录。相当于.gitignore都是纯文本文件。
例如
# 注释,忽略文件
node_modules
**/.js
build
配合webpack的使用
安装一个eslint-loader 的loader
module:{
preLoaders: [
{test: /\.js$/, loader: "eslint-loader", exclude: /node_modules/}
],
loaders:[
{
test:/\.jsx?$/,
exclude:/node_modules/,
loader:'babel'
},
{
test:/\.css$/,
loaders:['style','css'],
include:'/dist'
}]
}
结合pre-commit使用
有时候可能我们的项目后入eslint,之前的文件太多,改不过来,但是却要慢慢加入。可以加一个git的hooks。
- 项目本地安装
npm install --save-dev pre-commit
- package.json配置
例如
{
"script": {
"lint": "git diff-tree --no-commit-id --name-only -r $REVISION | xargs pre-commit run --files."
},
"pre-commit": [
"lint"
],
}
git钩子(可自定义)
钩子都被存储在Git目录下的hooks目录中
cd .git/hooks && ls
这些钩子的功能主要分为提交工作流钩子、电子邮件工作流钩子和其它钩子。比如提交代码之前检查,提交给同组开发人员发邮件等等。
当然eslint也可以结合gulp,以及在编译器中使用。这些从网上都可以查到。比如我现在atom用到的就直接下载bao包了
apm install linter-eslint