原文: http://rypress.com/tutorials/git/plumbing
本文详细介绍GIT Plumbing--更加底层的git命令,你将会对git在内部是如何管理和呈现一个项目repo有一个深入的理解。
除非你想通读Git源代码,你可能永远没有必要使用下面的命令。但是通过手工的操作一个repo将会让你对于GIT如何保存数据的概念细节有个深入理解,你也将对于git是如何工作的有更好的理解。
我们首先来检阅Git的object database,然后我们使用git的低级命令手工创建和commit一个snapshot
Examine Commit Details
首先我们通过git cat-file plumbing command来查看最近的一个commit:
git cat-file commit HEAD
commit参数告诉git我们需要查看一个commit对象。正如我们所知,HEAD指向最近的commit.这将输出下面的信息:
tree 552acd444696ccb1c3afe68a55ae8b20ece2b0e6
parent 6a1d380780a83ef5f49523777c5e8d801b7b9ba2
author Ryan <ryan.example@rypress.com> -
committer Ryan <ryan.example@rypress.com> - Add .gitignore file
这是代表一个commit的完整信息:一个tree,一个parent,用户数据和一个commit message.用户信息和commit消息是非常容易理解的,但我们从来没有见过tree或者parent.
一个tree object是git对于一个"snapshot"的代表。他们保存了一个目录在特定时刻的状态,该object没有任何关于时间或者作者的信息。为了将tree和项目一贯的历史信息关联起来,GIT将每一个tree对象包装在一个commit对象中,并且指定一个parent,而这个parent实际上就是另外一个commit.通过遍历每一个commit的parent,你就可以遍历完项目的整个历史。
注意每一个commit refers to one and only one tree object,也就是说commit和tree是一一对应的。从git cat-file输出的内容看,我们可以使用SHA checksum来代表那个tree.这个SHA CHECKSUM对于GIT内部每一个变量都是适用的。
Examine a Tree
下面我们使用git cat-file命令来检阅一个TREE对象。注意将相关的id更新为你的tree的id:
git cat-file tree 552acd4
不幸的是上述命令输出的是binary数据,无法阅读。你可以通过使用下面的git ls-tree命令来输出可阅读的内容。
git ls-tree 552acd4
该命令将输出目录的列表:
blob 99ed0d431c5a19f147da3c4cb8421b5566600449 .gitignore
tree ab4947cb27ef8731f7a54660655afaedaf45444d about
blob cefb5a651557e135666af4c07c7f2ab4b8124bd7 blue.html
blob cb01ae23932fd9704fdc5e077bc3c1184e1af6b9 green.html
blob e993e5fa85a436b2bb05b6a8018e81f8e8864a24 index.html
blob 2a6deedee35cc59a83b1d978b0b8b7963e8298e9 news-.html
blob 0171687fc1b23aa56c24c54168cdebaefecf7d71 news-.html
...
通过检查上面命令的输出内容,我们可以假定"blobs"代表了我们repo里面的文件,而trees代表了repo里面的folders。继续通过git ls-tree检阅about tree,我们就可以看到是不是我们的假定是正确的了。
所以,blob对象实际上就是git保存我们文件内容的对象,可以简单理解为文件,tree对象组合了blob和其他的tree对象形成了目录列表,也就是说tree可以简单理解为目录。这些对象就是git最终形成我们在git中常用命令所操作的唯一对象。commit,tree,blob之间的关系可以用下面的图形象展示:
Examine a Blob
我们来看看和blue.html文件相对应的blob:
git cat-file blob cefb5a6
这会展示blue.html文件的整个内容,这也印证了blob本身就是存数据文件,blob本身是纯粹的content,它本身甚至没有任何关于文件名称的信息。也就是说文件名blue.html是保存在包含blob的tree对象中,而不是在blob对象中。
你可能知道SHA-1 checksum确保一个对象的内容永远不会在Git不知情的情况下被篡改。checksum的原理是通过使用对象内容来计算一个唯一的字符序列。这不仅作为一个id,而且它保证一个对象永远不会悄无声息地被修改(而git竟然不知情).当我们来谈到blob对象时,这又有另外一个好处。既然两个具有相同内容的blob永远具有相同的checksum id,那么git可以跨tree来共享一个blob对象。比如我们的blue.html文件自从被创建后就没有被修改,那么我们的repo将只有一个相关联的blob,而所有后续的tree对象都将引用它。通过不去创建重复的blob,Git可以大大降低repo的尺寸。有这个理念作为基础,我们可以修正git的对象图如下:
然而,只要你更改文件的任何一行,Git都必需创建一个新的blob对象来反映这个修改,因为内容变更,SHA-1 checksum就将变更。当然,GIT也有一些增量修改的机制来保证这个尺寸增加不是很大的问题。
Examine a Tag
第四个也是最后一个git object是tag对象.我们可以使用git cat-file命令来显示tag的detail存储信息:
git cat-file tag v2.
上面的命令将输出和v2.0这个tag相关的commitID,以及tag的名称,作者,创建时间和附加信息。下面更新最后版本的git对象图:
Inspect Git’s Branch Representation
我们现在有了能够完全浏览git branch representation的所有工具,使用-t选项,我们可以得知git对branch使用哪种对象来表示:
git cat-file -t master
将输出commit
git cat-file commit master
将输出和git cat-file commit HEAD完全一样的信息
一个branch就是一个对一个commit对象的引用,这意味着我们可以通过git cat-file commit master来查看master branch的详细信息。master branch和HEAD都是对一个commit对象的简单引用。
我们打开.git/refs/heads/master文件,你可以看到该文件内容实际上就是最近的一个commit的checksumID(你可以通过git log -n 1来检查这个commitid)。这个文件就是git为了维护master分支所需的一切,所有其他的信息都是通过这个commit object根据上面讨论的关系图来外推得出的!(branch本身是否就等于branch tip呢??)
另一方面,HEAD reference本身记录在.git/HEAD文件中,不像branch tips总是指向一个branch的顶端commit,
HEAD并不是任何一个commit的直接链接。反而,HEAD总是引用一个branch,GIT使用这个branch来指出当前checkout出来的是哪一个commit。记住一个detached HEAD state是在当HEAD不再和branch的tip相一致时发生的!从机理上说,这意味着.git/HEAD并没有一个Local branch。试着checkout一个老的commit:
git checkout HEAD~
现在,.git/HEAD就包含一个commitID,而不再是一个branch。这告诉git我们进入了一个dtached HEAD state。无论你在什么状态,git checkout命令将总是将checkedout commit的引用记录在.git/HEAD中。我们继续git checkout master,返回master branch,来接着做一些其他的实验:
Explore the Object Database
当我们有一个git对象操作的基本理解,我们可以看看git将这些对象放在哪里了。在我们的my-git-repo库,打开文件夹.git/objects,那就是git的数据库!
每一个对象,无论对象的类型是什么,都被保存为一个文件,使用他的SHA-1 checksum作为文件名。但是,和传统将所有objects存放在一个文件夹的做法不同的是:他们通过将他们的ID前两个字符剔出来作为一个目录名,而id剩下的字符作为文件名。具体可以看看下面的objects输出目录格式:
3e 5c 6e f7
3f 5e 6f f8
2a 7a f9
1c 2b 7c fa
0c 3c 4e 5a 6a a0 info
0e 3d 5b 6b a2 pack
比如,一个具有如下ID的object,
7a52bb857229f89bffa74134ee3de48e5e146105
将会被保存在7a 文件架中,而剩下的(52bb8...)作为文件名,也就是说7a目录+52bb8...文件的组合来唯一标识该object
这样做的好处是检索迅速。知道了这一层,那么我们就可以重新组合出来我们的objectID,以便方便地查阅它的内容,git
cat-file
-t
7a52bb8 ,
git
cat-file
blob
7a52bb8
:该命令就是重新组合我们的object,并且如果发现它是blob对象,我们就将得到其内容,如果是tree对象,则用lstree命令
Collect the Garbage
随着repo的增长,GIT可能自动将你的object文件转换成一种被成为"pack"的压缩文件。你可以使用garbage collection的命令来强制运行该压缩过程。但是要清楚:这个命令是不可回退的。如果你希望继续explore .git/objects文件夹的内容,你就应该在执行下面的命令之前进行。
git gc
上面这条命令将会压缩各个object files形成更快更小的pack file并且删除一些不再引用的commit(比如frrom a deleted, unmerged branch)。
当然,所有相同objectID的都将可用git cat-file来访问。该git gc命令只是更改git的存储机制--而不是更改repo的内容。
Add Files to the Index
到现在,我们已经讨论过git的low-level representation of commited snapshots.这篇文章中,下面我们将各个零件转动运转起来,使用更多的"plumbing"命令来手工准备和提交一个新的snapshot。这将彻底解密GIT是如何管理working directory和staging area的。
在my-git-repo中创建一个新的文件,命名为news-4.html,并且增加一些html代码;然后修改Index.html文件的news section以便生成一个指向news-4.html的链接。
这时,正常情况下,我们将git add, git commit提交我们的变更。现在我们来试图使用更加低级的命令来手工完成这个操作。index是git的术语,代表了staged snapshot。
git status
git update-index index.html
git update-index news-.html
后面的命令将会抛出一个错误,因为git在你不明显告诉他news-4.html是一个新文件时,他是不允许加入他不知道的文件到stage area的。相反地,我们少做修改,增加--add参数:
git update-index --add news-.html
git status
我们通过上面的update-index命令将我们的working directory搬到了Index区,这意味着我们已经有了一个准备好的snapshot了,剩下来要做的事情就是commit了。
Store the Index in the Database
记住:所有的commits都引用到一个tree object,而这个tree object就代表了那个commit的snapshot。所以,在创建一个commit对象之前,我们需要将我们的Index(staged tree)放到git的object database中。我们可以通过下面的命令来达到目的:
git write-tree
这个命令从index创建一个tree object并且保存在.git/objects目录中。它将输出这个命令结果的tree的checksumid:
5f44809ed995e5b861acf309022ab814ceaaafd6
你可以通过git ls-tree来检查你的新创的snapshot。记住这个commit中唯一新创的blob是index.html和news-4.html,这个tree的剩余内容引用了已经存在的blobs
git
ls-tree
5f44809
所以,我们已经有了我们的tree object了,但是我们必需将他放到我们项目的历史中去。
Create a Commit Object
为了commit the new tree object,我们可以手工地找到parent commit的ID:
git log --oneline -n 1
这条命令将输出下面的内容,我们将使用这个commitID来指定新的commit对象的parent
3329762
Add .gitignore file
git commit-tree命令创建一个commit object根据传入的tree和parentID参数,但是author信息却是从git的一个环境变量来读取的。
git commit-tree 5f44809 -p
这条命令将需要更多的输入: commit message.就像我们在做commit时要求输入commit message一样操作就可以了。
该命令最终输出
c51dc1b3515f9f8e80536aa7acb3d17d0400b0b5
现在你就可以在.git/objects目录下查看到这个commit了,但是无论是HEAD或者是branches都没有被自动更新而包含这个commit. 现在这就是一个dangling commit。好消息是,我们知道git在哪里保存branch信息的:
Update HEAD
既然我们并不是在一个detached HEAD state, HEAD就是一个对一个branch的引用。所以,我们要更新HEAD需要做的就是移动master branch,向前指向到我们的最新的commit object.这个工作可以通过直接在文本编辑器中修改.git/refs/heads/master为我们commit-tree命令的输出(commit objectid)来完成。
如果这个文件根本不存在,也不用烦恼,这仅仅意味着git gc命令packed up all of our branch references into single file.在这种情况下,我们无法来更新。git/refs/heads/master,但是我们应该打开.git/packed-refs,找到独一refs/heads/master的引用的那行,修改即可。
既然我们的master branch指向了新的ecommit,我们应该可以在项目历史中看到news-4.html文件了。
git log -n 2
上面的章节我们解释了当我们执行git commit -a -m "some message"时所有发送在背后的真实事情。你是否觉得还是不用超低级命令的好呢?
commited, modified, staged
注意:在Git中,你的文件将有三个可能的状态存在:commited, modified, staged. Commited意味着数据已经安全地存储到了你的local database. Modified意味着你已经修改了这个文件但是还没有放到数据库中。staged意味着你已经标示了modified files,以便作为下一个commit的snapshot。这也导致了一个Git项目具有三个不同的section: Git directory, working directory, staging area.
Git directory是Git用于保存其metadata和objects的地方所在。这个目录是git最重要的部分,这个也是当你clone一个repo时copy的部分。working directory是你的项目的一个版本的checkout.这些文件是从git directory的compress database中抽取出来的,并且将这些内容放到磁盘*你来修改和使用。
staging area就是一个文件,通常就放在.git目录中,这个文件保存了关于下一个commit的所有信息。有时我们又称之为index,但是更多的情况下,人们称之为staging area. 基本的GIT workflow像下面这个样子:
1.你在working directory中修改文件;
2.你stage这些修改,adding snapshots of them to your staging area;
3.你做一个commit,这个动作将把stage区中的snapshot永远存储于git directory的repo数据库中。
如果一个文件在Git directory中存在了,那么就被认为被commited了。如果文件modified,并且已经放到staging area了,那么成为it is staged.如果自从该文件被checkout出来后做了修改,但是却还没有staged,那么他就是modified状态。
.git/index这个文件实际上就是staging area,它会实时记录你准备放到下一个commit的snapshot,我们可以用ls-files来检查他的内容(他是binary文件)
git ls-files --stage
git ls-files -stage //记住:该命令实际上查看的是.git/index文件本身
//输入如下内容:
e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 anotherfile.txt
303bcbd14ef854ea5ac85a4896e5f37a11dd4394 hotfixbranch.txt
41d9b439a7c42e9f65c5382d992a0b158ce43956 readme.txt
b64aa37a6bd9fc4f66fe86b9c1d07b821fbf3966 third
由于我们已经修改了readme.txt文件并且放到staging area,那么这时我们来检视这个文件的话,
git cat-file -t 41d9b4 一定输出blob
D:\gittest>git cat-file blob 41d9
readme.txt first version
second version readme
to check the index area
你可以看到最后一行就是最新的更改,但是上述命令却将整个readme.txt文件都作为blob来输出了@
tracked and untracked
记住:在你的working directory中任何一个文件都有两种可能的状态:tracked or untracked. tracked文件是那些在最近的snapshot中存在的文件,他们可以被修改,反修改或者staged. Untracked文件是任何你的working directory中没有在你的last snapshot中并且未在staging area中的文件。也就是说只要是曾经执行过git add命令的,都是tracked file。