Git Flow使用规范

Git Flow使用规范

本文是之前我使用过的，对软件开发团队中如何使用git flow进行开发、测试、发布的流程进行归纳，开发团队可以参考执行本规则。

图示：

规则说明

开发阶段

开发新需求都从master拉取feature分支，不同迭代发布代码使用不同的分支，避免相互影响。

需要进行开发环境联调的代码合并到develop分支，由jekins自动发布到开发环境。

命名方式：dev-mmdd(时间)-需求名称，例如：dev-0812-redeemModfiy

测试阶段

每月为一个迭代周期由系统owner拉取提测分支test，并定期维护(merge master)。

开发feature分支合并到提测test分支，合并前需要由模块负责人进行review或交叉review。

多个feature分支在测试过程中，需要借助release分支来进行合并，然后再进行提测。

多个feature分支在测试过程中，某一个需求不能如期发布，需要将release分支删除，将可继续的分支重复执行第2步进行测试验证；

命名方式：test-mmdd(每月15日)，例如：test-0815 / release-mmdd(每月15日)，例如：release-0815

发布阶段

测试通过后release进行merge master，并解决冲突，在release分支回归测试

回归通过后，先在master分支拉取tag分支备份，然后把release合并到master。

发布master

命名方式：tag-mmdd(时间)，例如：tag-0812

分支拉取时间点和负责人

feature分支：

拉取时间点：开发开始时

负责人：开发人员

test分支

拉取时间点：每月迭代需求开始，不定期merge master

负责人：系统Owner

release分支

拉取时间点：开发需求合并提测前 or 回归测试前

负责人：开发人员

deelop分支

拉取时间点：合并发布开发环境时

负责人：开发人员

Git常用命令

新建代码库

# 在当前目录新建一个Git代码库

$ git init

# 新建一个目录，将其初始化为Git代码库

$ git init [project-name]

# 下载一个项目和它的整个代码历史

$ git clone [url]

配置

# 显示当前的Git配置

$ git config --list

# 编辑Git配置文件

$ git config -e [--global]

# 设置提交代码时的用户信息

$ git config [--global] user.name "[name]"

$ git config [--global] user.email "[email address]"

增加删除文件

# 添加当前目录的所有文件到暂存区

$ git add .

# 删除工作区文件，并且将这次删除放入暂存区

$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区

$ git rm --cached [file]

# 改名文件，并且将这个改名放入暂存区

$ git mv [file-original] [file-renamed]

代码提交

# 提交暂存区到仓库区

$ git commit -m [message]

分支

# 列出所有本地分支

$ git branch

# 列出所有远程分支

$ git branch -r

# 列出所有本地分支和远程分支

$ git branch -a

# 新建一个分支，但依然停留在当前分支

$ git branch [branch-name]

# 新建一个分支，并切换到该分支

$ git checkout -b [branch]

# 切换到指定分支，并更新工作区

$ git checkout [branch-name]

# 切换到上一个分支

$ git checkout -

# 合并指定分支到当前分支

$ git merge [branch]

# 选择一个commit，合并进当前分支

$ git cherry-pick [commit]

# 删除分支

$ git branch -d [branch-name]

# 删除远程分支

$ git push origin --delete [branch-name]

$ git branch -dr [remote/branch]

查看信息

# 显示有变更的文件

$ git status

# 显示当前分支的版本历史

$ git log

# 显示某个commit之后的所有变动，其"提交说明"必须符合搜索条件

$ git log [tag] HEAD --grep feature

# 显示某个文件的版本历史，包括文件改名

$ git log --follow [file]

$ git whatchanged [file]

# 显示指定文件相关的每一次diff

$ git log -p [file]

# 显示过去5次提交

$ git log -5 --pretty --oneline

# 显示所有提交过的用户，按提交次数排序

$ git shortlog -sn

# 显示指定文件是什么人在什么时间修改过

$ git blame [file]

# 显示暂存区和工作区的差异

$ git diff

# 显示工作区与当前分支最新commit之间的差异

$ git diff HEAD

# 显示今天你写了多少行代码

$ git diff --shortstat "@"

# 显示某次提交发生变化的文件

$ git show --name-only [commit]

# 显示当前分支的最近几次提交

$ git reflog

远程同步

# 下载远程仓库的所有变动

$ git fetch [remote]

# 显示所有远程仓库

$ git remote -v

# 增加一个新的远程仓库，并命名

$ git remote add [shortname] [url]

# 取回远程仓库的变化，并与本地分支合并

$ git pull [remote] [branch]

# 上传本地指定分支到远程仓库

$ git push [remote] [branch]

# 强行推送当前分支到远程仓库，即使有冲突

$ git push [remote] --force

# 推送所有分支到远程仓库

$ git push [remote] --all

撤消

# 恢复暂存区的指定文件到工作区

$ git checkout [file]

# 恢复某个commit的指定文件到暂存区和工作区

$ git checkout [commit] [file]

# 恢复暂存区的所有文件到工作区

$ git checkout .

# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变

$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致

$ git reset --hard

# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变

$ git reset [commit]

# 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致

$ git reset --hard [commit]

# 新建一个commit，用来撤销指定commit

# 后者的所有变化都将被前者抵消，并且应用到当前分支

$ git revert [commit]

# 暂时将未提交的变化移除，稍后再移入

$ git stash

$ git stash pop

参考

https://git-scm.com/book/zh/v1/Git-%E5%9F%BA%E7%A1%80

http://danielkummer.github.io/git-flow-cheatsheet/index.zh_CN.html

http://www.ituring.com.cn/article/56870

https://ihower.tw/blog/archives/5140

https://about.gitlab.com/2014/09/29/gitlab-flow/

我今天才知道，我之所以漂泊就是在向你靠近。

--《廊桥遗梦》