前端项目开发中如何统一代码风格?

发布时间 2023-05-10 10:21:02作者: icon-icon

一、问题

平时开发前端项目的时候,发现大家所用的编辑器都有所不同,编辑器中很多人喜欢制定自己的代码风格,这就导致协作的时候,大家的代码风格不统一。提交代码的时候会发现修改了大量的代码格式。

二、解决方案

使用eslint 和 Prettier 来统一代码风格并提高代码质量

三、解决步骤

在本文中,我将为你介绍如何在Vue项目中配置ESLint和Prettier,以及如何解决常见问题。

1、安装ESLint和Prettier

首先,你需要在你的项目中安装ESLint和Prettier。你可以使用npm或yarn来完成这个任务。在终端中输入以下命令:

npm install eslint prettier eslint-plugin-prettier eslint-config-prettier eslint-plugin-vue --save-dev

2、创建.eslintrc.js文件

在项目中创建一个.eslintrc.js文件。这个文件用来存储ESLint的相关配置。在这个文件中,可以指定哪些规则应该被应用,哪些规则应该被忽略,以及其他ESLint配置选项。
示例如下:
.eslintrc.js

module.exports = {
root: true,
env: {
node: true
},
extends: [
'plugin:vue/essential',
'eslint:recommended',
'@vue/prettier', // 是一个预定义的ESLint配置
'@vue/typescript'
],
plugins: ['prettier'],
rules: {
'prettier/prettier': ['error', { singleQuote: true, semi: false }]
}
}

3、创建.prettierrc.js文件

在项目根目录中创建一个.prettierrc.js文件。这个文件用来存储Prettier配置。在这个文件中,可以指定一些Prettier选项,例如缩进和分号。
示例如下;
.prettierrc.js

module.exports = {
singleQuote: true,
semi: false,
trailingComma: 'none'
}

4、配置vscode

在vscode编辑器中安装ESLint和Prettier插件来自动修复代码。
然后我们需要在项目的.vscode/settings.josn 文件中配置编辑器
示例如下:
.vscode/settings.josn

{
  "editor.formatOnSave": false, //关闭保存代码的时候自动格式化。是为了避免eslint和prettier格式规则冲突,会导致我们在保存的时候使用prettier的规则,但是在使用eslint--fix的时候使用eslint的规则
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true //
  }
}

四、总结

在使用ESLint和Prettier时,会遇到两者的规则冲突的情况,有可能Prettier格式化的代码不符合ESLint的规则,或者ESLint指出的错误与Prettier的格式化规则冲突。