Git基础

如果你只想通过阅读一章来学习 Git，那么本章将是你的不二选择。 本章涵盖了你在使用 Git 完成各种工作时将会用到的各种基本命令。 在学习完本章之后，你应该能够配置并初始化一个仓库(repository)、开始或停止跟踪(track)文件、暂存(stage)或提交(commit)更改。 本章也将向你演示了如何配置 Git 来忽略指定的文件和文件模式、如何迅速而简单地撤销错误操作、如何浏览你的项目的历史版本以及不同提交(commits)之间的差异、如何向你的远程仓库推送(push)以及如何从你的远程仓库拉取(pull)文件。

获取 Git 仓库

通常有两种获取 Git 项目仓库的方式:

• 将尚未进行版本控制的本地目录转换为 Git 仓库;

• 从其它服务器 克隆 一个已存在的 Git 仓库。

两种方式都会在你的本地机器上得到一个工作就绪的 Git 仓库。

在已存在目录中初始化仓库

如果你有一个尚未进行版本控制的项目目录，想要用 Git 来控制它，那么首先需要进入该项目目录中。 如果你还 没这样做过，那么不同系统上的做法有些不同:

 cd /home/user/my_project

之后执行:

$ git init

该命令将创建一个名为 .git 的子目录，这个子目录含有你初始化的 Git 仓库中所有的必须文件，这些文件是 Git 仓库的骨干。 但是，在这个时候，我们仅仅是做了一个初始化的操作，你的项目里的文件还没有被跟踪。 (参见 Git 内部原理 来了解更多关于到底 .git 文件夹中包含了哪些文件的信息。)

git.png

如果在一个已存在文件的文件夹(而非空文件夹)中进行版本控制，你应该开始追踪这些文件并进行初始提交。 可以通过git add命令来指定所需的文件来进行追踪，然后执行git commit:

现在，你已经得到了一个存在被追踪文件与初始提交的 Git 仓库。

克隆现有的仓库

如果你想获得一份已经存在了的 Git 仓库的拷贝，比如说，你想为某个开源项目贡献自己的一份力，这时就要用到 git clone 命令。 如果你对其它的 VCS 系统(比如说 Subversion)很熟悉，请留心一下你所使用的命令是"clone"而不是"checkout"。 这是 Git 区别于其它版本控制系统的一个重要特性，Git 克隆的是该 Git 仓库服务 器上的几乎所有数据，而不是仅仅复制完成你的工作所需要文件。 当你执行 git clone 命令的时候，默认配置下远程 Git 仓库中的每一个文件的每一个版本都将被拉取下来。 事实上，如果你的服务器的磁盘坏掉了，你通常可以使用任何一个克隆下来的用户端来重建服务器上的仓库 (虽然可能会丢失某些服务器端的钩子(hook)设置，但是所有版本的数据仍在，详见 在服务器上搭建 Git )。

克隆仓库的命令是 git clone <url> 。 比如，要克隆 Git 的链接库 libgit2，可以用下面的命令:

$ git clone https://github.com/libgit2/libgit2

这会在当前目录下创建一个名为 “libgit2” 的目录，并在这个目录下初始化一个 .git 文件夹， 从远程仓库拉取下所有数据放入 .git 文件夹，然后从中读取最新版本的文件的拷贝。 如果你进入到这个新建的 libgit2 文件夹，你会发现所有的项目文件已经在里面了，准备就绪等待后续的开发和使用。

如果你想在克隆远程仓库的时候，自定义本地仓库的名字，你可以通过额外的参数指定新的目录名:

$ git clone https://github.com/libgit2/libgit2 mylibgit

记录每次更新到仓库

工作目录中的文件是从真实项目的 git仓库检出的副本，检出的所有文件所属状态都是，已跟踪，未修改的。

工作目录中的文件只会有两种状态 未跟踪，已跟踪（**已跟踪的文件是指那些被纳入了

版本控制的文件 ，就是 Git 已经知道的文件。）—已跟踪又可以分为，已修改，未修改，暂存**。

编辑过某些文件之后，由于自上次提交之后对他们做了修改，Git将它们标记为已修改文件。在工作时，可以选择性地将这些修改的文件放入暂存区，然后提交所有已暂存的修改。

gitStatus.png

可以用 git status 命令查看哪些文件处于什么状态。

不是从 git仓库中检出的文件，而是自己在工作目录中新建的文件都属于 未跟踪 状态，可以执行 git add 命令将这些未被跟踪的文件加入git 追踪的范围。当然已跟踪的文件也可以变为未跟踪状态，需执行 git rm 命令

可以将已经修改的文件或者未跟踪的文件直接执行 git add 暂存企业等待提交

忽略文件

如果我们有一些文件无需git 管理就可以使用忽略文件功能，

$ cat .gitignore
  *.[oa]
  *~

第一行告诉 Git 忽略所有以 .o 或 .a 结尾的文件。一般这类对象文件和存档文件都是编译过程中出现的。 第二行告诉 Git 忽略所有名字以波浪符(~)结尾的文件，许多文本编辑软件(比如 Emacs)都用这样的文件名保存副本。 此外，你可能还需要忽略 log，tmp 或者 pid 目录，以及自动生成的文档等等。 要养成一开始就为你的新仓库设置好 .gitignore 文件的习惯，以免将来误提交这类无用的文件。

文件 .gitignore 的格式规范如下:

• 所有空行或者以 # 开头的行都会被 Git 忽略。 • 可以使用标准的 glob 模式匹配，它会递归地应用在整个工作区中。 • 匹配模式可以以(/)开头防止递归。 • 匹配模式可以以(/)结尾指定目录。 • 要忽略指定模式以外的文件或目录，可以在模式前加上叹号(!)取反。

所谓的 glob 模式是指 shell 所使用的简化了的正则表达式。 星号()匹配零个或多个任意字符;[abc] 匹配 任何一个列在方括号中的字符 (这个例子要么匹配一个 a，要么匹配一个 b，要么匹配一个 c); 问号(?)只 匹配一个任意字符;如果在方括号中使用短划线分隔两个字符， 表示所有在这两个字符范围内的都可以匹配 (比如 [0-9] 表示匹配所有 0 到 9 的数字)。 使用两个星号()表示匹配任意中间目录，比如 a/*/z 可以 匹配 a/z 、 a/b/z 或 a/b/c/z 等。

我们再看一个 .gitignore 文件的例子:

忽略所有的 .a 文件

*.a

但跟踪所有的 lib.a，即便你在前面忽略了 .a 文件

!lib.a

只忽略当前目录下的 TODO 文件，而不忽略 subdir/TODO

/TODO

忽略任何目录下名为 build 的文件夹

build/

忽略 doc/notes.txt，但不忽略 doc/server/arch.txt

doc/*.txt

忽略 doc/ 目录及其所有子目录下的 .pdf 文件

doc/*/.pdf

git commit -m '提交更新'

一般 git commit 之前都要先执行 git add 命令暂存需要提交的文件；但是 git 也提供了直接提交无需先暂存的命令。

git commit -a -m 'added new benchmarks'

提交之前不再需要 git add 文件“CONTRIBUTING.md”了。 这是因为 -a 选项使本次提交包含了所有修改过的文件。 这很方便，但是要小心，有时这个选项会将不需要的文件添加到提交中。

你提交后发现忘记了暂存某些需要的修改，可以像下面这样操作:

 $ git commit -m 'initial commit'
 $ git add forgotten_file
 $ git commit --amend

最终你只会有一个提交——第二次提交将代替第一次提交的结果。

取消刚刚 通过命令 git add CONTRIBUTING.md 暂存的文件；让这个文件变为修改未暂存的状态

git reset HEAD CONTRIBUTING.md

git reset 确实是个危险的命令，如果加上了 --hard 选项则更是如此。 然而在上述场景中，工作目录中的文件尚未修改，因此相对安全一些。

撤消之前对CONTRIBUTING.md文件所做的修改

$ git checkout -- CONTRIBUTING.md

请务必记得git checkout -- <file>是一个危险的命令。你对那个文件在本地的任何修改都会消失——Git 会用最近提交的版本覆盖掉它。 除非你确实清楚不想要对那个文件的本地修改了，否则请不要使用这个命令。

远程仓库的使用

为了能在任意 Git 项目上协作，你需要知道如何管理自己的远程仓库。 远程仓库是指托管在因特网或其他网络中的你的项目的版本库。你可以有好几个远程仓库，通常有些仓库对你只读，有些则可以读写。 与他人协作涉及管理远程仓库以及根据需要推送或拉取数据。 管理远程仓库包括了解如何添加远程仓库、移除无效的远程仓库、管理不同的远程分支并定义它们是否被跟踪等等。

远程仓库可以在你的本地主机上

你完全可以在一个“远程”仓库上工作，而实际上它在你本地的主机上。 词语“远程”未必表示仓库在网络或互联网上的其它位置，而只是表示它在别处。 在这样的远程仓库上工作，仍然需要和其它远程仓库上一样的标准推送、拉取和抓取操作。

如果想查看你已经配置的远程仓库服务器，可以在项目目录下运行 git remote 命令。 它会列出你指定的每一个远程服务器的简写。 如果你已经克隆了自己的仓库，那么至少应该能看到 origin ——这是 Git 给你克隆的仓库服务器的默认 名字:

你也可以指定选项 -v，会显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL。

在本地项目目录中执行 命令 git remote add <shortname> <url> 添加一个新的远程 Git 仓库 即可新建一个远程仓库。

如果执行上述命令的时候仓库名称错误了，就可以执行如下命令修改仓库名称

git remote rename shortname newName

如果因为一些原因想要移除一个远程仓库——你已经从服务器上搬走了或不再想使用某一个特定的镜像了， 又或 者某一个贡献者不再贡献了——可以使用git remote remove或git remote rm: