前端实用工具（二）：编程规范化解决方案

devtools/2024/9/22 13:36:41/

目录

本地代码规范化工具

代码检测工具ESLint

代码格式化工具Prettier

远程代码规范化工具

远程提交规范化工具commitizen

提交规范检验工具commitlint +husky

什么是git hooks

commitlint安装

husky安装

检测代码提交规范 ESLint +husky

自动修复格式错误lint-staged

本地代码规范化工具

代码检测工具ESLint

项目中的.eslintrc.js 文件

// ESLint 配置文件遵循 commonJS 的导出规则，所导出的对象就是 ESLint 的配置对象
// 文档：https://eslint.bootcss.com/docs/user-guide/configuring
module.exports = {// 表示当前目录即为根目录，ESLint 规则将被限制到该目录下root: true,// env 表示启用 ESLint 检测的环境env: {// 在 node 环境下启动 ESLint 检测node: true},// ESLint 中基础配置需要继承的配置extends: ["plugin:vue/vue3-essential", "@vue/standard"],// 解析器parserOptions: {parser: "babel-eslint"},// 需要修改的启用规则及其各自的错误级别/*** 错误级别分为三种：* "off" 或 0 - 关闭规则* "warn" 或 1 - 开启规则，使用警告级别的错误：warn (不会导致程序退出)* "error" 或 2 - 开启规则，使用错误级别的错误：error (当被触发的时候，程序会退出)*/rules: {"no-console": process.env.NODE_ENV === "production" ? "warn" : "off","no-debugger": process.env.NODE_ENV === "production" ? "warn" : "off"}
};

之后ESLint规则在rules中以键值对的形式添加

代码格式化工具Prettier

安装prettier插件

新建 .prettierrc 文件，该文件为 perttier 默认配置文件

{// 不尾随分号"semi": false,// 使用单引号"singleQuote": true,// 多行逗号分割的语法中，最后一行不加逗号"trailingComma": "none"
}

在VSCode设置中，搜索 save ，勾选 Format On Save

ESLint和prettier的常见问题？

● VSCode默认制表符是4个空格，而ESLint希望一个制表符是两个空格

● 如果VSCode安装多个代码格式化工具可能会冲突

● ESLint和Prettier之间有冲突，默认ESLint括号前会有空格需要手动关闭'space-before-function-paren':'off'

远程代码规范化工具

远程提交规范化工具commitizen

commitizen 仓库名为 cz-cli ，它提供了一个 git cz 的指令用于代替 git commit，简单一句话介绍它：

当你使用 commitizen 进行代码提交（git commit）时，commitizen 会提交你在提交时填写所有必需的提交字段！

commitizen安装步骤如下：

  1. 全局安装Commitizen
npm install -g commitizen@4.2.4
  1. 安装并配置 cz-customizable 插件
  • 使用 npm 下载 cz-customizable
npm i cz-customizable@6.3.0 --save-dev
  • 添加以下配置到 package.json 中
..."config": {"commitizen": {"path": "node_modules/cz-customizable"}}
  1. 项目根目录下创建 .cz-config.js 自定义提示文件
module.exports = {// 可选类型types: [{ value: 'feat', name: 'feat:     新功能' },{ value: 'fix', name: 'fix:      修复' },{ value: 'docs', name: 'docs:     文档变更' },{ value: 'style', name: 'style:    代码格式(不影响代码运行的变动)' },{value: 'refactor',name: 'refactor: 重构(既不是增加feature，也不是修复bug)'},{ value: 'perf', name: 'perf:     性能优化' },{ value: 'test', name: 'test:     增加测试' },{ value: 'chore', name: 'chore:    构建过程或辅助工具的变动' },{ value: 'revert', name: 'revert:   回退' },{ value: 'build', name: 'build:    打包' }],// 消息步骤messages: {type: '请选择提交类型:',customScope: '请输入修改范围(可选):',subject: '请简要描述提交(必填):',body: '请输入详细描述(可选):',footer: '请输入要关闭的issue(可选):',confirmCommit: '确认使用以上信息提交？(y/n/e/h)'},// 跳过问题skipQuestions: ['body', 'footer'],// subject文字长度默认是72subjectLimit: 72
}
  1. 使用 git cz 代替 git commit

补充：

不同的团队可能会有不同的标准，那么咱们今天就以目前使用较多的 Angular团队规范 延伸出的 Conventional Commits specification（约定式提交） 为例，来为大家详解 git 提交规范

约定式提交规范要求如下：

<type>[optional scope]: <description>[optional body][optional footer(s)]--------  翻译 -------------<类型>[可选 范围]: <描述>[可选 正文][可选 脚注]

其中 <type> 类型，必须是一个可选的值，比如：

  1. 新功能：feat
  2. 修复：fix
  3. 文档变更：docs
  4. ....

如果忘记了git cz指令，我们有没有方法限制这种错误的出现？

我们可以使用git hooks + commitlint阻止不规范提交

提交规范检验工具commitlint +husky

检查提交描述是否符合规范要求husky+commitlint

什么是git hooks

Git hooks(git 钩子 || git 回调方法)：git在执行某些事件之间或之后进行一些其他额外的操作

PS：详细的 HOOKS介绍 可点击这里查看

整体的 hooks 非常多，当时我们其中用的比较多的其实只有两个：

  1. commit-msg：可以用来规范化标准格式，并且可以按需指定是否要拒绝本次提交
  2. pre-commit：会在提交前被调用，并且可以按需指定是否要拒绝本次提交

  • Husky：主要作用是简化git hooks的配置和管理，可以通过配置文件定义钩子行为（简化拆分git hooks）
  • commitlint：用来检查提交信息

Husky 和 commitlint 通常一起使用，Husky监听commit-msg函数，在每次提交之前触发commitlint 检查提交规范

下面我们分别安装两个工具

commitlint安装

  1. 安装依赖：
npm install --save-dev @commitlint/config-conventional@12.1.4 @commitlint/cli@12.1.4
  1. 创建 commitlint.config.js 文件（也可以手动创建）
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
  1. 打开 commitlint.config.js ， 增加配置项（ config-conventional 默认配置点击可查看 ）：
module.exports = {// 继承的规则extends: ['@commitlint/config-conventional'],// 定义规则类型rules: {// type 类型定义，表示 git 提交的 type 必须在以下类型范围内'type-enum': [// 当前验证的错误级别2,// 在什么情况下进行验证'always',['feat', // 新功能 feature'fix', // 修复 bug'docs', // 文档注释'style', // 代码格式(不影响代码运行的变动)'refactor', // 重构(既不增加新功能，也不是修复bug)'perf', // 性能优化'test', // 增加测试'chore', // 构建过程或辅助工具的变动'revert', // 回退'build' // 打包]],// subject 大小写不做校验'subject-case': [0]}
}

注意：确保保存为 UTF-8 的编码格式，否则可能会出现以下错误：

husky安装

  1. 安装依赖：
npm install husky@7.0.1 --save-dev
  1. 启动 hooks ， 生成 .husky 文件夹
npx husky install

  1. 在 package.json 中生成 prepare 指令（ 需要 npm > 7.0 版本 ）

命令无效就手动添加

npm set-script prepare "husky install"

  1. 执行 prepare 指令
npm run prepare
  1. 执行成功，提示

  1. 添加 commitlint 的 hook 到 husky中，并指令在 commit-msg 的 hooks 下执行 npx --no-install commitlint --edit "$1" 指令
npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'
  1. 此时的 .husky 的文件结构

至此， 不符合规范的 commit 将不再可提交：

PS F:\xxxxxxxxxxxxxxxxxxxxx\test-admin> git commit -m "测试"
⧗   input: 测试
✖   subject may not be empty [subject-empty]
✖   type may not be empty [type-empty]✖   found 2 problems, 0 warnings
ⓘ   Get help: https://github.com/conventional-changelog/commitlint/#what-is-commitlinthusky - commit-msg hook exited with code 1 (error)

检测代码提交规范 ESLint +husky

在前面的ESLint和Prettier配合解决的是本地代码的格式问题，而且我们需要手动在VSCode中配置自动保存

如果本地忘记配置了，怎么在提交之前如何检测代码格式是否错误？

husky 监测 pre-commit 钩子，在该钩子下执行 npx eslint --ext .js,.vue src 指令来去进行相关检测

执行脚本，在pre-commit 中执行检测代码

npx husky add .husky/pre-commit "npx eslint --ext .js,.vue src"

操作会生成对应文件 pre-commit：

此时如果不符合ESLint标准，代码提交失败

自动修复格式错误lint-staged

lint-staged 可以让你当前的代码检查 只检查本次修改更新的代码，并在出现错误的时候，自动修复并且推送

  1. 修改 package.json 配置
"lint-staged": {"src/**/*.{js,vue}": ["eslint --fix","git add"]}
  1. 如上配置，每次它只会在你本地 commit 之前，校验你提交的内容是否符合你本地配置的 eslint规则(这个见文档 ESLint )，校验会出现两种结果：
  • 如果符合规则：则会提交成功。
  • 如果不符合规则：它会自动执行 eslint --fix 尝试帮你自动修复，如果修复成功则会帮你把修复好的代码提交，如果失败，则会提示你错误，让你修好这个错误之后才能允许你提交代码。
  1. 修改 .husky/pre-commit 文件
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"npx lint-staged
  1. 再次执行提交代码
  2. 发现 暂存区中 不符合 ESlint 的内容，被自动修复


http://www.ppmy.cn/devtools/115481.html

相关文章

STM32快速复习(十二)FLASH闪存的读写

STM32快速复习(十二)FLASH闪存的读写

文章目录 一、FLASH是什么&#xff1f;FLASH的结构&#xff1f;二、使用步骤1.标准库函数2.示例函数 总结 一、FLASH是什么&#xff1f;FLASH的结构&#xff1f; 1、FLASH简介 &#xff08;1&#xff09;STM32F1系列的FLASH包含程序存储器、系统存储器和选项字节三个部分&…
阅读更多...
掌控历史：如何通过Git版本管理工具提升你的开发效率

掌控历史：如何通过Git版本管理工具提升你的开发效率

先一览全局: git目录 一.打开git二.git bash的基础命令三.配置git四.仓库搭建五.文件操作和状态六.忽略文件七.gitee的使用1.添加公钥2.创建仓库 八.vs中使用git九.git分支常用命令十.文件差异比较十一.文件回溯和推进十二.合并冲突和消除十三.合并/压缩提交十四.远程仓库推拉十…
阅读更多...
Ubuntu NFS 搭建及配置

Ubuntu NFS 搭建及配置

在 Ubuntu 上搭建和配置 NFS&#xff08;Network File System&#xff09;服务器&#xff0c;可以让其他设备通过网络访问共享的文件夹。以下是步骤指南&#xff1a; 1. 安装 NFS 服务器 首先&#xff0c;安装 NFS 服务器软件包&#xff1a; sudo apt update sudo apt insta…
阅读更多...
springbootKPL比赛网上售票系统

springbootKPL比赛网上售票系统

基于springbootvue实现的KPL比赛网上售票系统 &#xff08;源码L文ppt&#xff09;4-068 4.2 系统结构设计 架构图是系统的体系结构&#xff0c;体系结构是体系结构体系的重要组成部分。KPL比赛网上售票系统的总体结构设计如图4-2所示。 图4-2 系统总体架构图 4.3数据…
阅读更多...
链动3+1滑落模式小程序开发

链动3+1滑落模式小程序开发

链动31滑落模式是一种在电商、微商或社交电商领域常用的营销模式&#xff0c;通过用户推荐新用户形成团队结构&#xff0c;并依据团队的发展给予相应的奖励或优惠。在小程序平台上开发链动31滑落模式&#xff0c;需要考虑到用户体验、数据安全、奖励机制的实现等多个方面。以下…
阅读更多...
Serverless架构

Serverless架构

Serverless架构&#xff1a;漂浮在云端的轻盈与自由 类似于 Fn Project 的 Serverless 开源服务有很多&#xff0c;它们都旨在简化函数即服务(FaaS)的开发流程&#xff0c;使得开发者可以更专注于业务逻辑而不是底层基础设施。下面列举了一些知名的 Serverless 开源平台和服务…
阅读更多...
通过springcloud gateway优雅的进行springcloud oauth2认证和权限控制

通过springcloud gateway优雅的进行springcloud oauth2认证和权限控制

代码地址 如果对你有帮助请给个start&#xff0c;本项目会持续更新&#xff0c;目标是做一个可用的快速微服务开发平台&#xff0c;成为接私活&#xff0c;毕设的开发神器&#xff0c; 欢迎大神们多提意见和建议 使用的都是spring官方最新的版本&#xff0c;版本如下&#xff1…
阅读更多...
Unity3D入门(二) :Unity3D实现视角的丝滑过渡切换

Unity3D入门(二) :Unity3D实现视角的丝滑过渡切换

1. 前言 上篇文章&#xff0c;我们已经初步了解了Unity3D&#xff0c;并新建并运行起来了一个项目&#xff0c;使相机视角自动围绕着立方体旋转。 这篇文章&#xff0c;我们来讲一下Unity3D怎么过渡地切换视角。 我们继续是我上篇文章中的项目&#xff0c;但是需要向把Camera…
阅读更多...
最新文章

Copyright @ 2022~2023