GitHub团队项目合作流程

已在另一篇博客中写出关于以下问题的解决，点此进入：
同步团队项目到本地时出现冲突怎么办？
项目负责人merge一个Pull Request后发现有错怎么回退？

目录：

零、前期准备

一、创建开发分支

二、Fork项目到个人的仓库

三、Clone项目到本地

四、和团队项目保持同步
五、push修改到自己的项目上
六、请求合并到团队项目上
七、团队项目负责人审核及同意合并请求

注：其中 

零、一、七

 是由团队项目负责人来完成的。开发人员只要从 

二

 开始就行了。

零、前期准备：

首先把队友直接push的权限关掉，即设置成Read。这样可以防止队友误操作，未经审核就把代码push到团队项目上。

Teams用来分配issue的时候会用到，所以保留下来，并不是没有用。

一、创建开发分支

master分支一般用来发布稳定版本，dev分支（开发分支）用来发布开发版本。

输入分支名称后，下面会跳出Create branch，点击即可创建。

下面图片写的是develop，是因为我们这个项目已经有dev分支了。如果你们没有dev分支，那么名字改成dev即可。这个影响不大。



分支创建完毕后，会自动跳转到dev分支。由于dev分支是从master分支上创建的，因此内容与master分支一致。

二、Fork项目到个人的仓库

点击右上角的Fork，并选择你的账号（一般在第一个）。就可以Fork团队项目到个人仓库啦。



Fork完成后

三、Clone项目到本地

首先是clone，clone的地址可以直接点击按钮复制（如下图）。

推荐使用SSH协议，用HTTP协议有时会出问题。

注意，这里clone的是你自己仓库里的项目



打开git命令行，输入指令和刚才复制的地址，回车即可克隆到本地



此时你只能看到master分支，并没有把dev分支clone下来。使用 

git
branch

 命令查看本地分支，发现本地只有master分支。如下图的①



如上图的②，使用 

git
branch -a

 查看所有分支，就能看到远程分支。

根据远程分支，我们可以创建一个新的本地分支dev，并把该项目的dev分支的内容放到本地dev分支。如上图③。

git
checkout -b dev origin/dev

 的意思是，创建一个dev分支（-b），并把远程dev分支（origin/dev）的内容放在该分支内。接着切换到该分支（checkout）

现在使用 

git
branch

 可以查看两个分支，并且用 

ls

 或者 

dir

 就能看到dev分支的内容了。想切换回master分支的时候，再用 

git
checkout master

 即可。



上面的操作完成后，你就可以在本地进行开发了。但是如果要将你修改完的代码合并到团队项目上，还需要进行下面的操作。

四、和团队项目保持同步

首先查看有没有设置upstream，使用 

git
remote -v

 命令来查看。如下图①



如果没有显示upstream，则使用 

git
remote add upstream 团队项目地址

 命令。如上图②
接着再次使用 

git
remote -v

 ，如果如上图③，显示出了upstream，那么就设置好了
开始同步。首先执行 

git
fetch upstream

 获取团队项目最新版本。如下图①



此时并没有把最新版本合并到你本地的分支上，因此还需要一步。如上图②，当前分支是dev分支，执行 

git
merge upstream/dev

 命令后，会将源分支（upstream/dev）合并到当前分支（dev）。

如果你是在本地的master分支上开发，那么在使用该命令前，先切换到master分支。

merge的时候，有可能碰到冲突。需要解决冲突才能继续下面的操作。冲突的解决可以参考→ 冲突的解决

五、push修改到自己的项目上

解决冲突后，就可以使用 

git
push

 命令将本地的修改同步到自己的GitHub仓库上了。

注意，在当前所在分支使用push，会push到与这个分支相关联的远程仓库分支。这里dev分支与origin/dev关联，因此push到GitHub上的dev分支。

六、请求合并到团队项目上

首先到你的GitHub上，进入你Fork的仓库里。点击红框处的Pull request



下图左边红框，表示要合并到fzu2015/CourseManagement项目的dev分支。
下图右边红框，表示要从自己仓库的dev分支发起合并请求。
点击红框处的 Create pull request就可以发送合并请求了。



当然，在发送请求之前，你可以检查一下你都改了哪些东西。在上面那个页面往下拉，就可以看到两者的对比。如下图



以上操作结束后，基本已经好了。

七、团队项目负责人审核及同意合并请求

首先进入GitHub的团队项目仓库中。此时右边的Pull requests显示当前项目有几个Pull request。点击进入查看。



选择一个Pull request



项目负责人审核有两个要注意的地方
一个是下图的①。一定要看清楚是合并到哪个分支。这里是从schaepher的dev分支合并到fzu2015的dev分支。

另一个是下图的②。点击进去后，就可以查看该Pull request对项目做了哪些修改。这样如果有问题，可以及时发现，并关闭该Pull request。

如果关闭了，一定要告诉队友，否则他可能会不知道。虽然也可以直接在下面发布Comment告诉他，但队友不一定看到。



如果没有问题，可以点击Merge pull request。这样就合并好了。