git summary
Git 使用经验
缘起
一直想写一篇博文,记录我在使用git时遇到的问题以及解决办法。由于项目忙,偶尔的记录不连续,不成系统。今天有时间记录下来,方便自己以后查看。
git 简介及其优势
简单来说,git是类似csv, svn一类的版本控制工具,不过它是分布式的。
总结一下它的优点:
- 适合分布式开发,强调个体。
- 公共服务器压力和数据量都不会太大。
- 速度快、灵活。
- 任意两个开发者之间可以很容易的解决冲突。
- 离线工作。
难道它没有缺点么?有的:
- 代码保密性差,一旦开发者把整个库克隆下来就可以完全公开所有代码和版本信息。
- 部分童鞋反应比较难学
gitlab是神马?github又是神马?
说到git, 经常听到的一个词莫过于github, github是一个网站,它提供Git仓库托管服务,用户可以在上面创建各种git仓库,同时,它提供一个web界面,使得用户方便管理自己的项目。
但用户托管私有项目时需要付费,这时,你可以使用 gitlab 创建属于自己的 github。
GitLab是一个开源的版本管理系统,实现一个自托管的Git项目仓库,也可通过Web界面进行访问公开的或者私人项目。
git 一般工作流程
git是分布式版本控制系统,其最大的优势是,每个开发者拥有存相同的代码拷贝。
实际项目开发中,通常需要创建一个远程仓库,这个远程仓库有点类似SVN中央服务器,项目开发中所有的代码都统一提交到该远程仓库中,这方便代码的统一管理。
这个远程仓库通常由gitlab 或者 github托管。
如何新建版本库(仓库)?
首先,你在gilab 或者 github 上新建一个远程仓库(new repository);
创建完成后,会给出该远程仓库的地址:例如git@github.com:xxx/test1.git
然后再在本地创建仓库:
echo "# test" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:xxx/test1.git
git push -u origin master
注意,当运行最后一条命令时,可能提示错误:
The authenticity of host 'github.com (192.30.252.129)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.252.129' (RSA) to the list of known hosts.
Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
不要慌,这是因为git使用ssh进行通信,本地主机向远程主机推送文件时,需要告诉对方自己的ssh publickey.
- 首先,本地创建ssh-key
ssh-keygen -t rsa -C "example@foxmail.com"
- 然后拷贝~/.ssh/id_rsa.pub中的公开密钥到github('edit profile' -> 'SSH and GPG keys')
重新提交后出现下面提示方为成功。
$ git push -u origin master
Counting objects: 3, done.
Writing objects: 100% (3/3), 208 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@github.com:xxx/test1.git
- [new branch] master -> master
Branch master set up to track remote branch master from origin.
现在回过头来重新看一下创建本地仓库那几条命令。
git init
命令用于将当前目录变成git可管理的仓库。创建成功后,当前目录下会多出一个目录.git,
这个目录是Git来跟踪管理版本库的,所以千万不能删除;
git add
命令是将文件 添加 到仓库;
git commit
命令是将文件 提交 到仓库,参数-m 指示本次提交说明。
为什么
git add
之后又要git commit
? 它们有什么区别?
这里需要说明下git的结构:
执行git init
命令的那个目录,也就是.git 所在的目录,通常称为工作区,
而目录.git不算工作区,而是Git的版本库。
版本库中有很多东西,其中有个区叫暂存区(index),git add
把文件添加进去,实际上就是把文件修改添加到暂存区。
而git commit
提交更改,实际上就是把暂存区的所有内容提交到当前分支。至于什么是分支,后面会讲到。
可以验证下刚刚说的,方法是通过git status
命令。
修改一个文件文件之后,运行git add
, 然后执行git status
,
git status 会告诉你目前你修改了那些文件,它是与版本库中当前分支比较的结果,例如
$ git status
On branch dev
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
modified: README.md
再次运行git commit
之后,git status
告诉你没有修改,这说明git commit
将你的修改实实在在提交到版本库了。
$ git status
On branch dev
nothing to commit, working directory clean
不过,修改并没有推送到远程仓库,如果要同步远程仓库,还需要执行git push
命令。
git remote add origin git@github.com:xxx/test1.git
命令是将本地库与远程库进行关联,远程库默认名称为origin
;
git push -u origin master
命令是第一次推送master分支的所有内容,以后推送就无需添加参数 -u 了。
如何拷贝远程仓库内容到本地呢?
上面讲到从零开始创建本地仓库再与远程库关联,如果远程库已经有内容了,如何将其内容拷贝到本地呢?
即拷贝一个仓库,通常一条命令就可以搞定。
git clone git@github.com:xxx/test1.git
git分支管理
到目前为止,我们还没有创建任何分支, 当然master分支是创建仓库是默认自动创建的。
master分支是一个稳定的分支,一般只有经过测试的稳定版或者里程碑版本才被允许合并到master分支。
先来看看如何创建新的分支;
git checkout -b dev
或者
git branch dev
第一个命令的意思是创建一个新分支dev,并且* 切换 *到该分支下。
第二个命令只创建了新分支,但并没有切换分支。那么何为切换呢?
因为git需要知道你要操作的分支,那么多分支,它通过什么判别你要操作的分支呢?
git有一个HEAD指针,用它来指向当前待操作的分支。
要了解当前操作的分支,直接运行git branch
即可:
$ git branch
* dev
master
test
分支前带星号的就是当前分支,也就是HEAD所指向的分支。
切换分支:
git checkout branch_name
合并分支:
比如要将dev 分支合并到master 分支:
git checkout master #切换到master分支首先
git merge --no-off -m "balbal" dev
参数--no-off表示禁用fast-forword。为什么要禁止?因为这种模式下,删除分支后,会丢掉分支信息。
git在团队协作中怎样运用?
一般的,项目有一个稳定的分支master以及开发分支dev;
master分支用来保存比较稳定的版本,比如里程碑版本,dev是一个比较活跃的分支,所有开发者的提交都首先merge到dev分支。
团队中每个人有一个分支,比如张三一个分支,李四一个分支,所有开发者的分支都和dev分支建立链接关系:
git branch --set-upstream-to=origin/dev zhangsan
上述命令的意思是将本地分支zhangsan与远程分支dev进行关联,这样做的好处是,每次用户修改之前,可以先运行
git pull
命令将dev上的最新修改拉取到本地分支,这样可以有效减少冲突。
如果你有多个分支,在一个分支上开发到一半(并没有提交),这时候有转向另一个分支,
会提示如下信息:
$ git checkout test
error: Your local changes to the following files would be overwritten by checkout:
README.md
Please, commit your changes or stash them before you can switch branches.
Aborting
没关系,如果你不想提交修改,没关系,运行git stash
,该命令的意思是先把当前工作现场隐藏起来,等以后恢复现场后继续工作。
$ git stash
Saved working directory and index state WIP on dev: 3b86461 add a new line
HEAD is now at 3b86461 add a new line
$ git stash list
stash@{0}: WIP on dev: 3b86461 add a new line
那怎么恢复呢?通过命令git stash pop
,
$ git stash pop
On branch dev
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
Dropped refs/stash@{0} (ca81919d1e48fb73c1cca80f52e3408ca61ae70d)
通过git status
验证:
$ git status
On branch dev
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
冲突了怎么办?
有时候害怕什么来什么,merge的时候提示冲突了怎么办?比如下面, 分支test 和 分支dev修改了同一行。
$ git merge test
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Automatic merge failed; fix conflicts and then commit the result.
首先可以通过git status 查看产生冲突的文件。
$ git status
On branch dev
You have unmerged paths.
(fix conflicts and run "git commit")
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
打开冲突文件,可以看到一些花花绿绿的特殊的符合,比如:
hi
world
yes, you are right
<<<<<<< HEAD
add by dev
=======
add by test branch
>>>>>>> test
git 用 <<<<<<<, =======, >>>>>>>来区分不同分支的修改。删除这些,保存你想要的,就可以了,例如:
hi
world
yes, you are right
add by dev and test branch
再次提交就可以了。