我们知道代码规范的作用,我们也知道工具才能让我们真正遵守代码规范。本文简绍三个工具EditorConfig,Prettier和eslint。前两个工具帮你形成代码风格,另外一个让你提高代码品味。最后提供typescript+eslint+prettier+airbnb+hooks的安装和配置清单。
本文环境:Mac、VSCode
EditorConfig
第一个工具是EditorConfig,文字意译就是编辑器配置,用于跨编辑器保持同一份代码风格。常用于以下场景:假设你vscode空2格,如果粘贴一个新文件是空4格,此时新文件就保持4格,并不会自动改成编辑器默认的2格,editorConfig能帮你做到这一点。
使用editorconfig非常简单,编辑器添加插件和项目根目录添加文件:
// 在对应编辑器添加插件,vscode搜索EditorConfig for VS Code
touch .editorconfig
编辑器在启动项目时就会读取.editorconfig的配置,以下为我个人配置,更多配置参考这里。
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
[*.md]
trim_trailing_whitespace = false
Prettier
第二个工具是Prettier,如果说EditorConfig帮你统一编辑器风格,那Prettier帮你统一项目风格。Prettier拥有更多配置项,且能在发布流程中自动检查,帮助团队统一代码风格。
全局下载Prettier,风格需要稳定,全局有助于多项目保持统一风格;
npm install -g prettier
安装插件Prettier-Code formatter,要做到vscode中保存即使用,需要setting.json的{formatOnSave: true},且配置对应的语言检测机制,如下配置有"[javscript]...",此时js文件保存时即检查。(在任一js文件,按下快捷键 alt+shift+f 格式化代码,setting.json会自动添加如下"[javascript]...",其他语言类推)
{ "editor.formatOnSave": true, "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } // 以下配置为开启prettier-eslint,会导致prettier保存时不起作用 // "prettier.eslintIntegration": true }
如果根目录含有.prettierrc,该目录的配置会覆盖内置配置;想要使用cli触发prettier,比如在项目提交的时候,或者是想批量改变原先文件,可以用--wrire指定要修改文件的类型,更多配置参考这里。
touch .prettierrc npm install --save-dev prettier prettier --write **.js
有了prettier,还用editorConfig吗?
使用。一个是编辑器风格,一个是项目风格,作用不同。editorConfig起作用于敲代码之前,prettier起作用于保存代码之后;可以自己试验它们的不同,如以下为editorConfig空格设置为4,prettiter空格设置为2的场景,每次回车变成4格,每次保存又变成2格。
eslint
如果说editorConfig和prettier保证了你的风格,那eslint助你提高品位。eslint是代码静态分析工具,用于发现不符合规范的代码。
安装eslint
npm i --save-dev eslint // 全局安装eslint npm i -g eslint // 项目根目录 eslint --init
安装插件ESlint,保存时自动检查配置如下:
// vscode/setting.json "eslint.alwaysShowStatus": true, "eslint.autoFixOnSave": true, "eslint.validate": [ "javascript", "javascriptreact", "typescript", "typescriptreact" ]
项目中使用:
//在package.json的scripts中添加 "eslint": "eslint --fix ./"
使用建议:
- 不要在vscode开启全局使用eslint:eslint规范的是代码特性,且不说语言有可能进化,不同时空对代码的要求也不同,不适合一刀切。
- 使用正规大厂的代码的标准,比如说业界最有名的airbnb,这基本上是你使用eslint的意义所在。尽量不要使用自己定义的标准,我们往往因为偷懒和理解不深,定的标准不够全面。诚然airbnb有很多标准不适合当前项目,但是过度练习才能提高我们代码质量,当你理解规则之后再删减规则。比如说以下这条来自airbnb的规则,它不仅是规则,还是对代码的理解。更多内容参考这里
typescript+eslint+prettier+airbnb+hook配置
- 安装prettiter、eslint和typescript-eslint
npm install --save-dev prettier
npm install --save-dev eslint
npm install --save-dev @typescript-eslint/parser // 将 TypeScript 转换为 ESTree,使 eslint 可以识别
npm install --save-dev @typescript-eslint/eslint-plugin // 打开或关闭的规则列表
- 安装airbnb的typescript
npm install --save-dev eslint-config-airbnb-typescript
npm install --save-dev eslint-plugin-import
npm install --save-dev eslint-plugin-jsx-a11y
npm install --save-dev eslint-plugin-react
- 安装commit代码之前的提交工具:husky提供hooks机制,在git操作之前执行其他代码;lint-staged利用git的staged特性,可以提取出本次提交的变动文件,每次只对修改的代码做检测。
npm install husky --save-dev
npm install lint-staged --save-dev
- 安装hook检查
npm install --save-dev eslint-plugin-react-hooks
- 安装eslint继承prettier规则,这样能统一以prettier规则为主
npm install --save-dev eslint-config-prettier
- 配置:
// .eslintrc
touch .eslintrc
// parser必须配置;
// 使用typescript-eslint的推荐规则;
// 使用airbnb规则;检测规则能识别缩写。
{
"parser": "@typescript-eslint/parser",
"plugins": ["@typescript-eslint"]
"extends": [
"plugin:@typescript-eslint/recommended"
"airbnb-typescript"
"plugin:prettier/recommended"
],
"settings": {
"import/resolver": {
"node": {
"extensions": [".js", ".jsx", ".ts", ".tsx"]
}
}
}
"rules": {
"react-hooks/rules-of-hooks": "error",
"react-hooks/exhaustive-deps": "warn", // 提示useEffect可能重复执行
//不符合项目实际的将其关闭
"import/prefer-default-export": "off",
"import/no-extraneous-dependencies": "off"
}
}
- 提交前检查代码,配置如下:
//在package.json中
"husky": {
"hooks": {
"pre-commit": "lint-staged"
}
},
"lint-staged": {
"**/*.{js,ts,tsx}": [
"eslint --fix --ext .ts,.tsx,.js",
"prettier --write",
"git add"
],
},
注意:
- prettier的检查在lint-staged的第二阶段,故不需要通过eslint开启prettier
- 通过 --no-verify能跳过检查:git commit --no-verify -m "跳过代码检测"
lint-staged 路径说明:
{ "**/*.js": "工程下所有的 js 文件", "src/**/*.js": "src 文件夹下所有的 js 文件" }
- 使用eslint还是tslint?由于Typescript团队承诺使用eslint,故直接使用eslint更为妥当,详情。
规范链接:
另一个规则腾讯alloy