51工具盒子

依楼听风雨
笑看云卷云舒,淡观潮起潮落

Vite4+Typescript+Vue3+Pinia 从零搭建(4) - 代码规范

项目代码同步至码云 weiz-vue3-template
要求代码规范,主要是为了提高多人协同和代码维护效率,结合到此项目,具体工作就是为项目配置 eslintprettier

editorconfig {#editorconfig}

安装 EditorConfig for VS Code 插件,根目录下新建 .editorconfig 文件,增加以下配置

|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 | [*.{js,jsx,ts,tsx,vue}] indent_style = space indent_size = 2 end_of_line = crlf trim_trailing_whitespace = true insert_final_newline = true max_line_length = 120 |


如果是非windows系统,end_of_line 设置为 cr

eslint {#eslint}

安装可以参考官方教程 vue.js代码规范
在这里,我们建议使用另一种方式,安装后,通过命令初始化。

1. 安装 {#1-安装}

|-----------|-------------------------| | 1 | npm i eslint -D |

2. 初始化 {#2-初始化}

|-----------|---------------------------------| | 1 | npm init @eslint/config |

以下是操作实例:

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 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 | PS D:\workspace\vue3\weiz-vue3-template> npm init @eslint/config Need to install the following packages: @eslint/create-config@0.4.6 Ok to proceed? (y) # 输入y开始安装 ? How would you like to use ESLint? ... # 如何使用eslint To check syntax only To check syntax and find problems > To check syntax, find problems, and enforce code style # 检查语法、发现问题并强制执行代码风格 # 选择第三项 ? What type of modules does your project use? ... # 项目使用哪种类型的模块 > JavaScript modules (import/export) CommonJS (require/exports) None of these # 选择第一项 ? Which framework does your project use? ... # 使用哪种框架 React > Vue.js None of these # 选择 vue ? Does your project use TypeScript? >> No / Yes # 项目里是否使用了ts # 选择yes ? Where does your code run? ... (Press <space> to select, <a> to toggle all, <i> to invert selection) # 代码运行环境,输入空格选择,可以多选 √ Browser √ Node # 都选中后回车 Use a popular style guide # 使用一种流行的风格指南 > Answer questions about your style # 自定义你的style # 选择第二项 ? What format do you want your config file to be in? ... # 你的config配置文件类型 > JavaScript YAML JSON # 建议选择js ? What style of indentation do you use? ... # 使用什么样的缩进风格 Tabs > Spaces # 建议空格 ? What quotes do you use for strings? ... # 字符串使用单引号还是双引号 Double > Single # 单引号 ? What line endings do you use? ... # 行尾格式 Unix > Windows # Windows,如果是非windows系统,选择 unix ? Do you require semicolons? >> No / Yes # 是否需要分号 # No @typescript-eslint/eslint-plugin@latest eslint-plugin-vue@latest @typescript-eslint/parser@latest eslint@latest ? Would you like to install them now? >> No / Yes # 检查后列出以上项目,选择yes安装 ? Which package manager do you want to use? ... # 使用哪种安装方式 > npm yarn pnpm # 选择npm,然后等待安装完成 ... added 138 packages, changed 1 package, and audited 184 packages in 50s 39 packages are looking for funding run `npm fund` for details found 0 vulnerabilities Successfully created .eslintrc.cjs file in D:\workspace\vue3\weiz-vue3-template |


安装完成,在根目录下生成了 .eslintrc.cjs 文件,并自带一些我们选择的配置。

3. 简易安装 {#3-简易安装}

通过以上安装我们发现,最终还是安装了4个依赖,@typescript-eslint/eslint-plugin@latest eslint-plugin-vue@latest @typescript-eslint/parser@latest eslint@latest,如果我们熟悉的话,后续就可以直接安装

|-----------|----------------------------------------------------------------------------------------------------------------------------------| | 1 | npm i @typescript-eslint/eslint-plugin@latest eslint-plugin-vue@latest @typescript-eslint/parser@latest eslint@latest -D |


然后在根目录下新建 .eslintrc.cjs,然后把我们常用的配置复制进去即可。

4. .eslintrc.cjs 配置 {#4-eslintrc-cjs-配置}

以下附带基础配置:

|------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 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 | module.exports = { env: { browser: true, es2021: true, node: true }, extends: [ 'eslint:recommended', 'plugin:@typescript-eslint/recommended', 'plugin:vue/vue3-essential', 'plugin:prettier/recommended' // 后续兼容prettier ], overrides: [ { env: { node: true }, files: ['.eslintrc.{js,cjs}'], parserOptions: { sourceType: 'script' } } ], parserOptions: { ecmaVersion: 'latest', parser: '@typescript-eslint/parser', sourceType: 'module' }, plugins: ['@typescript-eslint', 'vue'], rules: { indent: ['error', 2], 'linebreak-style': ['error', 'windows'], quotes: ['error', 'single'], semi: ['error', 'never'] } } |


5. .eslintignore {#5-eslintignore}

根目录下新建 .eslintignore 文件,增加需要忽略类型检查的文件和目录

|-----------------------|----------------------------------------------------------------| | 1 2 3 4 5 6 7 | node_modules dist public *.md *.txt .vscode index.html |


6. 增加命令 {#6-增加命令}

修改 package.json

|-----------------|--------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 | "scripts": { "lint": "eslint --fix --ext .ts,.tsx,.vue,.js,.jsx --max-warnings 0" } 运行 `npm run lint`,即可修复相关代码问题 |


prettier {#prettier}

prettier 是为了方便格式化代码,它的安装比较简单,后两个依赖是为了解决和 eslint 的冲突

1. 安装 {#1-安装-1}

|-----------|-------------------------------------------------------------------------| | 1 | npm i prettier eslint-config-prettier eslint-plugin-prettier -D |

2. .prettierrc {#2-prettierrc}

根目录下新建 .prettierrc 文件,并增加以下配置

|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 | { "useTabs": false, "tabWidth": 2, "printWidth": 120, "singleQuote": true, "trailingComma": "none", "bracketSpacing": true, "semi": false, "endOfLine": "crlf" } |


如果是非windows,endOfLine 设置为 cr

3. .prettierignore {#3-prettierignore}

根目录下新建 .prettierignore 文件,增加需要忽略格式化的文件和目录

|-----------------------|----------------------------------------------------------------| | 1 2 3 4 5 6 7 | node_modules dist public *.md *.txt .vscode index.html |


总结 {#总结}

做好以上配置后,可以运行 npm run lint 修复大部分代码格式问题,或者右键使用 prettier 格式化代码,将大大提高你的编码效率。

赞(0)
未经允许不得转载:工具盒子 » Vite4+Typescript+Vue3+Pinia 从零搭建(4) - 代码规范