Git手册

Git手册使用方法：

首先速览本文第一章和第二章内容；
跟着廖雪峰 Git教程操作一遍，然后再仔细阅读本文内容；
如果已经熟悉，直接看阅读更多中的内容即可。

第一章

创建版本库

初始化一个Git仓库，使用git init命令。

添加文件到Git仓库，分两步：

使用命令 git add <file> ，注意，可反复多次使用，添加多个文件；
使用命令 git commit -m <message> ，完成。

版本回退

HEAD指向的版本就是当前版本，因此，Git允许我们在版本的历史之间穿梭，使用命令 git reset --hard commit_id 。

穿梭前，用 git log 可以查看提交历史，以便确定要回退到哪个版本。

要重返未来，用 git reflog 查看命令历史，以便确定要回到未来的哪个版本。

撤销更改

场景1：当你改乱了工作区某个文件的内容，想直接丢弃工作区的修改时，用命令 git checkout -- readme.txt 意思就是，把readme.txt文件在工作区的修改全部撤销，这里有两种情况（git checkout . 本地所有修改的。没有的提交的，都返回到原来的状态）：

一种是readme.txt自修改后还没有被放到暂存区，现在，撤销修改就回到和版本库一模一样的状态；
一种是readme.txt已经添加到暂存区后，又作了修改，现在，撤销修改就回到添加到暂存区后的状态。

总之，就是让这个文件回到最近一次git commit或git add时的状态。

场景2：当你不但改乱了工作区某个文件的内容，还添加到了暂存区时，想丢弃修改，分两步，第一步用命令 git reset HEAD <file> ，就回到了场景1，第二步按场景1操作。

场景3：已经提交了不合适的修改到版本库时，想要撤销本次提交，参考版本回退一节（使用命令 git reset --hard commit_id ），不过前提是没有推送到远程库。

删除文件

当你要删除文件的时候，可以采用命令： rm test.txt

这个时候（也就是说这个时候只执行了rm test.txt）有两种情况

第一种情况:的确要把test.txt删掉，那么可以执行 git rm test.txt git commit -m "remove test.txt" 然后文件就被删掉了
第二种情况:删错文件了，参考撤销更改一节。

第二章

远程仓库

添加远程仓库

要关联一个远程库，使用命令git remote add origin git@server-name:path/repo-name.git；
关联后，使用命令git push -u origin master第一次推送master分支的所有内容；
此后，每次本地提交后，只要有必要，就可以使用命令git push origin master推送最新修改；

从远程仓库克隆

要克隆一个仓库，首先必须知道仓库的地址，然后使用git clone命令克隆。
Git支持多种协议，包括https，但通过ssh支持的原生git协议速度最快。

创建与合并分支

查看分支：git branch
创建分支：git branch <name>
切换分支：git checkout <name> 或者 git switch <name>
创建+切换分支：git checkout -b <name> 或者 git switch -c <name>
合并某分支到当前分支：git merge <name>
删除分支：git branch -d <name>

解决冲突

当Git无法自动合并分支时，就必须首先解决冲突。解决冲突后，再提交，合并完成。解决冲突就是把Git合并失败的文件手动编辑为我们希望的内容，再提交。用 git log --graph 命令可以看到分支合并图（用 git log --graph --pretty=oneline --abbrev-commit 可以查看简化形式的分支合并图）。

分支管理

在实际开发中，我们应该按照几个基本原则进行分支管理：首先，master分支应该是非常稳定的，也就是仅用来发布新版本，平时不能在上面干活；那在哪干活呢？干活都在dev分支上，也就是说，dev分支是不稳定的，到某个时候，比如1.0版本发布时，再把dev分支合并到master上，在master分支发布1.0版本；你和你的小伙伴们每个人都在dev分支上干活，每个人都有自己的分支，时不时地往dev分支上合并就可以了。所以，团队合作的分支看起来就像这样：

合并分支时，加上—no-ff参数就可以用普通模式合并，合并后的历史有分支，能看出来曾经做过合并，而fast forward合并就看不出来曾经做过合并（通常，合并分支时，如果可能，Git会用Fast forward模式，但这种模式下，删除分支后，会丢掉分支信息。如果要强制禁用Fast forward模式，Git就会在merge时生成一个新的commit，这样，从分支历史上就可以看出分支信息。）。

git多人协作式开发时分支管理策略

Bug分支

修复bug时，我们会通过创建新的bug分支进行修复，然后合并，最后删除；
当手头工作没有完成时，先把工作现场 git stash 一下，然后去修复bug，修复后，再 git stash pop，回到工作现场；
在master分支上修复的bug，想要合并到当前dev分支，可以用 git cherry-pick <commit> 命令，把bug提交的修改“复制”到当前分支，避免重复劳动。

注释：总的来说，就是，在分支下进行的工作，如果不commit的话，回到master，就会显示出你在分支下你添加的工作。这个时候，你在master下修改完bug提交后，正在分支进行的工作也会提交了。为了避免这个情况，你就在分支下，git stash将工作隐藏，这个时候，切换到master时候，修改了bug，提交。分支的内容不会被提交上去。

Feature分支

开发一个新feature，最好新建一个分支；如果要丢弃一个没有被合并过的分支，可以通过 git branch -D <name> 强行删除。

多人协作

当你从远程仓库克隆时，实际上Git自动把本地的master分支和远程的master分支对应起来了，并且，远程仓库的默认名称是origin。
要查看远程库的信息，用 git remote -v：

推送分支，就是把该分支上的所有本地提交推送到远程库。推送时，要指定本地分支，这样，Git就会把该分支推送到远程库对应的远程分支上：git push origin master 如果要推送其他分支，比如dev，就改成：git push origin dev

但是，并不是一定要把本地分支往远程推送，那么，哪些分支需要推送，哪些不需要呢？

master分支是主分支，因此要时刻与远程同步；
dev分支是开发分支，团队所有成员都需要在上面工作，所以也需要与远程同步；
bug分支只用于在本地修复bug，就没必要推到远程了，除非老板要看看你每周到底修复了几个bug；
feature分支是否推到远程，取决于你是否和你的小伙伴合作在上面开发。

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

首先，可以试图用 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> 。

第三章

搭建Git服务器

安装git：sudo apt-get install git
创建一个git用户，用来运行git服务：sudo adduser git
创建证书登录：收集所有需要登录的用户的公钥，就是他们自己的id_rsa.pub文件，把所有公钥导入到 /home/git/.ssh/authorized_keys 文件里，一行一个。
初始化Git仓库：先选定一个目录作为Git仓库，假定是 /srv/sample.git，在/srv目录下输入命令：sudo git init --bare sample.git Git就会创建一个裸仓库，裸仓库没有工作区，因为服务器上的Git仓库纯粹是为了共享，所以不让用户直接登录到服务器上去改工作区，并且服务器上的Git仓库通常都以.git结尾。然后，把owner改为git：sudo chown -R git:git sample.git
禁用shell登录：出于安全考虑，第二步创建的git用户不允许登录shell，这可以通过编辑/etc/passwd文件完成。找到类似下面的一行：git:x:1001:1001:,,,:/home/git:/bin/bash 改为：git:x:1001:1001:,,,:/home/git:/usr/bin/git-shell 这样，git用户可以正常通过ssh使用git，但无法登录shell，因为我们为git用户指定的git-shell每次一登录就自动退出。
克隆远程仓库：现在，可以通过git clone命令克隆远程仓库了，在各自的电脑上运行：git clone git@server:/srv/sample.git 。我们的ssh端口可能不是22，那么在填写url的时候就要做出一定的改变的：git clone ssh://用户名@主机IP(或域名):端口号/git目录地址

管理公钥：如果团队很小，把每个人的公钥收集起来放到服务器的 /home/git/.ssh/authorized_keys 文件里就是可行的。如果团队有几百号人，这时，可以用Gitosis来管理公钥。

管理权限：可以在服务器端编写一系列脚本来控制提交等操作，达到权限控制的目的。Gitolite就是这个工具。

Git使用中的问题

使用git pull之后出现冲突error: Your local changes to the following files would be overwritten by merge:

原因：其他人修改了A文件并提交到版本库中去了，而你本地也修改了A文件，这时候你进行 git pull 操作就好出现冲突了。

解决办法：

方法一：服务器代码合并本地代码（推荐）

1
2
3

$ git stash     //暂存当前正在进行的工作。
$ git pull origin master //拉取服务器的代码
$ git stash pop //合并暂存的代码

方法二：服务器代码覆盖本地代码

1 2	$git reset --hard //回滚到上一个版本 $git pull origin master

第一章