一、实验说明

本节实验为 Git 入门第二个实验，继续练习最常用的git命令。
实验准备
在进行该实验之前，可以先 clone 一个练习项目gitproject :
$ git clone https://github.com/shiyanlou/gitproject
本节中的实验操作都是在该项目中完成。

二、比较内容

下面将学习如何比较提交，分支等内容。

2.1 比较提交 - Git Diff

现在我们对项目做些修改：

  1. $ cd gitproject
  2. # 向README文件添加一行
  3. $ echo "new line" >> README.md
  4. # 添加新的文件file1
  5. $ echo "new file" >> file1

使用git status查看当前修改的状态：

  1. $ git status
  2. On branch master
  3. Your branch is up-to-date with 'origin/master'.
  5. Changes not staged for commit:
  6.   (use "git add <file>..." to update what will be committed)
  7.   (use "git checkout -- <file>..." to discard changes in working directory)
  9.     modified:   README.md
  11. Untracked files:
  12.   (use "git add <file>..." to include in what will be committed)
  14.     file1
  16. no changes added to commit (use "git add" and/or "git commit -a")

可以看到一个文件修改了，另外一个文件添加了。如何查看修改的文件内容呢，那就需要使用git diff命令。git diff命令的作用是比较修改的或提交的文件内容。

  1. $ git diff
  2. diff --git a/README.md b/README.md
  3. index 21781dd..410e719 100644
  4. --- a/README.md
  5. +++ b/README.md
  6. @@ -1,2 +1,3 @@
  7.  gitproject
  8.  ==========
  9. +new line

上面的命令执行后需要使用q退出。命令输出当前工作目录中修改的内容，并不包含新加文件，请注意这些内容还没有添加到本地缓存区。
将修改内容添加到本地缓存区，通配符可以把当前目录下所有修改的新增的文件都自动添加：

  1. $ git add *

再执行git diff会发现没有任何内容输出，说明当前目录的修改都被添加到了缓存区，如何查看缓存区内与上次提交之间的差别呢？需要使用—cached参数：

  1. $ git diff --cached
  2. diff --git a/README.md b/README.md
  3. index 21781dd..410e719 100644
  4. --- a/README.md
  5. +++ b/README.md
  6. @@ -1,2 +1,3 @@
  7.  gitproject
  8.  ==========
  9. +new line
  10. diff --git a/file1 b/file1
  11. new file mode 100644
  12. index 0000000..fa49b07
  13. --- /dev/null
  14. +++ b/file1
  15. @@ -0,0 +1 @@
  16. +new file

可以看到输出中已经包含了新加文件的内容，因为file1已经添加到了缓存区。
最后我们提交代码：

  1. $ git commit -m 'update code'

提交后git diff与git diff —cached都不会有任何输出了。

2.2 比较分支

可以用 git diff 来比较项目中任意两个分支的差异。
我们首先创建一个新的分支test，并在该分支上提交一些修改：

  1. # 创建test分支并切换到该分支
  2. $ git branch test
  3. $ git checkout test
  4. # 添加新的一行到file1
  5. $ echo "branch test" >> file1
  6. # 创建新的文件file2
  7. $ echo "new file2" >> file2
  8. # 提交所有修改
  9. $ git add *
  10. $ git commit -m 'update test branch'

然后，我们查看test分支和master之间的差别：

  1. $ git diff master test
  2. diff --git a/file1 b/file1
  3. index fa49b07..17059cd 100644
  4. --- a/file1
  5. +++ b/file1
  6. @@ -1 +1,2 @@
  7.  new file
  8. +branch test
  9. diff --git a/file2 b/file2
  10. new file mode 100644
  11. index 0000000..80e7991
  12. --- /dev/null
  13. +++ b/file2
  14. @@ -0,0 +1 @@
  15. +new file2

git diff 是一个难以置信的有用的工具，可以找出你项目上任意两个提交点间的差异。可以使用git help diff详细查看其他参数和功能。
2.3 更多的比较选项
如果你要查看当前的工作目录与另外一个分支的差别，你可以用下面的命令执行:

  1. # 切换到master
  2. $ git checkout master
  4. # 查看与test分支的区别
  5. $ git diff test
  6. diff --git a/file1 b/file1
  7. index 17059cd..fa49b07 100644
  8. --- a/file1
  9. +++ b/file1
  10. @@ -1,2 +1 @@
  11.  new file
  12. -branch test
  13. diff --git a/file2 b/file2
  14. deleted file mode 100644
  15. index 80e7991..0000000
  16. --- a/file2
  17. +++ /dev/null
  18. @@ -1 +0,0 @@
  19. -new file2

你也以加上路径限定符，来只比较某一个文件或目录：

  1. $ git diff test file1
  2. diff --git a/file1 b/file1
  3. index 17059cd..fa49b07 100644
  4. --- a/file1
  5. +++ b/file1
  6. @@ -1,2 +1 @@
  7.  new file
  8. -branch test

上面这条命令会显示你当前工作目录下的file1与test分支之间的差别。
—stat 参数可以统计一下有哪些文件被改动，有多少行被改动：

  1. $ git diff test --stat
  2.  file1 | 1 -
  3.  file2 | 1 -
  4.  2 files changed, 2 deletions(-)

三、分布式的工作流程

下面我们学习 git 的分布式工作流程。

3.1 分布式的工作流程

你目前的项目在/home/shiyanlou/gitproject目录下，这是我们的git 仓库(repository)，另一个用户也想与你协作开发。他的工作目录在这台机器上，如何让他提交代码到你的 git 仓库呢？
首先，我们假设另一个用户也用shiyanlou用户登录，只是工作在不同的目录下开发代码，实际工作中不太可能发生，大部分情况都是多个用户，这个假设只是为了让实验简化。
该用户需要从 git 仓库进行克隆：

  1. # 进入到临时目录
  2. $ cd /tmp
  3. # 克隆git仓库
  4. $ git clone /home/shiyanlou/gitproject myrepo
  5. $ ls -l myrepo
  6. -rw-rw-r-- 1 shiyanlou shiyanlou 31 Dec 22 08:24 README.md
  7. -rw-rw-r-- 1 shiyanlou shiyanlou  9 Dec 22 08:24 file1

这就建了一个新的叫”myrepo”的目录，这个目录里包含了一份gitproject仓库的克隆。这份克隆和原始的项目一模一样，并且拥有原始项目的历史记录。
在 myrepo 做了一些修改并且提交:

  1. $ cd myrepo
  3. # 添加新的文件newfile
  4. $ echo "newcontent" > newfile
  6. # 提交修改
  7. $ git add newfile
  8. $ git commit -m "add newfile"

myrepo修改完成后，如果我们想合并这份修改到gitproject的git仓库该如何做呢？
可以在仓库/home/shiyanlou/gitproject中把myrepo的修改给拉 (pull)下来。执行下面几条命令:

  1. $ cd /home/shiyanlou/gitproject
  2. $ git pull /tmp/myrepo master
  3. remote: Counting objects: 5, done.
  4. remote: Compressing objects: 100% (2/2), done.
  5. remote: Total 3 (delta 0), reused 0 (delta 0)
  6. Unpacking objects: 100% (3/3), done.
  7. From /tmp/myrepo
  8.  * branch            master     -> FETCH_HEAD
  9. Updating 8bb57aa..866c452
  10. Fast-forward
  11.  newfile | 1 +
  12.  1 file changed, 1 insertion(+)
  13.  create mode 100644 newfile
  15. # 查看当前目录文件
  16. $ ls                                                                                         
  17. README.md  file1  newfile

这就把myrepo的主分支合并到了gitproject的当前分支里了。
如果gitproject在myrepo修改文件内容的同时也做了修改的话，可能需要手工去修复冲突。
如果你要经常操作远程分支(remote branch),你可以定义它们的缩写:

  1. $ git remote add myrepo /tmp/myrepo
  2. git pull命令执行两个操作: 它从远程分支(remote branch)抓取修改git fetch的内容，然后把它合并git merge进当前的分支。

gitproject里可以用git fetch 来执行git pull前半部分的工作， 但是这条命令并不会把抓下来的修改合并到当前分支里：

  1. $ git fetch myrepo
  2. From /tmp/myrepo
  3.  * [new branch]      master     -> myrepo/master

获取后，我们可以通过git log查看远程分支做的所有修改，由于我们已经合并了所有修改，所以不会有任何输出：

  1. $ git log -p master..myrepo/master

当检查完修改后，gitproject可以把修改合并到它的主分支中：

  1. $ git merge myrepo/master
  2. Already up-to-date.

如果我们在myrepo目录下执行git pull会发生什么呢？
myrepo会从克隆的位置拉取代码并更新本地仓库，就是把gitproject上的修改同步到本地:

  1. # 进入到gitproject
  2. $ cd /home/shiyanlou/gitproject
  4. # 添加一行内容到newfile
  5. $ echo "gitproject: new line" >> newfile
  7. # 提交修改
  8. $ git commit -a -m 'add newline to newfile'
  9. [master 8c31532] add newline to newfile
  10.  1 file changed, 1 insertion(+)
  12. # 进入myrepo目录
  13. $ cd /tmp/myrepo
  15. # 同步gitproject的所有修改
  16. $ git pull
  17. remote: Counting objects: 6, done.
  18. remote: Compressing objects: 100% (2/2), done.
  19. remote: Total 3 (delta 1), reused 0 (delta 0)
  20. Unpacking objects: 100% (3/3), done.
  21. From /home/shiyanlou/gitproject
  22.    8bb57aa..8c31532  master     -> origin/master
  23. Updating 866c452..8c31532
  24. Fast-forward
  25.  newfile | 1 +
  26.  1 file changed, 1 insertion(+)

因为myrepo是从gitproject仓库克隆的，那么他就不需要指定gitproject仓库的地 址。因为Git把gitproject仓库的地址存储到myrepo的配置文件中，这个地址就是在git pull时默认使用的远程仓库：

  1. $ git config --get remote.origin.url
  2. /home/shiyanlou/gitproject

如果myrepo和gitproject在不同的主机上，可以通过ssh协议来执行clone 和pull操作：

  1. $ git clone localhost:/home/shiyanlou/gitproject test

这个命令会提示你输入shiyanlou用户的密码，用户密码随机，可以点击实验操作界面右侧工具栏的SSH直连按钮查看。

3.2 公共Git仓库

开发过程中，通常大家都会使用一个公共的仓库，并clone到自己的开发环境中，完成一个阶段的代码后可以告诉目标仓库的维护者来pull自己的代码。
如果你和维护者都在同一台机器上有帐号，那么你们可以互相从对 方的仓库目录里直接拉所作的修改，git命令里的仓库地址也可以是本地的某个目录名：

  1. $ git clone /path/to/repository
  2. $ git pull /path/to/other/repository

也可以是一个ssh地址：

  1. $ git clone ssh://yourhost/~you/repository

3.3 将修改推到一个公共仓库

通过http或是git协议，其它维护者可以通过远程访问的方式抓取(fetch)你最近的修改，但是他们 没有写权限。如何将本地私有仓库的最近修改主动上传到公共仓库中呢？
最简单的办法就是用git push命令，推送本地的修改到远程Git仓库，执行下面的命令:

  1. $ git push ssh://yourserver.com/~you/proj.git master:master

或者

  1. $ git push ssh://yourserver.com/~you/proj.git master

git push命令的目地仓库可以是ssh或http/https协议访问。

3.4 当推送代码失败时要怎么办

如果推送(push)结果不是快速向前fast forward，可能会报像下面一样的错误：

  1. error: remote 'refs/heads/master' is not an ancestor of
  2. local  'refs/heads/master'.
  3. Maybe you are not up-to-date and need to pull first?
  4. error: failed to push to 'ssh://yourserver.com/~you/proj.git'

这种情况通常是因为没有使用git pull获取远端仓库的最新更新，在本地修改的同时，远端仓库已经变化了（其他协作者提交了代码），此时应该先使用git pull合并最新的修改后再执行git push：

  1. $ git pull
  2. $ git push ssh://yourserver.com/~you/proj.git master

四、Git标签

下面学习 git 标签相关内容。

4.1 轻量级标签

我们可以用 git tag不带任何参数创建一个标签(tag)指定某个提交(commit):

  1. # 进入到gitproject目录
  2. $ cd /home/shiyanlou/gitproject
  4. # 查看git提交记录
  5. $ git log
  7. # 选择其中一个记录标志位stable-1的标签，注意需要将后面的8c315325替换成仓库下的真实提交内，commit的名称很长，通常我们只需要写前面8位即可
  8. $ git tag stable-1 8c315325
  10. # 查看当前所有tag
  11. $ git tag
  12. stable-1

这样，我们可以用stable-1 作为提交 8c315325 的代称。
前面这样创建的是一个“轻量级标签”。
如果你想为一个tag添加注释，或是为它添加一个签名, 那么我们就需要创建一个 “标签对象”。
标签对象
git tag中使用-a， -s 或是 -u三个参数中任意一个，都会创建一个标签对象，并且需要一个标签消息(tag message)来为tag添加注释。 如果没有-m 或是 -F 这些参数，命令执行时会启动一个编辑器来让用户输入标签消息。
当这样的一条命令执行后，一个新的对象被添加到Git对象库中，并且标签引用就指向了一个标签对象，而不是指向一个提交，这就是与轻量级标签的区别。
下面是一个创建标签对象的例子:

  1. $ git tag -a stable-2 8c315325 -m "stable 2"
  2. $ git tag
  3. stable-1
  4. stable-2

4.2 签名的标签

签名标签可以让提交和标签更加完整可信。如果你配有GPG key，那么你就很容易创建签名的标签。首先你要在你的 .git/config 或 ~/.gitconfig 里配好key。
下面是示例:
[user]
signingkey =
你也可以用命令行来配置:

  1. $ git config (--global) user.signingkey <gpg-key-id>

现在你可以在创建标签的时候使用-s 参数来创建“签名的标签”：

  1. $ git tag -s stable-1 1b2e1d63ff

如果没有在配置文件中配GPG key,你可以用-u参数直接指定。

  1. $ git tag -u <gpg-key-id> stable-1 1b2e1d63ff

五、小结

本节学习了下面知识点：
git diff
分布式的工作流程
git tag
对于初学者，如果不想深入git强大的高级功能的话，学完这个实验就可以了，因为后续实验内容用到的比较少，并且理解难度大。如果仍然感兴趣，建议使用一段时间git后再仔细学习后续实验，会有更好的收获。

六、练习

使用GitHub账号，创建自己的仓库并练习一遍本节所讲的内容。