在正式参与项目开发之前,了解并且坚持使用一些规范更方便我们与同事之间的合作。这些通常是约定俗成的。
git提交准则
git源码中的Documentation/SubmittingPatches列举了git提交规范相关的说明文档。
提交之前的注意事项
1、检查空白错误
git diff --check #确认将提交的内容中有无空白信息
2、尝试让每一个提交成为一个逻辑上的独立变更集
尽量使每一笔提交都成为独立的patch,这让同事审查你的改动时尽量让事情容易些。
3、重写提交历史
正式提交之前,可以通过修改本地提交历史让提交后的信息更加易懂。
4、规范化提交信息
这里有份Tim Pope 写的模板,看看怎样才是规范的提交描述。稍后我们手动创建一个git message提交模板。
创建git message模板
1、git config
mi@ubuntu:~$ git config --global -e
....
#添加
[commit]
template = /home/mi/.gitmessage
2、配置模板
mi@ubuntu:~$ vim ~/.gitmessage
#title [where/what]
#JIRA-ID
#brief description for this bug [what/why]
#Change-Id:auto-generate
3、提交使用模板
mi@ubuntu:~$ git commit -s #尽量不用 git commit -m "xx"
- 分布式Git - 向一个项目贡献
- 编码规范之Git commit message style
- Git commit message 基本规范