# Vue项目接入Eslint与Prettier
# 简介
前端项目，主要有两种选择ESLint和TSLint。TSLint仅针对TS代码，因此如果采用TSLint规范TS代码，JS代码需要采用其他工具。而ESLint不仅能规范js代码，通过配置解析器，也能规范TS代码。此外由于性能问题，TypeScript 官方决定全面采用ESLint。
Eslint的主要功能包含代码格式的校验，代码质量的校验，JS规范，如用===而不是==判断相等、用驼峰命名变量而不是用下划线。而 Prettier 是美丽的意思,只是代码格式的校验（并格式化代码），不会对代码质量进行校验，如单行代码长度、tab 长度、空格、逗号表达式等问题。在实际项目中，eslint可以检测出代码问题，并标红，但是并不会自动格式化，需要手动格式化，接入Prettier并配置（需要分webstorm和vscode）可以进行自动化。但是需要考虑到的是，prettier和eslint的规则有可能冲突，因此需要考虑到当冲突时，需要解决冲突，以谁的标准为准，正常是以prettier为准。
# 起步
如果是新的项目，用vue官方的脚手架拉取项目时，在下面的步骤中选择Eslint+Prettier就好了，我们可以发现，官方也是集成了Eslint+Prettier的，因此还是比较靠谱的：
# 安装 Eslint 依赖
npm i -D eslint babel-eslint eslint-plugin-vue @vue/cli-plugin-eslint
eslint:ESLint的核心代码babel-eslint:eslint与babel整合包eslint-plugin-vue@vue/cli-plugin-eslint:eslint与vue整合包
当然如果已经安装过了，就可以不用安装了。
# 配置 Eslint
在项目的根目录下，新建.eslintrc.js文件，并将下面代码拷贝进去，具体规则看注释。或者看StandardJS 官方 (opens new window)
// .eslintrc.js
module.exports = {
root: true,
parserOptions: {
// 定义ESLint的解析器
parser: "babel-eslint",
sourceType: "module",
},
// 指定代码的运行环境
env: {
browser: true,
node: true,
es6: true,
},
extends: [
//继承 vue 的标准特性
"plugin:vue/essential",
"eslint:recommended",
],
// 自定义eslint规则，严格按照StandardJS
rules: {
"vue/max-attributes-per-line": [
2,
{
singleline: 10,
multiline: {
max: 1,
allowFirstLine: false,
},
},
],
"vue/singleline-html-element-content-newline": "off",
"vue/multiline-html-element-content-newline": "off",
"vue/name-property-casing": ["error", "PascalCase"],
"vue/no-v-html": "off",
// 两个空格缩进
indent: [
2,
2,
{
SwitchCase: 1,
},
],
// 单引号
quotes: [
2,
"single",
{
avoidEscape: true,
allowTemplateLiterals: true,
},
],
// 未使用的变量
"no-unused-vars": [
2,
{
vars: "all",
args: "after-used",
},
],
// 关键字前后空格
"keyword-spacing": [
2,
{
before: true,
after: true,
},
],
// function关键字和函数名后面的空格
"space-before-function-paren": [2, "never"],
// 除了null,其他用===而不是==
eqeqeq: ["error", "always", { null: "ignore" }],
// 字符串拼接操作符直接用空格
"space-infix-ops": 2,
// 逗号前面不用空格，逗号后面用空格
"comma-spacing": [
2,
{
before: false,
after: true,
},
],
// else必须和反花括号一行
"brace-style": [
2,
"1tbs",
{
allowSingleLine: true,
},
],
// 多行 if 语句的的括号不能省
curly: [2, "multi-line"],
// 使用浏览器全局变量时加上 window. 前缀
"no-undef": 2,
// 不允许有连续多行空行
"no-multiple-empty-lines": [
2,
{
max: 1,
},
],
// 换行符在运算符的位置
"operator-linebreak": [
2,
"after",
{
overrides: {
"?": "before",
":": "before",
},
},
],
// 条件语句中赋值语句
"no-cond-assign": 2,
// 单行代码块两边加空格
"block-spacing": [2, "always"],
// 对属性名强制使用驼峰
camelcase: [
0,
{
properties: "always",
},
],
// 不允许有多余的行末逗号
"comma-dangle": [2, "never"],
// 始终将逗号置于行末
"comma-style": [2, "last"],
// 点号操作符须与属性需在同一行
"dot-location": [2, "property"],
// 函数调用时标识符与括号间不留间隔
"func-call-spacing": ["error", "never"],
// 键值对当中冒号与值之间要留空白
"key-spacing": [
2,
{
beforeColon: false,
afterColon: true,
},
],
// 构造函数要以大写字母开头, 但调用大写字母开头的函数不一定需要new
"new-cap": [
2,
{
newIsCap: true,
capIsNew: false,
},
],
// 无参的构造函数调用时要带上括号
"new-parens": 2,
// 对象中定义了存值器，一定要对应的定义取值器
"accessor-pairs": 2,
// 子类的构造器中一定要调用 super
"constructor-super": 2,
// 使用数组字面量而不是构造器
"no-array-constructor": "error",
// 避免使用 arguments.callee 和 arguments.caller
"no-caller": 2,
// 避免对类名重新赋值
"no-class-assign": 2,
// 避免修改使用 const 声明的变量
"no-const-assign": 2,
// 正则中不要使用控制符
"no-control-regex": "error",
// 不要对变量使用 delete 操作。
"no-delete-var": 2,
// 不要定义冗余的函数参数
"no-dupe-args": 2,
// 类中不要定义冗余的属性
"no-dupe-class-members": 2,
// 对象字面量中不要定义重复的属性
"no-dupe-keys": 2,
// switch 语句中不要定义重复的 case 分支
"no-duplicate-case": 2,
// 同一模块有多个导入时一次性写完
"no-duplicate-imports": "error",
// 正则中不要使用空字符
"no-empty-character-class": 2,
// 不要解构空值
"no-empty-pattern": 2,
//
"no-eval": 2,
"no-ex-assign": 2,
"no-extend-native": 2,
"no-extra-bind": 2,
"no-extra-boolean-cast": 2,
"no-extra-parens": [2, "functions"],
"no-fallthrough": 2,
"no-floating-decimal": 2,
"no-func-assign": 2,
"no-implied-eval": 2,
"no-inner-declarations": [2, "functions"],
"no-invalid-regexp": 2,
"no-irregular-whitespace": 2,
"no-iterator": 2,
"no-label-var": 2,
"no-labels": [
2,
{
allowLoop: false,
allowSwitch: false,
},
],
"no-lone-blocks": 2,
"no-mixed-spaces-and-tabs": 2,
"no-multi-spaces": 2,
"no-multi-str": 2,
"no-new-func": "error",
"no-new-object": 2,
"no-new-require": 2,
"no-new-symbol": 2,
"no-new-wrappers": 2,
"no-obj-calls": 2,
"no-octal": 2,
"no-octal-escape": 2,
"no-path-concat": 2,
"no-proto": 2,
"no-redeclare": 2,
"no-regex-spaces": 2,
"no-return-assign": [2, "except-parens"],
"no-self-assign": 2,
"no-self-compare": 2,
"no-sequences": 2,
"no-shadow-restricted-names": 2,
"no-sparse-arrays": 2,
"no-template-curly-in-string": "error",
"no-this-before-super": 2,
"no-throw-literal": 2,
"no-trailing-spaces": 2,
"no-undef-init": 2,
"no-unmodified-loop-condition": 2,
"no-unneeded-ternary": [
2,
{
defaultAssignment: false,
},
],
"no-unreachable": 2,
"no-unsafe-finally": 2,
"no-unsafe-negation": "error",
"no-useless-call": 2,
"no-useless-computed-key": 2,
"no-useless-escape": 0,
"no-useless-rename": 2,
"no-whitespace-before-property": 2,
"no-with": 2,
"padded-blocks": [2, "never"],
"rest-spread-spacing": ["error", "never"],
"semi-spacing": [
2,
{
before: false,
after: true,
},
],
"space-before-blocks": [2, "always"],
"space-in-parens": [2, "never"],
"space-unary-ops": [
2,
{
words: true,
nonwords: false,
},
],
"spaced-comment": [
2,
"always",
{
markers: [
"global",
"globals",
"eslint",
"eslint-disable",
"*package",
"!",
",",
],
},
],
"template-curly-spacing": [2, "never"],
"use-isnan": 2,
"valid-typeof": 2,
"wrap-iife": [2, "any"],
"yield-star-spacing": [2, "both"],
yoda: [2, "never"],
// 分号
semi: [2, "never"],
"no-unexpected-multiline": 2,
"arrow-spacing": [
2,
{
before: true,
after: true,
},
],
"eol-last": 2,
"generator-star-spacing": [
2,
{
before: true,
after: true,
},
],
"handle-callback-err": [2, "^(err|error)$"],
"jsx-quotes": [2, "prefer-single"],
"no-array-constructor": 2,
"no-console": "off",
"no-native-reassign": 2,
"no-negated-in-lhs": 2,
"no-shadow-restricted-names": 2,
"no-spaced-func": 2,
"no-useless-constructor": 2,
"one-var": [
2,
{
initialized: "never",
},
],
"prefer-const": 2,
"no-debugger": process.env.NODE_ENV === "production" ? 2 : 0,
"object-curly-spacing": [
2,
"always",
{
objectsInObjects: false,
},
],
"array-bracket-spacing": [2, "never"],
},
//当使用第三方的SDK时，eslint会报找不到，可以加入到globals，取消对这个的检查
globals: {
fengmap: true,
},
};
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
如果有需要忽略的文件也可以在 .eslintignore 文件中进行配置:
// .eslintignore
build/*.js
src/assets
public
dist
2
3
4
5
# 安装 prettier 依赖
Prettier 是一个代码格式化工具，但并非针对一种语言，对 HTML/CSS/JavaScript/Vue/SCSS 都有效果。可以通过配置文件在不同项目间统一代码格式化，以修正不同编辑器/IDE 之间格式化不同的问题。
安装依赖:
npm i -D prettier eslint-plugin-prettier eslint-config-prettier prettier-eslint-cli
prettier：prettier插件的核心代码eslint-plugin-prettier：将prettier作为ESLint规范来使用eslint-config-prettier：解决ESLint中的样式规范和prettier中样式规范的冲突，以prettier的样式规范为准，使ESLint中的样式规范自动失效prettier-eslint-cli:prettier-eslint-cli允许你对多个文件用prettier-eslint进行格式化。
# Prettier 配置
在项目的根目录下创建.prettierrc.js文件并配置prettier代码检查规则:
// .prettierrc.js
module.exports = {
// 最大长度80个字符
printWidth: 80,
// 行末分号
semi: false,
// 单引号
singleQuote: true,
// JSX双引号
jsxSingleQuote: false,
// 尽可能使用尾随逗号（包括函数参数）
trailingComma: "none",
// 在对象文字中打印括号之间的空格。
bracketSpacing: true,
// > 标签放在最后一行的末尾，而不是单独放在下一行
jsxBracketSameLine: false,
// 箭头圆括号
arrowParens: "avoid",
// 在文件顶部插入一个特殊的 @format 标记，指定文件格式需要被格式化。
insertPragma: false,
// 缩进
tabWidth: 2,
// 使用tab还是空格
useTabs: false,
// 行尾换行格式
endOfLine: "auto",
HTMLWhitespaceSensitivity: "ignore",
};
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
再更新一下eslint的配置，以处理prettier和eslint的冲突。
// .eslintrc.js
module.exports = {
// 其他配置。。。
extends: [
//继承 vue 的标准特性
"plugin:vue/essential",
"eslint:recommended",
//避免与 prettier 冲突
"plugin:prettier/recommended",
],
// 其他配置不变。。。
};
2
3
4
5
6
7
8
9
10
11
12
# 开发工具配置
公司的开发工具可能有Vscode和Webstorm。因此这里分开配置，并自行找到对应的方案。
# VScode 配置
首先需要安装Eslint、Prettier、Vetur插件。如下图所示：
然后打开setting将下面的代码黏贴进去，这样在 VScode 中保存（ctrl+s）的时候就会进行自动格式化：
{
"eslint.enable": true,
"eslint.options": {
"extensions": [".js", ".vue", ".ts", ".tsx"]
},
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
},
"eslint.validate": [
"vue",
"html",
"javascript",
"typescript",
"javascriptreact",
"typescriptreact"
],
"vetur.format.defaultFormatter.html": "prettier"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
需要注意的是，在vscode中其实Vetur也有一套Format规则，因此会和prettier冲突。如何解决尼，如下图所示，打开setting将Vetur的规则改成Prettier就好了。
# Webstorm 配置
首先WebStorm 配置 ESLint 即时检查:
然后配置保存自动格式化：
打开webstorm设置（file=>setting=>tools=>flie watchers），如下图所所示：
正常情况下 prettier 路径不用改，除非特殊情况。然后一路 ok=>apply 即可。
# 其他
在项目迁移和规范化的过程中，我们不可能一次性将所有已经存在的代码都格式化成符合Eslint和Prettier规范的代码，因此在实际过程中我们是采用混合开发，也就是在实际做业务需求过程中将改动的文件格式化成符合规范的代码，对尚未碰见的代码不做改动，保证项目的正常运行。在开发的过程中，为了保证团队所有成员都能严格执行 Eslint 规范，采用 husky 构建工作流，eslint 将检查做了修改，存在 stage 阶段尚未 commit 阶段的代码，在 commit 前进行校验，校验无误即通过，否则不通过。当然这不是必须的，因此以下内容可根据需要进行阅读。
# 安装依赖
npm install husky lint-staged --save-dev
husky: 在项目中添加git钩子，在git各个生命周期（姑且这样称呼吧）中执行一些自定义操作。我们这里主要是用在git提交之前执行linter操作，不通过则提交无效。lint-staged: 简而言之，就是只针对git提交的文件进行一些操作，而非整个项目的所有文件。我们这里主要是用在git提交之前进行linter时只针对提交的文件，以进行渐进式的重构。
// .huskyrc.js
module.exports = {
hooks: {
// git commit 前的钩子
"pre-commit": "lint-staged",
"post-commit": "git update-index --again",
},
};
2
3
4
5
6
7
8
// lint-staged.config.js
module.exports = {
"src/**/*.{js,vue}": ["eslint --fix", "git add"],
"src/**/*.{vue,html,css,scss,sass}": ["stylelint --fix", "git add"],
"src/**/*.{js,vue,html,css,scss,sass}": [
"prettier-eslint --write",
"git add",
],
};
2
3
4
5
6
7
8
9
# 总结
基本上，这些工具初次配置起来还是非常麻烦的，但这是一件一劳永逸的事情，所以还是值得花时间去做的。
❤️ 爱心三连击
1.看到这里了就点个在看支持下吧，你的「在看」是我创作的动力。
2.关注公众号前端梦想家，「一起学前端」！
3.添加微信【qdw1370336125】，拉你进技术交流群一起学习。