代码规范
准备
代码规范主要基于 ESLint 和 stylelint 运行,所以为保证代码风格统一,请统一使用 VS Code 做为开发工具,并安装以下扩展:
- EditorConfig for VS Code
- ESLint
- Vetur
- Prettier - Code formatter
- stylelint 安装完后需切换到 v0.87.6 版本,最新版无法使用
安装完后在 settings.json 中增加如下配置:
json
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true,
"source.fixAll.stylelint": true
}"editor.codeActionsOnSave": {
"source.fixAll.eslint": true,
"source.fixAll.stylelint": true
}完成以上配置,并确保项目已安装好依赖,便可查看最终效果:在保存代码时,会自动对当前文件进行代码格式化操作。
配置
配置文件主要有 3 处,分别为 IDE 配置(.editorconfig)、ESLint 配置(.eslintrc.js 和 .eslintignore)、StyleLint 配置(.stylelintrc 和 .stylelintignore)。
以代码缩进举例,框架默认是以 4 空格进行缩进,如果要调整为 2 空格,则需要在 .editorconfig 里修改:
indent_size = 2indent_size = 2在 .eslintrc.js 里修改:
'indent': [2, 2, {
'SwitchCase': 1
}],
...
'vue/html-indent': [2, 2],
...
'vue/script-indent': [2, 2, {
'switchCase': 1
}]'indent': [2, 2, {
'SwitchCase': 1
}],
...
'vue/html-indent': [2, 2],
...
'vue/script-indent': [2, 2, {
'switchCase': 1
}]在 .stylelintrc 里修改:
"indentation": 2"indentation": 2修改完毕后,再分别执行下面两句命令:
sh
yarn run lint
yarn run stylelintyarn run lint
yarn run stylelint该操作会将代码进行一次格式校验,如果规则支持自动修复,则会将不符合规则的代码自动进行格式化。以上面的例子,当缩进规则调整后,我们无需手动去每个文件调整,通过命令可以自动应用新的缩进规则。
Fantastic-admin 文档 (v1)