git commit messgae 规范化

本文介绍了Git commit message的规范化,遵循Angular团队的Conventional Commits specification,详细讲解了message格式,并提供了安装与使用的步骤,包括使用commitizen工具和cz-conventional-changelog Adapter,以帮助生成合规的commit消息。
摘要由CSDN通过智能技术生成

git commit messgae 规范化 & 格式化

介绍:

git commit message 是一套约定式提交规范,用于形成规范化的提交记录,使之清晰,方便

格式举例:

目前规范使用较多的是 Angular 团队的规范, 继而衍生了 Conventional Commits specification. 很多工具也是基于此规范, 它的 message 格式如下:

<type>(<scope>): <subject> 标题行 必填
<BLANK LINE> 描述为什么修改, 做了什么样的修改, 以及开发的思路等等
<body>
<BLANK LINE>
<footer> 放 Breaking Changes 或 Closed Issues

工具安装:

安装步骤:

安装脚手架工具 commitizen/cz-cli,它提供了一个git cz 命令,用于替代git commit 命令,帮助生成符合规范的commit message
为commitizen 制定一个Adapter,此处使用 cz-conventional-changelog (一个符合 Angular团队规范的 preset). 使得 commitizen 按照我们指定的规范帮助我们生成 commit message.
安装方式:

  1. 全局安装 (全局模式下, 需要 ~/.czrc 配置文件, 为 commitizen 指定 Adapter.)
	n
在使用 Git 进行版本控制时,`git commit` 是用来将本地更改添加到 Git 仓库的过程。为了保证提交的规范性,有几个基本的 Git commit 规范可以考虑遵循: 1. 编写有意义的 commit 消息:每个 commit 消息应该清楚地描述你更改了什么以及为什么做出这些更改。这有助于其他人理解你的更改,并帮助他们快速找到特定版本的代码。 2. 使用短格式:每个 commit 消息应该只包含一个简短的描述,通常不超过 50 个字符。这样可以更有效地组织提交历史,并使查看提交历史更容易。 3. 使用完整的历史记录:在较长的时间范围内,使用完整的历史记录可以帮助其他人理解你的工作流程和决策过程。 4. 避免提交无关的更改:每次提交都应只包含与当前工作目录中的文件相关的更改。如果需要提交一些临时更改,最好将它们单独提交。 5. 使用 Git 预览器预览 commit 消息:在提交之前,最好使用 Git 预览器(如 `git commit --preview`)检查你的 commit 消息是否清晰、简洁且具有意义。 6. 避免使用特定的分支名或标签名:使用 `git commit` 时,避免在 commit 消息中提及特定的分支名或标签名,以避免在以后查找或比较特定版本时混淆。 7. 遵循一致的提交风格:确保在整个项目中遵循一致的提交风格。这有助于保持代码库的整洁和一致性。 遵循这些 Git commit 规范可以帮助你和其他人更好地理解你的工作,并使 Git 版本控制更加高效和有用。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值