第 04 天：常用的 Git 版本控管指令

本篇文章将带大家学会几个最重要也最基本的版控工作，其中将包含基本的档案操作如新增、删除、重新命名档案，提交变更 (建立新版本)、查询历史纪录等工作。

准备工作目录

複习一下上一篇「第 03 天：建立储存库」的内容，我们直接来建立一个本地储存库，即可开始本篇文章的所有练习。

mkdir git-demo
cd git-demo
git init

新增档案

我们在工作目录下放一些档案，至于放什麽档案都可以，总之先複製一些现有的档案与目录进到目前的工作目录下。

本篇文章，我将以 YEOMAN 工具，快速产生一个 webapp 范例网站，只要一个指令就可以建立一个完整网站：

yo webapp

注: 关于 YEOMAN 在 Windows 平台的使用，可以参考笔者的文章如何在 Windows 平台安装与使用 Yeoman 1.0 相关工具，该文详述完整的安装与使用过程。

新增了档案之后，如果你还在 Git Shell 介面下，应该会立刻看到如下图的提示：

也就是以下这段位于路径后面的提示：

[master +10 ~0 -0 !]

在这段提示的地方，你可以看到几个东西：

master 代表目前工作目录是 master 分支，也是 Git 的预设分支名称。
「红色」的数字都代表 Untracked (未追踪) 的档案，也就是这些变更都不会进入版本控管。
+10 代表有 10 个「新增」的档案
~0 代表有 0 个「修改」的档案
-0 代表有 0 个「删除」的档案

如果要要将这些新增的档案加入到 Git 版本控管，你必须下达以下指令：

git add .

如此一来，这个工作目录下所有的档案、目录与子目录下的所有档案，全部都会被加入到这个 Git 工作目录的【索引】或【快取】之中。请注意: 此时并没有建立任何版本，只是告知 Git 这些档案「即将」被加入 Git 版本库而已。

如下图示，是我这边执行完 git add . 之后的结果，这裡所发生的 warning 讯息不是很严重，有兴趣了解的人可以参考笔者的另一篇文章: Git 在 Windows 平台处理断行字元 (CRLF) 的注意事项。

不过有趣的地方在于，原本「红色的数字」现在却变成了「绿色的数字」，这裡所代表的意义是：

「绿色」的数字都代表 Staged (准备好) 的档案，也就是这些变更才会进入版本控管。
+23 代表有 23 个「新增」的档案将被建立一个版本
~0 代表有 0 个「修改」的档案将被建立一个版本
-0 代表有 0 个「删除」的档案将被建立一个版本

但原本不是只有 +10 (红色) 而已吗? 怎麽执行完后变成了 +23 (绿色) 呢？

我们执行 git reset 重设一下工作目录的索引状态，然后再执行一次 git status 查询当前工作目录的详细状态，如下图示：

你可以发现，这边列出的只有「第一层目录下的档案与目录」而已，因为 git 不会这个时候去查到底目录下到底有多少档案没有被追踪。

当我们执行 git add . 之后，再执行一次 git status 查询状态，你可以发现连子目录下的档案也都全部被加入了，所以这个数字才会变多，如下图示：

新增部分档案

刚刚提到的 git add . 指令会自动将所有档案(含子目录的档案)加入到工作目录索引中，有时候我们只想让特定目录或特定档案加入版本，这时你也可以指定特定目录，或利用万用字元来加入档案。

我们再执行一次 git reset 重设工作目录的索引状态，然后用 git add app 加入 app 这个资料夹与其下的所有档案，还有用 git add .* 新增所有「点」开头的档案，如下图示：

在执行的过程中，你应该可以发现，在执行 git add 的过程中，Git Shell 提示的文字也有了些变化，现在同时出现了「绿色的数字」与「红色的数字」，所代表的意思跟上述是一样的，是不是非常方便辨识！当你需要知道详情才需要执行 git status 指令。

注: 详细的指令与参数说明，可以输入 git help add 查询完整的文件。

提交变更 / 建立版本

这时我们预计要建立一个新版本了，在建立版本之前，我们还是把所有档案给加入吧，请各位在执行一次 git add . 命令。

建立版本的指令如下：

git commit
git commit -m "版本纪录的说明文字"

在 Git 版本控管中，所有的版本都必须拥有「版本纪录的说明文字」 ( 简称 Log )，不像 Subversion 预设可以签入「没有版本纪录说明」的版本。所以当你直接输入 git commit 的话，预设会开启 Notepad (记事本) 让你输入这个版本的讯息。开启后的档案会有很多 # 符号开头的文字，这些都是注解，不会成为 Log 的一部分。

如下图示，是我输入的讯息文字：