GitHub团队项目合作流程

落日映苍穹つ 2022-07-17 01:18 154阅读 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#first
[Link 3]: http://www.cnblogs.com/schaepher/p/4933873.html#second
[Fork]: http://www.cnblogs.com/schaepher/p/4933873.html#third
[Clone]: http://www.cnblogs.com/schaepher/p/4933873.html#four
[Link 4]: http://www.cnblogs.com/schaepher/p/4933873.html#five
[push]: http://www.cnblogs.com/schaepher/p/4933873.html#six
[Link 5]: http://www.cnblogs.com/schaepher/p/4933873.html#seven
[Link 6]: http://www.cnblogs.com/schaepher/p/4933873.html#eight
[809218-20151103173652383-2141612893.png]: /images/20220717/905a844ab5554cd0a47d406db4f04b25.png
[809218-20151103173701977-299176036.png]: /images/20220717/400223f0828d47e48ad7c79c4a6f69d7.png
[809218-20151103173718133-151518132.png]: /images/20220717/7d0b29eaf56c42bc90f8f4ae72096a06.png
[809218-20151103173728117-1181892624.png]: /images/20220717/932e54d3adad4d93a788b7e3688b799c.png
[809218-20151103173734758-2060034854.png]: /images/20220717/04445a5b44fd40e28ba185122c5d51af.png
[809218-20151103173744086-1895687789.png]: /images/20220717/bde06198ce764de6a9c5033e48559693.png
[809218-20151103173754508-232839332.png]: /images/20220717/053575c94c364659acfe9e5d7739fc02.png
[809218-20151103173804774-901439442.png]: /images/20220717/580e43c27c7c41f1812e61a4261c0316.png
[809218-20151103173815383-1352448645.png]: /images/20220717/aabd8888454c4a27b7fd06115d43d8a3.png
[809218-20151103173823883-310889332.png]: /images/20220717/779a18402bd544b7888c0bb14e26baca.png
[809218-20151103173833321-842340487.png]: /images/20220717/c80b5cc774ee4705b2cd36ad46fce818.png
[Link 7]: http://www.cnblogs.com/schaepher/p/4970291.html#conflict
[809218-20151103173844258-889781053.png]: /images/20220717/94dc419225dc4aed94b562ad96a14b75.png
[809218-20151103173852555-1275593404.png]: /images/20220717/ff99473dbaca499eb4d6f8aae9fffe71.png
[809218-20151103173859774-105197351.png]: /images/20220717/d57609014df54533b91835364fe84de7.png
[809218-20151103173927555-1477286515.png]: /images/20220717/f3501ce0dc1942a5bf770690da5ec485.png
[809218-20151103173935789-846829992.png]: /images/20220717/3e32eb487f7e4068b1a5ae581133f6a2.png
[809218-20151103173942977-1760127709.png]: /images/20220717/d64b41831d3e4722a472731abe6485c5.png
[809218-20151103173949711-1666366145.png]: /images/20220717/83a6a6ebe862474ab4362a30cc64d892.png