git-style-guide

branch

  • 分支名要求简洁、清楚描述分支的作用,使用短横线’-‘分隔
  • 合并后删除远端分支

commit

  • 一个提交对应一个逻辑修改。不要将多个逻辑修改放在一次提交,也不要将一个逻辑修改拆分为多次提交。
  • 确保每次提交改动的文件与此次修改相关。不要把merge过来的代码放到本次提交。
  • 小步提交、尽早提交。只有提交过的代码才是可恢复的。

commit message

1
2
3
4
5
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
  • <type> 修改类型,只允许使用下面列出的类型
  • <scope> 影响的范围,写项目中对应的目录名称,如index、fastsell、deliveryman
  • <subject> 简要说明修改的内容
  • <body> 补充、详细说明commit内容
  • <footer> 附上需求或bug的iwork链接

types

  • feat: (feature) 新功能
  • fix: 修复错误
  • refactor: 代码重构,既不修复错误也不添加功能
  • chore: 构建过程或辅助工具的变动
  • docs: 文档
  • style: 格式(缩进、空行等)

示例

1
2
3
4
5
fix(order): 修复订单列表和详情商品图大小问题
旧商品图是后端拼接尺寸和裁剪参数,新商品不带这些参数,前端需要做下兼容
http://iwork3.58corp.com/bug/detail/ZZYP-2222

开发流程

  1. 分支开发,每个新需求或bug修复从远端master创建新分支
  2. 分支提测,每次提测前rebase origin/master
  3. QA测试完成后发起MR,由管理员手动合并到master(跟直接accept mr相比会少一个merge commit)
  4. 再次提测,QA验证master代码无误后上线

Tips:

  1. 如果你想合并几个commit,应该用 git rebase -i HEAD~4
  2. 如果你刚提交完一个commit,发现还有点东西忘了改,这时可以用 git commit --amend

reference

  1. Pro Git,第二版,简体中文
  2. git style guide