Git 在小团队中的管理流程

目标读者：了解 Git 的基本概念，能够使用 Git 进行基本的本地和远程操作。

######### 有关 Git 的基础知识可以参见知乎回答-怎样使用 GitHub？，天猪（刘勇）给出了一些很好的学习资料。

本文介绍了小团队中 Git 管理的基本使用流程。

小团队的代码管理可以采用这样一种方式：项目存在一个中心远程仓库，作为团队成员进行代码交流的主要场所。同时可以存在一些成员远程仓库，用于局限在团队中部分成员间的代码交流。并将成员分成以下几类不同的角色：负责人、普通组员、预发布责任人和版本修复责任人。下面的章节具体介绍了各类角色的 Git 使用流程。

基本须知：

需要多个人共同完成的分支可以建立远程分支，单个人完成的分支只建立本地分支即可。

一、负责人

负责人的职责：管理远程仓库。

负责人的工作均可直接在远程仓库完成。

1.创建项目

创建公有项目
添加README.md
添加证书
添加忽略文件
创建 dev 分支

2.其他

更新 README.md 文件

二、组员

工作流程：

克隆项目

签出并创建 dev 分支，使其跟踪远程的 origin/dev 分支。

在dev分支基础上创建自己的分支 member* 。

在自己的分支上添加文件

在自己的分支上修改文件

合并到dev分支

推送dev分支到origin/dev分支

// 更新 .gitignore 文件

从 dev 新建一个分支 ignore （如果预测变更频繁就建立一个远程分支，现在一般都有模板，偶尔有个没有忽略的直接在dev分支上改就可以了）

更新忽略文件

尽快合并到\推送到 origin/dev 分支（避免两个组员同时更改该文件造成冲突。）

1.创建本地仓库

$ cd [项目路径]

$ git clone https://coding.net/tangyikejun/GitTest2.git

$ git checkout -u -b dev origin/dev

$ git checkout -b [MEMBER_NAME];

2.更新本地仓库

$ git add .

$ git commit -m”your comments”

       // …                                               // 多次提交后完成了一项新的功能，自己的分支下能正常运行

$ git checkout dev

$ git merge --no-ff [MEMBER_NAME]                       // [MEMBER_NAME] 是自己的分支名称

$ git push

3.更新 .gitignore 文件

$ git checkout dev

        //…                                               // 更新忽略文件

$ git add .

$ git commit -m“更新.gitignore文件”

$ git push

4.常用查询命令

$ git branch                                            // 查看自己所在分支 以及自己所拥有的分支

$ git log --pretty=“%h - %cn(%ci): %s” --graph          // 查看自己的提交记录

$ git reflog                                            // 查看自己的操作历史

$ git status                                            // 查看本地仓库当前的文件状态

$ git blame [FILE_PATH] 			                    // 查看文件的每一部分最后由谁改动

5.意外情况处理

意外：推送代码到远程 dev 分支时发生冲突。

解决方案：先把远程仓库的 origin/dev 分支拉取下来，解决冲突文件后再推送。平时的时候尽量避免不同组员更改同一个文件。

$ git push 

       // …                                               // 遇到错误

$ git pull

       // …                                               // 解决冲突

$ git add .

$ git commit -m”solve conflict:由于XX原因出错，修改XX文件解决问题”

$ git push

意外：不小心把自己的工作成果push到了master分支。

解决方案：先对master进行回退，再使用git push -f将错误的提交删除。

意外：错误地把文件添加到git仓库并推送到了远程。

解决方案：先将文件从git仓库中移除，但是保留工作目录中的对应文件。然后将该文件添加到忽略文件中，再重新进行提交。命令如下：

$ git rm --cached [FILE_PATH]

        …                                               // 将该文件添加到 .gitignore 文件

$ git add .

$ git commit -m"detach file XXX"

$ git push

三、预发布责任人 & 版本修复责任人

1.预发布责任人

当需要发布新的版本时，预发布责任人：

基于最新的 dev 分支创建一个 release-版本号分支
进行修缮工作
合并到 dev 分支
合并到 master 分支
打标签
删除 release-版本号分支

$ git checkout dev

$ git pull

$ git checkout -b release-1.2

        //…                                               // 进行修缮工作

$ git checkout dev

$ git merge --no-ff release-1.2

$ git checkout master

$ git merge --no-ff release-1.2                         // 在评论中写入相比上个版本新增的功能，修复的bug等详细内容

$ git tag v1.2

$ git branch -d release-1.2

使用 git show [TAG_NAME]可以查看标签对应的提交信息。

2.版本修复责任人

当新发布的版本发现 bug 时，版本修复责任人：

基于最新的 master 分支创建一个 hotfix-版本号分支
进行debug工作
合并到 master 分支
打标签
合并到 dev 分支
删除 hotfix-版本号分支

$ git checkout master

$ git pull

$ git checkout -b hotfix-1.2.1

        //…                                               // 进行修缮工作

$ git checkout master

$ git merge --no-ff hotfix-1.2.1

$ git tag v1.2.1

$ git checkout dev

$ git merge --no-ff hotfix-1.2.1                        // 在评论中写入修复的bug等详细内容

$ git branch -d hotfix-1.2.1

3.意外情况处理

意外：某组员完成自己的任务后合并到 dev 分支，推送时发现 release 分支的修缮工作更改了自己原来的文件，产生了冲突。

解决方案：把 origin/dev 分支拉取下来，将冲突解决后再次提交。(注意这里解决冲突后 master 分支上的文件与该组员的工作成果依旧是有冲突的。除非该组员解决冲突时不更改 relese 时的修缮代码，而仅仅更改自己的代码来解决问题。因此，一旦有冲突产生，最好双方进行合理交流达成一致意见。减少冲突。)

四、成员远程仓库

当某个团队成员希望其他成员协助完成他的编程任务时，该成员可以为自己的本地仓库创建一个远程仓库作为成员远程仓库，方便其他成员协助。建立成员远程仓库可以避免中心远程仓库的代码交流繁杂混乱。

成员远程仓库在在操作上是中心远程仓库的简化版。仅在细微处有所不同。

1.求助者

创建成员远程仓库
添加成员远程仓库
推送自己的分支到成员远程仓库的 master 分支
拉取成员远程仓库的 master 分支到自己的分支

$ git remote add [ALIAS_NAME] [GIT_ADRESS]

$ git push [ALIAS_NAME]  [BRANCH_NAME]:[BRANCH_NAME_REMOTE] 

$ git pull

举例：

$ git remote add binRepo https://coding.net/chenbin/GitTest2.git

$ git push binbin  binRepo:master                               //由于是第一次推送，该操作已经使得分支binbin 跟踪了远程分支 binRepo/mastr

当某个分支 a 跟踪了远程分支 b，即 b 成为 a 的默认拉取来源，也因此，一个本地分支同一时间只能跟踪一个远程分支。

让本地某分支跟踪远程分支的命令

$ git branch -u [REPO_NAME]/[REMOTE_BRANCH_NAME] [BRANCH_NAME]

// git branch -u binRepo/master binbin

2.协助者

克隆成员远程仓库
在 master 分支基础上创建自己的分支 member*
在自己的分支上修改代码
合并到 master 分支后推送到成员远程仓库

$ git clone https://coding.net/chenbin/GitTest2.git

$ git checkout -b member1;

        //…                                                       //修改代码

$ git add .

$ git commit -m"我帮你把XX功能完成了"

$ git checkout --no-ff merge member1;

$ git push