常用工具说明--GitHub团队项目合作流程

注：其中 零、一、七 是由团队项目负责人来完成的。开发人员只要从 二 开始就行了。

---

零、前期准备：

首先把队友直接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。这样就合并好了。