react + typescript配置eslint + prettier + husky

Eslint配置#

安装Eslint

1
pnpm i eslint -D
2
# ESLint 专门解析 TypeScript 的解析器
3
pnpm i @typescript-eslint/parser -D
4
# 内置各种解析 TypeScript rules 插件
5
pnpm i @typescript-eslint/eslint-plugin -D
6

7
# eslint插件 命名方式eslint-plugin-<plugin-name>
8
pnpm i babel-eslint eslint-plugin-react eslint-plugin-import -D

创建eslint配置文件

安装完成之后需要设置一个配置文件，可以通过命令行工具直接生成
Terminal window
```
1
npx eslint --init
```
会自动安装eslint-plugin-react等相关依赖
完成后项目中会多出一个.eslint.js文件，eslint的配置文件

在package.json中添加脚本

1
{
2
  "scripts": {
3
    "lint": "eslint src/**/*.{js,jsx,vue,ts,tsx} --fix",
4
  }
5
}

添加.eslintignore文件

1
*.sh
2
node_modules
3
lib
4
coverage
5
*.md
6
*.scss
7
*.woff
8
*.ttf
9
src/index.ts
10
dist

执行pnpm lint
报错问题处理
- Error while loading rule ‘@typescript-eslint/dot-notation’，stackoverflow
  配置parserOptions.project
```
1
parserOptions: {
2
  project: ['tsconfig.json'],
3
},
```
- Missing return type on function.
```
1
"@typescript-eslint/explicit-function-return-type": 0,
```
eslint工作原理

Eslint默认使用Espree解析javaScript代码，将代码转换为AST，然后拦截检测是否符合我们规定的书写方式，最后展示报错、警告等

配置prettier#

安装
Terminal window
```
1
pnpm i -D prettier eslint-config-prettier eslint-plugin-prettier
```
- prettier: 核心模块
- eslint-config-prettier: 关闭所有不必要或可能跟prettier产生冲突的规则
- eslint-plugin-prettier: 可以让eslint使用prettier规则进行检查

.eslint.js中添加extends配置

1
{
2
  "extends": [
3
      // 其他配置
4
      "plugin:prettier/recommended",
5
  ],
6
}

根目录创建prettier.config.js文件

1
module.exports = {
2
  printWidth: 80,
3
  tabWidth: 2,
4
  bracketSpacing: true,
5
  arrowParens: "always",
6
  endOfLine: "auto",
7
  singleQuote: true,
8
  trailingComma: "none",
9
  semi: false,
10
  useTabs: false
11
}

一些配置的意思

1
  // 字符串使用单引号
2
  singleQuote: true,
3
  // 每行末尾自动添加分号
4
  semi: true,
5
  // tab缩进大小,默认为2
6
  tabWidth: 2,
7
  // 使用tab缩进，默认false
8
  useTabs: false,
9
  // 对象中打印空格 默认true
10
  // true: { foo: bar }
11
  // false: {foo: bar}
12
  bracketSpacing: true,
13
  // 箭头函数参数括号 默认avoid 可选 avoid| always
14
  // avoid 能省略括号的时候就省略 例如x => x
15
  // always 总是有括号
16
  arrowParens: 'avoid',
17
  // 换行长度，默认80
18
  printWidth: 80,
19

20
-----------------------以下内容为参考项--------------------------
21
"prettier.printWidth": 100, // 超过最大值换行
22
"prettier.tabWidth": 4, // 缩进字节数
23
"prettier.useTabs": false, // 缩进不使用tab，使用空格
24
"prettier.semi": true, // 句尾添加分号
25
"prettier.singleQuote": true, // 使用单引号代替双引号
26
"prettier.proseWrap": "preserve", // 默认值。因为使用了一些折行敏感型的渲染器（如GitHub comment）而按照markdown文本样式进行折行
27
"prettier.arrowParens": "avoid", //  (x) => {} 箭头函数参数只有一个时是否要有小括号。avoid：省略括号
28
"prettier.bracketSpacing": true, // 在对象，数组括号与文字之间加空格 "{ foo: bar }"
29
"prettier.disableLanguages": ["vue"], // 不格式化vue文件，vue文件的格式化单独设置
30
"prettier.endOfLine": "auto", // 结尾是 \n \r \n\r auto
31
"prettier.eslintIntegration": false, //不让prettier使用eslint的代码格式进行校验
32
"prettier.htmlWhitespaceSensitivity": "ignore",
33
"prettier.ignorePath": ".prettierignore", // 不使用prettier格式化的文件填写在项目的.prettierignore文件中
34
"prettier.jsxBracketSameLine": false, // 在jsx中把'>' 是否单独放一行
35
"prettier.jsxSingleQuote": false, // 在jsx中使用单引号代替双引号
36
"prettier.parser": "babylon", // 格式化的解析器，默认是babylon
37
"prettier.requireConfig": false, // Require a 'prettierconfig' to format prettier
38
"prettier.stylelintIntegration": false, //不让prettier使用stylelint的代码格式进行校验
39
"prettier.trailingComma": "es5", // 在对象或数组最后一个元素后面是否加逗号（在ES5中加尾逗号）
40
"prettier.tslintIntegration": false // 不让prettier使用tslint的代码格式进行校验
41
————————————

添加.prettier.json后需要重启vscode，否则不会生效，另外需要在prettier的配置中使用Use Editor Config配置

配置package.json的scripts脚本

1
"format": "prettier --write \"src/**/*.ts\" \"src/**/*.tsx\"",

执行命令pnpm format

最终的eslint配置如下

1
module.exports = {
2
  // 指定环境，比如是浏览器还是 Node，会提供一些预定义的全局变量
3
  env: {
4
    browser: true,
5
    es2021: true
6
  },
7
  // 要扩展的配置文件 共享配置后面的覆盖前面的
8
  extends: [
9
    'eslint:recommended',
10
    'standard-with-typescript',
11
    'plugin:react/recommended',
12
    'plugin:@typescript-eslint/recommended',
13
    'plugin:prettier/recommended'
14
  ],
15
  overrides: [],
16
  parserOptions: {
17
    parser: '@babel/eslint-parser',
18
    project: ['tsconfig.json'],
19
    ecmaVersion: 'latest',
20
    sourceType: 'module'
21
  },
22
  plugins: ['react', '@typescript-eslint'],
23
  settings: {
24
    react: {
25
      version: '18.0.0'
26
    }
27
  },
28

29
  /**
30
   * 配置规则
31
   * "off" 或 0 - 关闭规则
32
   * "warn" 或 1 - 开启规则，使用警告级别的错误：warn (不会导致程序退出),
33
   * "error" 或 2 - 开启规则，使用错误级别的错误：error (当被触发的时候，程序会退出)
34
   */
35
  rules: {
36
    quotes: [2, 'single'], //单引号
37
    'no-console': 0, //不禁用console
38
    'no-debugger': 2, //禁用debugger
39
    'no-var': 0, //对var警告
40
    semi: 0, //不强制使用分号
41
    'no-irregular-whitespace': 0, //不规则的空白不允许
42
    'no-trailing-spaces': 1, //一行结束后面有空格就发出警告
43
    'eol-last': 0, //文件以单一的换行符结束
44
    'no-unused-vars': [2, { vars: 'all', args: 'after-used' }], //不能有声明后未被使用的变量或参数
45
    'no-underscore-dangle': 0, //标识符不能以_开头或结尾
46
    'no-alert': 2, //禁止使用alert confirm prompt
47
    'no-lone-blocks': 0, //禁止不必要的嵌套块
48
    'no-class-assign': 2, //禁止给类赋值
49
    'no-cond-assign': 2, //禁止在条件表达式中使用赋值语句
50
    'no-const-assign': 2, //禁止修改const声明的变量
51
    'no-delete-var': 2, //不能对var声明的变量使用delete操作符
52
    'no-dupe-keys': 2, //在创建对象字面量时不允许键重复
53
    'no-duplicate-case': 2, //switch中的case标签不能重复
54
    'no-dupe-args': 2, //函数参数不能重复
55
    'no-empty': 2, //块语句中的内容不能为空
56
    'no-func-assign': 2, //禁止重复的函数声明
57
    'no-invalid-this': 0, //禁止无效的this，只能用在构造器，类，对象字面量
58
    'no-redeclare': 2, //禁止重复声明变量
59
    'no-spaced-func': 2, //函数调用时 函数名与()之间不能有空格
60
    'no-this-before-super': 0, //在调用super()之前不能使用this或super
61
    'no-undef': 2, //不能有未定义的变量
62
    'no-use-before-define': 2, //未定义前不能使用
63
    camelcase: 0, //强制驼峰法命名
64
    'jsx-quotes': [2, 'prefer-double'], //强制在JSX属性（jsx-quotes）中一致使用双引号
65
    'react/display-name': 0, //防止在React组件定义中丢失displayName
66
    'react/forbid-prop-types': [2, { forbid: ['any'] }], //禁止某些propTypes
67
    'react/jsx-boolean-value': 2, //在JSX中强制布尔属性符号
68
    'react/jsx-closing-bracket-location': 1, //在JSX中验证右括号位置
69
    'react/jsx-curly-spacing': [2, { when: 'never', children: true }], //在JSX属性和表达式中加强或禁止大括号内的空格。
70
    'react/jsx-indent-props': [2, 4], //验证JSX中的props缩进
71
    'react/jsx-key': 2, //在数组或迭代器中验证JSX具有key属性
72
    'react/jsx-max-props-per-line': [1, { maximum: 1 }], // 限制JSX中单行上的props的最大数量
73
    'react/jsx-no-bind': 0, //JSX中不允许使用箭头函数和bind
74
    'react/jsx-no-duplicate-props': 2, //防止在JSX中重复的props
75
    'react/jsx-no-literals': 0, //防止使用未包装的JSX字符串
76
    'react/jsx-no-undef': 1, //在JSX中禁止未声明的变量
77
    'react/jsx-pascal-case': 0, //为用户定义的JSX组件强制使用PascalCase
78
    'react/jsx-sort-props': 2, //强化props按字母排序
79
    'react/jsx-uses-react': 1, //防止反应被错误地标记为未使用
80
    'react/jsx-uses-vars': 2, //防止在JSX中使用的变量被错误地标记为未使用
81
    'react/no-danger': 0, //防止使用危险的JSX属性
82
    'react/no-did-mount-set-state': 0, //防止在componentDidMount中使用setState
83
    'react/no-did-update-set-state': 1, //防止在componentDidUpdate中使用setState
84
    'react/no-direct-mutation-state': 2, //防止this.state的直接变异
85
    'react/no-multi-comp': 2, //防止每个文件有多个组件定义
86
    'react/no-set-state': 0, //防止使用setState
87
    'react/no-unknown-property': 2, //防止使用未知的DOM属性
88
    'react/prefer-es6-class': 2, //为React组件强制执行ES5或ES6类
89
    'react/prop-types': 0, //防止在React组件定义中丢失props验证
90
    'react/react-in-jsx-scope': 2, //使用JSX时防止丢失React
91
    'react/self-closing-comp': 0, //防止没有children的组件的额外结束标签
92
    'react/sort-comp': 2, //强制组件方法顺序
93
    'no-extra-boolean-cast': 0, //禁止不必要的bool转换
94
    'react/no-array-index-key': 0, //防止在数组中遍历中使用数组key做索引
95
    'react/no-deprecated': 1, //不使用弃用的方法
96
    'react/jsx-equals-spacing': 2, //在JSX属性中强制或禁止等号周围的空格
97
    'no-unreachable': 1, //不能有无法执行的代码
98
    'comma-dangle': 2, //对象字面量项尾不能有逗号
99
    'no-mixed-spaces-and-tabs': 0, //禁止混用tab和空格
100
    'prefer-arrow-callback': 0, //比较喜欢箭头回调
101
    'arrow-parens': 0, //箭头函数用小括号括起来
102
    'arrow-spacing': 0 //=>的前/后括号
103
  }
104
}

vscode配置#

添加配置文件.editorconfig

1
root = true
2

3
[*]
4
indent_style = space
5
indent_size = 2
6
end_of_line = lf
7
charset = utf-8
8
trim_trailing_whitespace = true
9
insert_final_newline = true

目的：

ESLint 配置目的是在代码提交时进行审核
VSCode 插件目的是在编写代码时进行辅助（提醒、格式化）

Husky + git hooks自动化提交验证#

安装
Terminal window
```
1
pnpm i husky lint-staged -D
```
package.json添加husky脚本
Terminal window
```
1
npm set-script prepare "husky install"
```
执行此命令，package.json文件的scripts中，就会自动添加prepare
初始化husky，将git hooks钩子交由husky执行
Terminal window
```
1
pnpm run prepare
```
执行此命令，会在根目录下拆功能键.husky目录
添加pre-commit钩子
Terminal window
```
1
npx husky add .husky/pre-commit "pnpm lint"
```
.husky目录下会自动创建pre-commit钩子
修改hooks程序 .husky/pre-commit
```
1
#!/bin/sh
2
. "$(dirname "$0")/_/husky.sh"
3

4
pnpm run lint
```
如果不加run的话会报错
执行git add . git commit

提交代码之前，pre-commit都会拦截 Git 的 commit 操作，然后运行lint命令进行代码检测，若检测到有违反校验规则的情况，则会返回错误，从而导致git commit失败。

安装lint-staged只校验暂存区文件

1
npm install lint-staged --save-dev

在package.json中添加配置即可，这样就不会所有文件都校验

1
  "lint-staged": {
2
    "*.{ts,tsx,js,vue}": [
3
        "eslint --fix",
4
        "git add"
5
    ],
6
    "*.{vue,css,scss,less}": [
7
        "stylelint --fix",
8
        "git add"
9
    ]
10
  }

commit规范#

目前最为流行的提交信息规范来自于 Angular 团队

1
type：commit 的类型；
2
feat：新功能、新特性；
3
fix: 修改 bug；
4
perf：更改代码，以提高性能；
5
refactor：代码重构（重构，在不影响代码内部行为、功能下的代码修改）；
6
docs：文档修改；
7
style：代码格式修改, 注意不是 css 修改（例如分号修改）；
8
test：测试用例新增、修改；
9
build：影响项目构建或依赖项修改；
10
revert：恢复上一次提交；
11
ci：持续集成相关文件修改；
12
chore：其他修改（不在上述类型中的修改）；
13
release：发布新版本；
14
workflow：工作流相关文件修改。

配置commitlint提交时自动检查commit信息

安装commitlint

1
pnpm i -D commitlint @commitlint/config-conventional

创建commitlint.config.js文件

1
module.exports = { extends: ['@commitlint/config-conventional'] };

添加commitline到githoos中

1
npx husky add .husky/commit-msg npx --no -- commitlint --edit "$1"

配置完成后，commit提交测试如下

音乐

音乐

Eslint配置#

配置prettier#

vscode配置#

Husky + git hooks自动化提交验证#

commit规范#

音乐

文章目录