从最简单的git使用场景学习git协同开发

从最简单的git使用场景学习git协同开发

引言

本文是一个初学者经过学习的一些总结，仅供大家参考。有什么问题随时欢迎大家指出，互相讨论，共同进步。

场景

团队合作完成一篇论文。假设有一位老师Alan，一位学生Mike。老师Alan负责修改学生Mike的论文并提出指导意见。学生Mike负责写论文并根据老师意见不断添加内容。

思路

先思考一个问题，一个好的规范是怎样的？master分支用于远程仓库中稳定版本发布，dev分支用于开发人员提交到远程仓库时一个开发版本的提交。具体说明如下：远程仓库可设两个分支master与dev。dev branch专门进行主要的开发，master branch作为存放稳定的release版本的分支。本地提交到dev分支前，可先pull远程仓库中的dev分支，进行冲突解决与合并后，再push到dev分支。本地的分支可以稍多一些：如feature分支作为新文件新功能的提交，bug分支用于快速修复bug。

操作与说明

part1 Alan完成仓库的初始化工作

1. github 上新建名为gitLearn远程仓库，建好后是空的。（github官网）

2. 本地D盘新建两个文件夹Alan、Mike。模拟二人协同开发。

    mm@Lenovo-PC MINGW64 /d/gitFolder1/gitLearn
    $ mkdir Alan
    mm@Lenovo-PC MINGW64 /d/gitFolder1/gitLearn
    $ mkdir Mike
   

3. Alan初始化本地库，命令如下，新建文档与实验的文件夹以及模板（新建过程略）：

    $ git init
   

   新建的文件添加到暂存区：

    $ git add  report/lab.md
   

   进行第一次提交：

    $ git commit -m "the first version"
   

4. Alan将本地库与第1步建好的远程库进行关联，git@github.com:NoraLigithub/gitLearn.git（该链接是作者的远程库链接你可以修改为自己的，在自己的github上查看新建的远程库找到该链接。）

    $ git remote add origin git@github.com:NoraLigithub/gitLearn.git
   

   本地添加dev分支

    $ git checkout -b dev
   

   dev分支修改文件建立文件夹（命令略，该部分可以新建一些文档代码模板等，注意新建的空文件夹不会push到远程仓库，若想push空文件夹请参考add an empty folder中提供的方法），下一步是将dev分支push到远程库中。以下命令的含义是建立远程分支origin dev并将本地dev分支push。具体可参考 git分支

    $ git push origin dev:dev
   

part2 Mike获取远程仓库开始自己的工作

1. 直接获取远程仓库

    $ git clone git@github.com:NoraLigithub/gitLearn.git
   

2. 这时候你查看一下分支会发现只有一个master分支，没有dev分支。这是需要你手动关联的。下一个命令就是创建一个dev分支并与远程仓库中的dev分支关联，回顾part1中创建分支并跳转的命令，你会发现多了origin/dev表示与远程库关联。再与part1的最后一个命令比较，他们是不一样的。

    $ git checkout -b dev origin/dev
   

3. 完成自己的工作文档修改。这里建议Mike可以建立feature分支作为功能点的开发分支。同时可以在master分支中完成文档的结构完善，而在feature中完成细小功能点的添加。在这里完成的第一个feature是需求分析，取名为Requirement

    $git checkout -b Requirement
   

4. 修改文档lab.md，可随时add与提交以确保工作的保存。（略）

5. 修改工作告一段落准备将两个分支合并，返回dev分支后进行合并。如果出现冲突按照提示修改相关文件并提交即可。建议使用--no-ff参数进行合并，因为这样会有分支合并的记录。不加该参数则看不到分支合并的记录。

    $git branch dev
    $ git merge --no-ff -m "merge with no-ff" Requirement
   

6. 终于完成修改工作了，Mike想把自己的工作push到远程库中。一个建议是Mike可以先进行pull再进行push，这样做的原因是可以在push前解决冲突。在该情境中Alan可能对之前的文档模板做了一些修改，而Mike自己也做了一些修改。以下命令的含义是pull远程库中的dev分支（不要只写pull，写清楚分支名）

    $ git pull origin dev
   

   如果有冲突解决之（解决的含义是手动修改冲突文件），接下来就可以愉快地push啦，同理要写清楚远程仓库的分支名

    $ git push origin dev
   

part3 Alan与Mike的进一步工作

1. 每次开始工作前都可以pull一下dev分支，获取对方最新的工作进展，命令见上

            $ git fetch
            $ git pull origin dev
   

2. 每次有新功能点开发都可以本地新建一个分支，该分支不push到远程仓库中

3. Mike如果不小心关联错远程仓库或者他突然退学了不工作了，他应该如何移除本地仓库与远程仓库的连接呢？origin是我们之前起的名字。

            $ git remote remove origin
   

4. 将当前分支与远程分支相关联的命令

            $ git branch --set-upstream-to=origin/master
   

一些补充

1. 常见的查询状态命令：查看提交记录的命令

    $ git log
   

   查看工作区暂存区状态的命令

    $ git status
   

   查看分支情况的命令

    $ git branch
   

2. 作者喜欢的git学习参考资料

   • 廖雪峰的git教程
   • 介绍一个成功的git分支模型
   • git分支

3. 多人合作大同小异，深入的学习可以参考作者给出的链接。这是我的第一篇技术博客，感谢阅读<(￣︶￣)>。欢迎指出我的问题，互相交流，共同进步。