likes
comments
collection
share

你的代码提交友好吗？

作者站长头像
站长
· 阅读数 18

Git 是目前世界上最先进的分布式版本控制系统，而针对Git代码提交，我们一般对于记录描述怎么操作的呢？当我是个初入行的码农时，我希望你管我怎么提交，一般就几个字，我功能完成即可，例如：

git commit -m "调整修改"

当我开始变为资深码农，并且开始管理整个项目的代码质量以及规范时，看着年轻人提交的代码，你这都是个啥，啥叫调整修改。正如我们看着自己当年写的代码，充满怀疑，这竟然是我写的？

玩笑归玩笑，规范化的提交真是一个好习惯，在工作中一份清晰简介规范的 Commit Message 能让后续代码审查、信息查找、版本回退都更加高效可靠。

那么，快捷工具来了，commitizen/cz-cli。

Commit Message标准

标准包含Header，Body，Footer三个部分.

<type>(<scope>): <subject>
// ...
<body>
// ...
<footer>

其中，Header 是必需的，Body 和 Footer 非必须。

  1. Header Header 部分只有一行，包括三个字段：type（必需）、scope（可选）、subject（必需）
  • type：用于说明类型。可分以下几种类型
  • scope：用于说明影响的范围，比如数据层、控制层、视图层等等。
  • subject：主题，简短描述。一行
类型描述
feat新功能
fix修复bug
docs仅包含文档的修改
style样式及格式化变动，不影响代码逻辑。比如清除多余空白，删除分号等
refactor重构，既不新增功能，也不涉及修改bug的代码改动
perf提高性能的修改
test添加或修改测试代码
build构建工具或外部依赖包的修改。比如更新依赖包等
ci持续化集成配置文件或脚本修改
chore杂项。其它不修改源码与测试代码的修改
revert撤销某次提交
  1. Body

​ 对 subject 更详细的描述。

  1. Footer

​ 主要是对于issue的关联。

安装

官方意思验证了Node.js 12,14,16版本的Node，而我在18上无任何问题。

在本例中，我们将设置存储库以使用 AngularJS 的提交消息约定，也称为 traditional-changelog。还有其他适配器，例如cz-customizable。

  1. 首先，确保全局安装 Commitizen CLI 工具：
npm install commitizen -g

2. 接下来，在项目中通过输入以下命令初始化以使用cz-conventional-changelog适配器:

# npm
commitizen init cz-conventional-changelog --save-dev --save-exact

# yarn
commitizen init cz-conventional-changelog --yarn --dev --exact

# pnpm
commitizen init cz-conventional-changelog --pnpm --save-dev --save-exact

**请注意:**如果要在已经配置过的项目里面覆盖安装，则可以应用强制参数--force。还要了解其它详细信息，只需运行 。commitizen help

上面的命令都干了什么呢：

  1. 安装了cz-conventional-changelog适配器模块
  2. 将下载配置保存到了package.json
  3. 将适配器配置也写入了package.json
...
  "config": {
    "commitizen": {
      "path": "cz-conventional-changelog"
    }
  }

你的代码提交友好吗？

针对上面第三点适配器配置，你也可以建立一个.czrc文件，写入：

{
  "path": "cz-conventional-changelog"
}

3. 使用

当我们提交代码时，就可以将`git commit`命令替换成`git cz`,或者别名`cz`,`git-cz`等等。

你的代码提交友好吗？

[扩展]在项目中本地安装

上边我们的操作其实可以看到，针对的是自己电脑本地项目，那么如果是多人项目，我们肯定希望每个人都能使用同样的规范，那么可以将命令集成到项目中，那么我们就不能全局安装了：

npm install --save-dev commitizen

在 npm 5.2+ 上，可以使用 npx 初始化适配器：

npx commitizen init cz-conventional-changelog --save-dev --save-exact

对于以前版本的 npm(< 5.2),使用项目内部命令即可：

./node_modules/.bin/commitizen init cz-conventional-changelog --save-dev --save-exact

然后，您可以在package.json文件中添加命令：

  ...
  "scripts": {
    "commit": "cz"
  }

这对所有项目使用人员比较统一化，如果他们想进行提交，他们需要做的就是运行npm run commit

[扩展]通过git commit强制提交

针对项目管理者，我们定了一个规范，但是没法指望别人会严格遵守，所以如何使用 git 挂钩和命令行选项将 Commitizen 合并到现有工作流中。这对项目维护者很有用，确保对不熟悉 Commitizen 的人的贡献强制执行正确的提交格式。

首先确保我们是采用项目中本地集成安装了commitizen，然后可以选取以下两种方式之一.

方法一：传统的 git hooks

针对自己使用，修改以下文件：.git/hooks/prepare-commit-msg

#!/bin/bash
exec < /dev/tty && node_modules/.bin/cz --hook || true

**注意：**如果prepare-commit-msg文件是新建的，需要执行权限chmod 777 .git/hooks/prepare-commit-msg,否则：

你的代码提交友好吗？

方法二：husky

对于多用户，我们也可以借助husky来统一提交:

1. 安装husky
npm install husky -D

2. 初始化husky配置
npm pkg set scripts.prepare="husky install"
npm run prepare

3. 添加脚本，我们这边针对提交触发
npx husky add .husky/prepare-commit-msg "exec < /dev/tty && node_modules/.bin/cz --hook || true"

**疑问：**commitizen文档对于husky推荐利用package.json`添加husky配置，但是我这边不起作用，后边研究一下原因。

**注意：**一定慎重同时配置husky和本地git hooks，会重复执行。

全局安装

我们开发过程中，其实针对每个项目初始化适配器，不太友好，其实还可以全局配置。

全局安装commitizen和cz-conventional-changelog：

npm install -g commitizen

npm install -g cz-conventional-changelog

用户目录下创建配置文件（Mac下，Linux下同理）：

echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

项目和全局都配置了适配器，将先以本地为主。

你的代码提交友好吗？

VS CODE

vs code中可以使用git-commit-plugin 插件，这里不过多扩展了。

访问原文

你的代码提交友好吗？ | DLLCNX的博客

转载自:https://juejin.cn/post/7281532014729609251
评论
请登录