git日常使用指南

Git是使用广泛的分布式版本控制系统。版本控制，简单讲就是记录文件变更历史。使用Git可以处理很小到很大的项目版本管理，小到一个文件，大到巨量文件集合的项目。

我最初使用git来管理自己的笔记和文章。现在GitHub有免费的私有仓库可以使用，对一些基本操作熟悉后不比坚果云繁琐多少，却更加掌控全局。

git安装

Linux一般自带git。使用git --version查看是否安装。如果没有安装使用Linux发行版相应的包管理器进行安装，比如Debian系：sudo apt install -y git。

Windows、Mac需要从Git官网下载安装包，然后一路默认选项安装即可。Mac也可以使用homebrew进行安装。homebrew类似Debian下的apt，是Mac下的包管理工具。

安装好Git，需要进行一点配置就可以使用。简单讲就是设置本台计算机身份：

git config --global user.name "your name"
git config --global user.email "your email"

此后，没有额外设置的话，该设备进行的git操作都会标记上面身份信息。

创建版本库

mkdir gitTest
cd gitTest
git init

以上三个命令分别完成创建gitTest目录，进入该目录，在该目录下创建版本库。版本库存放在.git目录下，是git记录gitTest目录所有文件变更的仓库。

仓库添加文件

在gitTest目录下新建一个本文文件，随便编辑下。

第一步，添加这个文件到缓存区，git add new.txt。

第二步，提交到版本库并备注，git commit -m 'a new text'。

将add 与 commit 分离，一次commit可以针对多次add。

随时掌握文件动态

在gitTest下工作时，可以随时使用git status查看仓库的状态。该命令可以显示有哪些文件修改了，需要add、commit。

git diff fileName，可以查看该文件修改的具体内容。其显示格式与Linux下diff工具相似。在add后就不能查询了。

需要注意的，是git只跟踪仓库里文件变化。

版本控制

使用git log可以查看提交历史。记录内容有版本号（哈希值表示）、提交者、提交时间、commit信息。

在最新的版本库状态有“（HEAD -> master）”标识，HEAD表示文件现在的状态，master表示工作分区，工作分区一般在master上，后面再详细讲分区使用。

退回上一个版本，git reset --hard HEAD^，或者git reset --hard 版本号。命令中版本号写前几位就可以，Git会自动匹配。

如果想前进版本（后悔回退了），又不知道版本号，使用git reflog查看所有变更记录。

git的区域

git有三个区域，当前文件所在的目录是工作区，版本库.git目录包含暂存区（stage）和分支（master）。

工作区的文件先被修改，通过add命令进入暂存区，暂存区commit后就保存在当前分支。这三个区文件状态都可以回退。

• 工作区修改乱了，想放弃所有修改：git checkout -- <file>，回退到版本库中最新的状态（可能是暂存区或分支）
• 撤销暂存区的修改（unstaged）：git reset HEAD <file>，即清空暂存区
• commit后，当前分支回退：git reset --hard 版本号，参考上一节“版本控制”

add后如果想撤销工作区的修改，必须先清空暂存区，在放弃工作区修改。

推送到远程仓库

可以自建远程仓库，也可以使用第三方仓库。第三方仓库比较出名的有github、bitbucket。之前github免费账户只有公开仓库，被微软收购后开放了免费私人仓库。

本地仓库连接远程仓库，需要有远程仓库账号、ssh秘钥对。账号在github官网上申请，ssh秘钥对生成参考ssh-keygen用法。

准备好上面两个东西，登陆github账号，在setting-->SSH and GPG keys中添加生成的ssh公钥。至此，远程仓库通过公钥验证个人电脑上的私钥完成身份认证。

第一次使用github需要建空仓库，然后把本地仓库的文件推送到远程仓库。在github网站右上角，点加号，根据引导新建仓库。

建完远程仓库就可以将本地仓库与之关联，在本地仓库执行 git remote add origin https://github.com/lcf33/gitTest.git。

然后将本地仓库内容推送至远端，在本地仓库执行 git push -u origin master。第一次推送加-u参数，会把本地的master分支和远程的master分支关联起来，在以后的推送或者拉取时就可以简化命令。

从远程仓库克隆

现在远程服务器有一个learngit仓库，本地电脑没有。我们可以使用clone命令将其下载到本地。git clone https://github.com/lcf33/learngit.git,本地当前目录下就会生成一个目录，内含远端仓库所有文件。

远端仓库的地址在github页面可以找到，还可以使用git clone git@github.com:lcf33/learngit。Git支持多种协议，前者使用https协议，后者使用使用ssh协议。

使用https除了速度慢以外，还有个最大的麻烦是每次推送都必须输入口令，但是在某些只开放http端口的公司内部就无法使用ssh协议而只能用https。

创建分支

版本库里默认生成的时间线是master分支。master即是分支名，也可以当做标签。git用master标签指向主分支最新提交，用HEAD标签指向master表示当前位于master分支。

使用git checkout -b dev 创建dev分支并转到该分支。此时HEAD改为指向dev分支，表示当前处于dev分支，之后add、commit都针对dev分支。

上面一条命令相当于git branch dev git checkout dev，前一条是创建分支，第二条是转换分支。为避免checkout混乱，新版本git添加了switch命令。创建并切换分支:git switch -c dev。

查看当前仓库所处分支git branch，星号标注所处分支。

合并分支

在dev分支某文件最佳了些内容，合并前先切回master分支 git switch master。合并指定分支到当前分支git merge dev。git直接把master指向dev的当前提交，合并速度非常快（fast-forward）。

合并之后就可以放行删除dev分支了，git brance -d dev。如果要丢弃一个没有被合并过的分支，可以通过git branch -D <name>强行删除。

因为创建、合并和删除分支非常快，所以Git鼓励你使用分支完成某个任务，合并后再删掉分支，这和直接在master分支上工作效果是一样的，但过程更安全。

但上面合并有个问题，dev分支信息会随着删除分支一起删除。在合并时使用--no-ff参数，git merge --no-ff -m "merge with no-ff" dev。合并时创建一个新的commit，所以要加上-m参数。

解决冲突

如果两个分支都做了修改，合并就会产生冲突。git会把两个分支的不同标注在变更文件中，需要我们手动修改后再次add、commit。

冲突文件中，Git用<<<<<<<，=======，>>>>>>>标记出不同分支的内容。

再次提交后，用git log --graph命令可以看到分支合并图。

分支管理原则

master分支应该是非常稳定的，也就是仅用来发布新版本，平时不能在上面干活。

干活都在dev分支上，dev分支是不稳定的。在需要发布文档版本时把dev合并到master上。

团队每个人都在dev分支上干活，每个人都有自己的分支，时不时地往dev分支上合并。

紧急修改

紧急修改（比如修复bug），通过创建新的bug分支进行修复，然后合并，最后删除。

当手头工作没有完成时，先把工作现场git stash一下，然后去修复bug，修复后，再git stash pop，回到工作现场。用git stash apply恢复，但是恢复后，stash内容并不删除，你需要用git stash drop来删除。可以多次stash，恢复的时候，先用git stash list查看，然后恢复指定的stash，git stash apply stash@{0}。

在master分支上修复的bug，想要合并到当前dev分支，可以用git cherry-pick <commit>命令，把bug提交的修改“复制”到当前分支，避免重复劳动。

多人协作

多人协作的工作模式通常是这样：

• 首先，可以试图用git push origin <branch-name>推送自己的修改；
• 如果推送失败，是因为远程分支比你的本地更新，需要先用git pull试图合并；
• 如果合并有冲突，则解决冲突，并在本地提交；
• 没有冲突或者解决掉冲突后，再用git push origin <branch-name>推送就能成功。

如果git pull提示no tracking information，则说明本地分支和远程分支的链接关系没有创建，用命令git branch --set-upstream-to <branch-name> origin/<branch-name>。

从远程库clone时，默认情况下只能看到本地的master分支，要在dev分支上开发，就必须创建远程origin的dev分支到本地，git checkout -b dev origin/dev。

如果本地已经单独创建dev分支，可以建立本地分支和远程分支的关联，使用git branch --set-upstream branch-name origin/branch-name。

要查看远程库的信息，用git remote，用git remote -v显示更详细的信息。在Git中，分支完全可以留在本地，是否推送，自己定。一般master、dev两个分支要与远程同步。

如果没有先git pull，则别人先push的修改就会影响到push。解决冲突后提交线也会变得凌乱。使用git rebase把分叉的提交历史“整理”成一条直线，看上去更直观。缺点是本地的分叉提交已经被修改过了。

标签管理

Git的标签虽然是版本库的快照，但其实它就是指向某个commit的指针（跟分支很像对不对？但是分支可以移动，标签不能移动），所以，创建和删除标签都是瞬间完成的。

commit是hash值，不好管理。tag就是一个让人容易记住的有意义的名字，它跟某个commit绑在一起。

在Git中打标签非常简单，首先切换到需要打标签的分支上，然后git tag v1.0就打上了“v1.0”的标签。

如果要对之前的commit打标签，git log --pretty=oneline --abbrev-commit找到对应的hash值，git tag v0.9 hash_value。

使用git tag查看所有标签。该命令是按字母列出标签。可以用git show <tagname>查看标签详细信息。如果嫌标签太短，可以用-m参数加上备注。git tag -a v1.0 -m "version 1.0 released"，用-a指定标签名。

如果标签打错了，也可以删除git tag -d v0.9。

创建的标签都只存储在本地，不会自动推送到远程。如果要推送某个标签到远程，使用命令git push origin <tagname>，或者推送全部尚未推送到远程的本地标签git push origin --tags。

如果标签已经推送到远程，要删除远程标签就麻烦一点，先从本地删除，然后从远程删除。远程删除命令也是push，但是格式如下git push origin :refs/tags/v0.9