版本库提交信息规范与自动验证

版本库提交信息规范

本文规范借鉴社区使用最广的 Angular 规范，稍加修改。

一般提交命令我们使用如 git commit- m "feat(user): add user login"

其中当前 commit message 信息包括三部分：type（必需）、scope（可选）、subject（必需）

type

type 用于说明 commit 的类别，允许使用下面 8 个标识。

feat: # 新功能（feature）fix: # 修补 bug

docs: # 文档（documentation）style: # 格式（不影响代码执行的变动，非 css 样式专用）refactor: # 重构（既不是新增功能，也不是修改 bug 的代码变动）test: # 增加测试

chore: # 构建过程或辅助工具的变动

revert: # 对之前修改代码 commit 记录的还原 

scope

scope 用于说明 commit 的影响范围，比如数据层、控制层、视图层、功能模块等，视项目的不同而不同。

例如：

• 新增用户管理的新增用户功能

$ git commit -m "feat(user): add addUser"

• 修复了用户管理的新增用户功能的 bug

$ git commit -m "fix(user): addUser"

• 更新文档说明

$ git commit -m "docs(readme): update readme"

• 调整新增用户代码格式（代码换行或者删除换行）

$ git commit -m "style(user/add): wrap line"

• 增加单元测试代码

$ git commit -m "test: add test"

• 配置或者修改自动化部署文件或者构建工具

$ git commit -m "chore: cicd"

$ git commit -m "chore: add vue-router"

还有一种是相对来说比较特殊的对之前 commit 代码的回退，比如还原之前修改 bug 的错误提交

$ git commit -m "revert: fix(user): addUser"

subject

subject 是 commit 目的的简短描述，不超过 50 个字符

$ git commit -m "feat(course): 完成课程管理模块"

issue_id and pr_id

github 与 gitlab 还提供了自动识别 issue 与 pr 链接的功能。
在提交信息后面加上对应的 issue_id 或 pr_id，能够自动识别为对应链接，点击可跳转到对应界面。

$ git commit -m "fix(user): check user pwd (#1)"

这样的话，会自动识别 #1 为链接，跳到对应的 issue 或者 pr 页面。

自动验证提交信息规范

为了达到提交信息规范的校验效果，我们使用配置本地 git hooks 模板的方法，只需设置一次，之后从 gitlab 或者 github 上 clone 下来的代码都会沿用当前 hooks 配置。

下面命令操作环境为 git bash：

• github 克隆仓库到本地（gitlab 同理）

$ git clone https://github.com/jwchan1996/commit-msg.git
$ cd /commit-msg

• 创建 git 钩子模板文件夹

$ mkdir -p ~/.git_template/hooks 

• 复制当前配置好的 commit-msg hooks 文件到模板

$ cp commit-msg ~/.git_template/hooks

• 设置 git 的初始化模板的使用模板

$ git config --global init.templatedir ~/.git_template 

具体 commit-msg 文件可以点击查看详情