Github使用（3）-GitHub团队项目合作流程

太过爱你忘了你带给我的痛 2022-06-14 22:17 163阅读 0赞

已在另一篇博客中写出关于以下问题的解决，[点此进入][Link 1]：

*  同步团队项目到本地时出现冲突怎么办？
 *  项目负责人merge一个Pull Request后发现有错怎么回退？

## 目录： ##

*  [零、前期准备][Link 2]  
    
 *  [一、创建开发分支][Link 3]  
    
 *  [二、Fork项目到个人的仓库][Fork]  
    
 *  [三、Clone项目到本地][Clone]  
    
 *  [四、和团队项目保持同步][Link 4]
 *  [五、push修改到自己的项目上][push]
 *  [六、请求合并到团队项目上][Link 5]
 *  [七、团队项目负责人审核及同意合并请求][Link 6]

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

--------------------

### 零、前期准备： ###

首先把队友直接push的权限关掉，即设置成Read。这样可以防止队友误操作，未经审核就把代码push到团队项目上。  
Teams用来分配issue的时候会用到，所以保留下来，并不是没有用。

![809218-20151103173652383-2141612893.png][]

### 一、创建开发分支 ###

master分支一般用来发布稳定版本，dev分支（开发分支）用来发布开发版本。  
输入分支名称后，下面会跳出Create branch，点击即可创建。

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

![809218-20151103173701977-299176036.png][]

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

![809218-20151103173718133-151518132.png][]

### 二、Fork项目到个人的仓库 ###

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

![809218-20151103173728117-1181892624.png][]

Fork完成后

![809218-20151103173734758-2060034854.png][]

### 三、Clone项目到本地 ###

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

> 推荐使用SSH协议，用HTTP协议有时会出问题。  
> 注意，这里clone的是你自己仓库里的项目

![809218-20151103173744086-1895687789.png][]

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

![809218-20151103173754508-232839332.png][]

此时你只能看到master分支，并没有把dev分支clone下来。使用 `git branch` 命令查看本地分支，发现本地只有master分支。如下图的①

![809218-20151103173804774-901439442.png][]

如上图的②，使用 `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` 即可。

![809218-20151103173815383-1352448645.png][]

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

### 四、和团队项目保持同步 ###

首先查看有没有设置upstream，使用 `git remote -v` 命令来查看。如下图①

![809218-20151103173823883-310889332.png][]

如果没有显示upstream，则使用 `git remote add upstream 团队项目地址` 命令。如上图②  
接着再次使用 `git remote -v` ，如果如上图③，显示出了upstream，那么就设置好了

开始同步。首先执行 `git fetch upstream` 获取团队项目最新版本。如下图①

![809218-20151103173833321-842340487.png][]

此时并没有把最新版本合并到你本地的分支上，因此还需要一步。如上图②，当前分支是dev分支，执行 `git merge upstream/dev` 命令后，会将源分支（upstream/dev）合并到当前分支（dev）。

> 如果你是在本地的master分支上开发，那么在使用该命令前，先切换到master分支。  
> merge的时候，有可能碰到冲突。需要解决冲突才能继续下面的操作。冲突的解决可以参考→ [冲突的解决][Link 7]

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

解决冲突后，就可以使用 `git push` 命令将本地的修改同步到自己的GitHub仓库上了。

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

![809218-20151103173844258-889781053.png][]

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

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

![809218-20151103173852555-1275593404.png][]

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

![809218-20151103173859774-105197351.png][]

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

![809218-20151103173927555-1477286515.png][]

以上操作结束后，团队成员的流程就结束了。最后一步交给团队项目负责人来完成。

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

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

![809218-20151103173935789-846829992.png][]

选择一个Pull request

![809218-20151103173942977-1760127709.png][]

项目负责人审核有两个要注意的地方

*  一个是下图的①。一定要看清楚是合并到哪个分支。这里是从schaepher的dev分支合并到fzu2015的dev分支。
 *  另一个是下图的②。点击进去后，就可以查看该Pull request对项目做了哪些修改。这样如果有问题，可以及时发现，并关闭该Pull request。
    
    > 如果关闭了，一定要告诉队友，否则他可能会不知道。虽然也可以直接在下面发布Comment告诉他，但队友不一定看到。
    
    ![809218-20151103173949711-1666366145.png][]
 *  如果没有问题，可以点击Merge pull request。这样就合并好了。

[Link 1]: http://www.cnblogs.com/schaepher/p/4970291.html
[Link 2]: http://www.cnblogs.com/schaepher/p/4933873.html#setup
[Link 3]: http://www.cnblogs.com/schaepher/p/4933873.html#dev_branch
[Fork]: http://www.cnblogs.com/schaepher/p/4933873.html#fork
[Clone]: http://www.cnblogs.com/schaepher/p/4933873.html#clone
[Link 4]: http://www.cnblogs.com/schaepher/p/4933873.html#fetch
[push]: http://www.cnblogs.com/schaepher/p/4933873.html#push
[Link 5]: http://www.cnblogs.com/schaepher/p/4933873.html#pull_request
[Link 6]: http://www.cnblogs.com/schaepher/p/4933873.html#review
[809218-20151103173652383-2141612893.png]: /images/20220615/459a432390ef4cc7bcb8b72256bcff5e.png
[809218-20151103173701977-299176036.png]: /images/20220615/650f45585a7449a289d71fce270165b6.png
[809218-20151103173718133-151518132.png]: /images/20220615/cf908ad5a6e64681832e398532a53bc6.png
[809218-20151103173728117-1181892624.png]: /images/20220615/dbc1b8e5ceec4d689ef95af3a0d20f95.png
[809218-20151103173734758-2060034854.png]: /images/20220615/d05ad964494645c8864f3242809fe1b6.png
[809218-20151103173744086-1895687789.png]: /images/20220615/3a6132e3da1a43bdaa59d4914c5f5d40.png
[809218-20151103173754508-232839332.png]: /images/20220615/c951e305a4564200b1798a8f426806f2.png
[809218-20151103173804774-901439442.png]: /images/20220615/b0c6172e49734dea97f0baeee6049413.png
[809218-20151103173815383-1352448645.png]: /images/20220615/8e804f4c73cf465086ea5b3ee5c97327.png
[809218-20151103173823883-310889332.png]: /images/20220615/d7a12c934a4f4e789091640ae8c29c8a.png
[809218-20151103173833321-842340487.png]: /images/20220615/afd3fd81e8fd4691a7ca8f22f4ff25ed.png
[Link 7]: http://www.cnblogs.com/schaepher/p/4970291.html#conflict
[809218-20151103173844258-889781053.png]: /images/20220615/e2efaaace4e744409bdd1e492577938a.png
[809218-20151103173852555-1275593404.png]: /images/20220615/803a8bd8bae34bacadd363115843d92d.png
[809218-20151103173859774-105197351.png]: /images/20220615/703bd8993a63434f948e7595768e1d39.png
[809218-20151103173927555-1477286515.png]: /images/20220615/8cf099aeea3d4004bac0ee15aa6b1ead.png
[809218-20151103173935789-846829992.png]: /images/20220615/e1eb9f1c697143da86d2418ddd0a911a.png
[809218-20151103173942977-1760127709.png]: /images/20220615/f0573ac9336f4fdf90e39e82f0fdc68f.png
[809218-20151103173949711-1666366145.png]: /images/20220615/1114f080de6b4d9cb1335ca8936c408d.png