基础
一、取得项目的 Git 仓库
两种取得 Git 项目仓库的方法。第一种是在现存的目录下,通过导入所有文件来创建新的 Git 仓库。第二种是从已有的 Git 仓库克隆出一个新的镜像仓库来。
1、从当前目录初始化
要对现有的某个项目开始用 Git 管理,只需到此项目所在的目录,执行:
初始化后,在当前目录下会出现一个名为 .git 的目录,所有 Git 需要的数据和资源都存放在这个目录中。
如果当前目录下有几个文件想要纳入版本控制,需要先用 git add 命令告诉 Git 开始对这些文件进行跟踪,然后提交:
现在,你已经得到了一个实际维护着若干文件的 Git 仓库。
2、从现有仓库克隆
克隆仓库的命令格式为git clone [url]。比如,要克隆 Ruby 语言的 Git 代码仓库 Grit,可以用下面的命令:
这会在当前目录下创建一个名为 “grit” 的目录,其中内含一个.git 的目录,并从同步后的仓库中拉出所有的数据,取出最新版本的文件拷贝。如果进入这个新建的grit 目录,你会看到项目中的所有文件已经在里边了,准备好后续的开发和使用。如果希望在克隆的时候,自己定义要新建的项目目录名称,可以在上面的命令最后指定:
Git 支持许多数据传输协议。之前的例子使用的是git:// 协议,不过你也可以用http(s):// 或者user@server:/path.git 表示的 SSH 传输协议。
二、记录每次更新到仓库
工作目录(work directory)下面的所有文件都不外乎这两种状态:已跟踪或未跟踪。
已跟踪的文件是指本来就被纳入版本控制管理的文件,在上次快照中有它们的记录,工作一段时间后,它们的状态可能是未更新,已修改(modified)或者已放入暂存区(staged)。而所有其他文件都属于未跟踪文件。它们既没有上次更新时的快照,也不在当前的暂存区域。初次克隆某个仓库时,工作目录中的所有文件都属于已跟踪文件,且状态为未修改。
1、检查当前文件状态
可以用 git status 命令。如果在克隆仓库之后立即执行此命令,会看到类似这样的输出:
现在让我们用 vim 编辑一个新文件 README,保存退出后运行git status 会看到该文件出现在未跟踪文件列表中:
2、跟踪新文件
使用命令git add 开始跟踪一个新文件。所以,要跟踪 README 文件,运行:
此时再运行git status 命令,会看到 README 文件已被跟踪,并处于暂存状态:
只要在 “Changes to be committed” 这行下面的,就说明是已暂存状态。如果此时提交,那么该文件此时此刻的版本将被留存在历史记录中。
git add 后可以接要跟踪的文件或目录的路径。如果是目录的话,就说明要递归跟踪所有该目录下的文件。
3、暂存已修改文件
现在我们修改下之前已跟踪过的文件benchmarks.rb,然后再次运行status 命令,会看到这样的状态报告:
文件 benchmarks.rb 出现在 “Changed but not updated” 这行下面,说明已跟踪文件的内容发生了变化,但还没有放到暂存区。
要暂存这次更新,需要运行git add 命令(这是个多功能命令,根据目标文件的状态不同,此命令的效果也不同:可以用它开始跟踪新文件,或者把已跟踪的文件放到暂存区,还能用于合并时把有冲突的文件标记为已解决状态等)
现在两个文件都已暂存,下次提交时就会一并记录到仓库。假设此时,你想要在 benchmarks.rb 里再加条注释,重新编辑存盘后,准备好提交。benchmarks.rb 文件出现了两次!一次算未暂存,一次算已暂存,这怎么可能呢?好吧,实际上 Git只不过暂存了你运行 git add 命令时的版本,如果现在提交,那么提交的是添加注释前的版本,而非当前工作目录中的版本。所以,运行了git add 之后又作了修订的文件,需要重新运行git add 把最新版本重新暂存起来。
4、忽略某些文件
我们可以创建一个名为 .gitignore 的文件,列出要忽略的文件模式,来看一个简单的例子:
第一行告诉 Git 忽略所有以 .o 或 .a 结尾的文件。一般这类对象文件和存档文件都是编译过程中出现的,我们用不着跟踪它们的版本。
第二行告诉 Git 忽略所有以波浪符(~)结尾的文件,许多文本编辑软件(比如 Emacs)都用这样的文件名保存副本。
文件 .gitignore 的格式规范如下:
•所有空行或者以注释符号 # 开头的行都会被 Git 忽略。
•可以使用标准的 glob 模式匹配。
•匹配模式最后跟反斜杠(/)说明要忽略的是目录。
•要忽略指定模式以外的文件或目录,可以在模式前加上惊叹号(!)取反。
glob 模式是指 shell 所使用的简化了的正则表达式。星号(*)匹配零个或多个任意字符;[abc] 匹配任何一个列在方括号中的字符(这个例子要么匹配一个 a,要么匹配一个 b,要么匹配一个 c);问号(?)只匹配一个任意字符;如果在方括号中使用短划线分隔两个字符,表示所有在这两个字符范围内的都可以匹配(比如[0-9] 表示匹配所有 0 到 9 的数字)。再看一个 .gitignore 文件的例子:
5、查看已暂存和未暂存的更新
实际上git status 的显示比较简单,仅仅是列出了修改过的文件,如果要查看具体修改了什么地方,可以用git diff 命令。git diff 会使用文件补丁的格式显示具体添加和删除的行。
假如再次修改 README 文件后暂存,然后编辑 benchmarks.rb 文件后先别暂存,运行status 命令,会看到:
要查看尚未暂存的文件更新了哪些部分,不加参数直接输入git diff:
此命令比较的是工作目录中当前文件和暂存区域快照之间的差异,也就是修改之后还没有暂存起来的变化内容。
若要看已经暂存起来的文件和上次提交时的快照之间的差异,可以用git diff --cached 命令。(Git 1.6.1及更高版本还允许使用git diff --staged,效果是相同的,但更好记些。)来看看实际的效果:
请注意,单单git diff 不过是显示还没有暂存起来的改动,而不是这次工作和上次提交之间的差异。
6、提交更新
每次准备提交前,先用git status 看下,是不是都已暂存起来了,然后再运行提交命令git commit:
这种方式会启动文本编辑器以便输入本次提交的说明。编辑器会显示类似下面的文本信息(本例选用 Vim 的屏显方式展示):
可以看到,默认的提交消息包含最后一次运行git status 的输出,放在注释行里,另外开头还有一空行,供你输入提交说明。你完全可以去掉这些注释行,不过留着也没关系,多少能帮你回想起这次更新的内容有哪些。(如果觉得这还不够,可以用-v 选项将修改差异的每一行都包含到注释中来。)退出编辑器时,Git 会丢掉注释行,将说明内容和本次更新提交到仓库。
也可以使用 -m 参数后跟提交说明的方式,在一行命令中提交更新:
现在你已经创建了第一个提交!可以看到,提交后它会告诉你,当前是在哪个分支(master)提交的,本次提交的完整 SHA-1 校验和是什么(463dc4f),以及在本次提交中,有多少文件修订过,多少行添改和删改过。
提交时记录的是放在暂存区域的快照,任何还未暂存的仍然保持已修改状态,可以在下次提交时纳入
版本管理。每一次运行提交操作,都是对你项目作一次快照,以后可以回到这个状态,或者进行比较。
7、跳过使用暂存区域
给git commit 加上-a 选项,Git 就会自动把所有已经跟踪过的文件暂存起来一并提交,从而跳过git add 步骤:
8、移除文件
要从 Git 中移除某个文件,就必须要从已跟踪文件清单中移除(确切地说,是从暂存区域移除),然后提交。可以用git rm 命令完成此项工作,并连带从工作目录中删除指定的文件,这样以后就不会出现在未跟踪文件清单中了。
如果只是简单地从工作目录中手工删除文件,运行git status 时就会在 “Changed but not updated” 部分(也就是_未暂存_清单)看到:
然后再运行git rm 记录此次移除文件的操作:
如果删除之前修改过并且已经放到暂存区域的话,则必须要用强制删除选项-f(译注:即 force 的首字母),以防误删除文件后丢失修改的内容。
另外一种情况是,我们想把文件从 Git 仓库中删除(亦即从暂存区域移除),但仍然希望保留在当前工作目录中。换句话说,仅是从跟踪清单中删除。比如一些大型日志文件或者一堆.a 编译文件,不小心纳入仓库后,要移除跟踪但不删除文件,以便稍后在.gitignore 文件中补上,用--cached 选项即可:
后面可以列出文件或者目录的名字,也可以使用 glob 模式。比方说:
注意到星号* 之前的反斜杠\,因为 Git 有它自己的文件模式扩展匹配方式,所以我们不用 shell 来帮忙展开。
9、移动文件
不像其他的 VCS 系统,Git 并不跟踪文件移动操作。
当你看到 Git 的mv 命令时一定会困惑不已。要在 Git 中对文件改名,可以这么做:
它会恰如预期般正常工作。实际上,即便此时查看状态信息,也会明白无误地看到关于重命名操作的说明:
其实,运行git mv 就相当于运行了下面三条命令: