使用git在项目中的一些经验

近期在使用gitLab管理项目，在使用过程中遇到一些问题，在此整理一下。

git的基本配置在这里就不累赘了，主要讲一下如何将项目托管到gitLab ，并实现多人协作开发。尤其介绍一下如何解决冲突，合并分支。

1、将代码上传至gitLab

1. 首先在gitLab 上创建一个仓库，在本地代码目录下，执行git init使之成为一个git仓库。也可能本身就已经是一个git仓库了。
2. 使用git remote -v查看当前仓库绑定的远程仓库。（-v参数可以查看远程主机的网址）

$ git remote -v
origin  git@github.com:jquery/jquery.git (fetch)
origin  git@github.com:jquery/jquery.git (push)

上面的命令表明，当前只有一台远程主机，叫做origin，以及它的网址。
3. git remote add 主机名 网址用于添加远程主机

git remote add origin git@192.168.1.11:ygc/190319test.git
ygc@ygc:~/190319Test$ git remote -v
origin	git@192.168.1.11:ygc/190319test.git (fetch)
origin	git@192.168.1.11:ygc/190319test.git (push)

4. git remote rm 主机名用于删除指定主机名的远程主机，（主机名一般默认为origin）

git remote rm origin

5. git remote rename修改远程主机名

git remote rename  <原主机名>   <新主机名>

6. 接下来就是git add .与git commit -m "说明文字"
7. 最后推送到远程主机git push <远程主机名> <本地分支名> ：<远程分支名>

如果省略远程分支名，则表示将本地分支推送与之存在"追踪关系"的远程分支（通常两者同名），如果该远程分支不存在，则会被新建。

git push origin master

上面命令表示，将本地的master分支推送到origin主机的master分支。如果后者不存在，则会被新建。

2、创建分支，用于多人开发

现在仓库中只有一个主分支master。为了多人协作开发，需要在gitLab上设置添加members。一般只有管理者是Maintainer权限。参与者一般Developer 权限。

主分支master是protected权限，Developer权限的参与者无法对其修改。这也保护了master主分支，一般参与者不能修改master主分支。

解决办法是再创建一个分支（在这里我定义分支名为dev）,所有参与者共用这一个分支dev，所有的修改都在这个分支dev上，在确保无误的前提下，由管理员在gitLab上合并到主分支master上。

通过建立一个分支dev的方式开发能保证代码的稳定性，master主分支只有管理员有权限修改，所有参与者开发dev分支，当测试确定dev分支准确无误后，由管理员不定期将dev合并到master主分支上。

具体实现：

1. 由管理员（也不一定是管理员，只要有一个人创建，大家共同使用）创建dev分支

ygc@ygc:~/onos$ git checkout -b dev
Switched to a new branch 'dev'
ygc@ygc:~/onos$ git branch
* dev
  master

上面代码的意思是通过git checkout -b dev创建一个新的dev，并且将当前分支指向dev。git branch查看所有分支，当前分支标有*号。
2. 通过git push origin dev将分支dev推送到远程主机

ygc@ygc:~/onos$ git checkout -b dev
Switched to a new branch 'dev'
ygc@ygc:~/onos$ git branch
* dev
  master
ygc@ygc:~/onos$ git push origin dev
Total 0 (delta 0), reused 0 (delta 0)
remote: 
remote: To create a merge request for dev, visit:
remote:   http://59d1500fe2bd/sangfor/onos/merge_requests/new?merge_request%5Bsource_branch%5D=dev
remote: 
To git@192.168.1.11:sangfor/onos.git
 * [new branch]      dev -> dev
ygc@ygc:~/onos$ 

此时远程主机上也存在两个分支了

3. 当其他参与者参与开发时，他需要从远程库clone，默认情况下，他只能看到本地的master分支。

ygc@ygc:~/190319Test/test77$ git clone git@192.168.1.11:sangfor/onos.git
Cloning into 'onos'...
remote: Enumerating objects: 17295, done.
remote: Counting objects: 100% (17295/17295), done.
remote: Compressing objects: 100% (7853/7853), done.
remote: Total 17295 (delta 6372), reused 17295 (delta 6372)
Receiving objects: 100% (17295/17295), 33.69 MiB | 10.13 MiB/s, done.
Resolving deltas: 100% (6372/6372), done.
Checking connectivity... done.
ygc@ygc:~/190319Test/test77$ cd onos
ygc@ygc:~/190319Test/test77/onos$ git branch
* master

4. 现在，他要在dev分支上开发（即使他在master主分支上开发，他也没有权限推送到远程库中），就必须创建远程origin的dev分支到本地：

ygc@ygc:~/190319Test/test77/onos$ git checkout -b dev origin/dev
Branch dev set up to track remote branch dev from origin.
Switched to a new branch 'dev'
ygc@ygc:~/190319Test/test77/onos$ git branch
* dev
  master

5. 现在，他就可以在dev上继续修改，然后时不时地把dev分支push到远程

git add .
git commit -m "tag"

git push origin dev

3、获取最新代码到本地，并自动合并到当前分支，推送到远程库

有一些文章说git pull不好，建议使用git fetch和git merge，可以考虑使用这两个命令替代git pull

当一个参与者在本地开发期间，远程库如果被被的开发着push过，这当这个参与者执行git push origin dev时可能会出现：

$ git push origin dev
To github.com:michaelliao/learngit.git
 ! [rejected]        dev -> dev (non-fast-forward)
error: failed to push some refs to 'git@github.com:michaelliao/learngit.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

从上面代码可以看出，Git 已经提示我们，先用git pull把最新的提交从origin/dev上抓下来，然后，在本地合并，解决冲突，再推送：

$ git pull
There is no tracking information for the current branch.
Please specify which branch you want to merge with.
See git-pull(1) for details.

    git pull <remote> <branch>

If you wish to set tracking information for this branch you can do so with:

    git branch --set-upstream-to=origin/<branch> dev

git pull也失败了,原因是没有指定本地dev分支与远程origin/dev分支的链接，根据提示，设置dev和origin/dev的链接：

$ git branch --set-upstream-to=origin/dev dev
Branch 'dev' set up to track remote branch 'dev' from 'origin'.

然后在git pull。

$ git pull
Auto-merging env.txt
CONFLICT (add/add): Merge conflict in env.txt
Automatic merge failed; fix conflicts and then commit the result.

这回git pull成功，但是合并有冲突（如果没有冲突，就可以执行下一步了），需要手动解决（找到冲突的地方，确定最终版本）。

解决完冲突后，再次git add.、git commit -m "提示语"、git push origin dev

4、解决冲突

产生冲突的原因是当你在本地开发过程中，其他开发者向远程库有了新的提交。当你把最新的远程库拉到本地后，会对比现在的远程库的版本与你最后一次从远程看拉下来的版本。

5、将dev合并到master上

这个过程是在gitLab 上进行，不再细说。