Git's Notes

$ git config --list

$ git config user.name
Scott Chacon

$ git init

$ git add *.c
$ git add README
$ git commit -m 'initial project version'

$ git clone git://github.com/schacon/grit.git

这会在当前目录下创建一个名为“grit”的目录，其中包含一个 .git 的目录，用于保存下载下来的所有版本记录，然后从中取出最新版本的文件拷贝。

如果希望在克隆的时候，自己定义要新建的项目目录名称，可以在上面的命令末尾指定新的名字:

$ git clone git://github.com/schacon/grit.git mygrit

$ git status

$ git add <file> ...

可以创建一个名为 .gitignore 的文件，列出要忽略的文件模式。来看一个实际的例子:

$ cat .gitignore
*.[oa]
*~

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

• 所有空行或者以注释符号 # 开头的行都会被 Git 忽略。
• 可以使用标准的 glob 模式¹匹配。
• 匹配模式最后跟反斜杠(/)说明要忽略的是目录。
• 要忽略指定模式以外的文件或目录，可以在模式前加上惊叹号(!)取反。

git status 的显示比较简单，仅仅是列出了修改过的文件。

如果要查看具体修改了什么地方，可以用 git diff 命令：

$ git diff

此命令比较的是 工作目录中当前文件和暂存区域快照之间的差异 ，也就是修改之后 还没有暂存 起来的变化内容。

若要看 已经暂存 起来的文件和 上次提交 时的快照之间的差异，可以用 git diff –cached 命令 或 git diff –staged 命令，两条命令等效，但后者只在 Git 1.6.1 及更高版本才有。 些。)

$ git diff --cached
或
$ git diff --staged

应该养成的习惯：每次准备提交前，先用 git status 看下，是不是都已暂存起来了，然后再运行提交命令 git commit：

$ git commit

几个有用的参数：

• -v： 将修改差异的每一行都包含到注释中来；
• -m <提交说明>： 在一行命令中提交更新；
• -a： 自动把所有已经跟踪过的文件暂存起来一并提交，从而跳过 git add 步骤。

$ git rm <file> ...

如果删除之前修改过并且已经放到暂存区域的话，则必须要用强制删除选项 -f (译注:即 force 的首字母)，以防误删除文件后丢失修改的内容。

递归匹配删除文件：

git rm \*~

会递归删除当前目录及其子目录中所有 ~ 结尾的文件，注意 * 号前必须得加上反斜杠，否则不会递归匹配。

把文件从 Git 仓库中删除(亦即从暂存区域移除)，但仍然希望保留在当前工作目录中。换句话说，仅是从跟踪清单中删除。比如一些大型日志文件或者一堆 .a 编译文件，不小心纳入仓库后，要移除跟踪但不删除文件，以便稍后在 .gitignore 文件中补上，用 –cached 选项即可

$ git rm --cached <file> ...

$ git mv file_from file_to

其实，运行 git mv 就相当于运行了下面三条命令:

$ mv README.txt README
$ git rm README.txt
$ git add README

选项	说明
-p	按补丁格式显示每个更新之间的差异。
–stat	显示每次更新的文件修改统计信息。
–shortstat	只显示–stat中最后的行数修改添加移除统计。
–name-only	仅在提交信息后显示已修改的文件清单。
–name-status	显示新增、修改、删除的文件清单。
–abbrev-commit	仅显示 SHA-1 的前几个字符，而非所有的40个字符。
–relative-date	使用较短的相对时间显示(比如，“2 weeks ago" )。
–graph	显示ASCII图形表示的分支合并历史。
–pretty	使用其他格式显示历史提交信息。可用的选项包括oneline，short，full，fuller和format(后跟指定格式)。

使用–pretty 选项，可以指定使用完全不同于默认格式的方式展示提交历史。比如用 oneline 将每个提交放在一行显示，这在提交数很大时非常有用。可选值包括：

• oneline
• short
• full
• fuller
• format： 可以定制要显示的记录格式，这样的输出便于后期编程提取分析，常用的格式占位符写法及其代表的意义：

  选项	说明
  %H	提交对象(commit)的完整哈希字串
  %h	提交对象的简短哈希字串
  %T	树对象(tree)的完整哈希字串
  %t	树对象的简短哈希字串
  %P	父对象(parent)的完整哈希字串
  %p	父对象的简短哈希字串
  %an	作者(author)的名字
  %ae	作者的电子邮件地址
  %ad	作者修订日期(可以用 -date=选项定制格式)
  %ar	作者修订日期，按多久以前的方式显示
  %cn	提交者(committer)的名字
  %ce	提交者的电子邮件地址
  %cd	提交日期
  %cr	提交日期，按多久以前的方式显示
  %s	提交说明

git log 还有许多非常实用的限制输出长度的选项：

选项	说明
-(n)	仅显示最近的n条提交
–since，–after	仅显示指定时间之后的提交。
–until，–before	仅显示指定时间之前的提交。
–author	仅显示指定作者相关的提交。
–committer	仅显示指定提交者相关的提交。

示例 查看 Git 仓库中，2008 年 10 月期间，Junio Hamano 提交的但未合并的测试脚本（位于项目的 t/ 目录下的文件）：

$ git log --pretty="%h - %s" --author=gitster --since="2008-10-01" --before="2008-11-01" --no-merges -- t/

$ git commit --amend

$ git reset HEAD <file>... 

$ git checkout <file> ...

git remote

如果加上 -v 选项(译注:此为 –verbose 的简写，取首字母)，还可以显示对应的克隆地址：

$ git remote -v

$ git remote add [shortname] [url]

$ git fetch [remote-name]

此命令会到远程仓库中拉取所有你本地仓库中还没有的数据。运行完成后，你就可以在本地访问该远程仓库中的所有分支，将其中某个分支合并到本地，或者只是取出某个分支，一探究竟。

如果是克隆了一个仓库，此命令会自动将远程仓库归于 origin 名下。所以，git fetch origin 会抓取从你上次克隆以来别人上传到此远程仓库中的所有更新（或是上次 fetch 以 来别人提交的更新）。有一点很重要，需要记住，fetch 命令只是将远端的数据拉到本地仓库，并不自动合并到当前工作分支，只有当你确实准备好了，才能手工合并。

如果设置了某个分支用于跟踪某个远端仓库的分支(参见下节及第三章的内容)，可以使用 git pull 命令自动抓取数据下来，然后将远端分支自动合并到本地仓库中当前分支。在日常工作中我们经常这么用，既快且好。

$ git push [remote-name] [branch-name]

$ git remote show [remote-name] 

$ git remote rename [remote-name-old] [remote-name-new]

$ git remote rm  [remote-name]

$ git tag

以Git自身项目仓库为例，如果你只对Git仓库的某个系列（例如1.4.2系列）的版本感兴趣，可以运行下列的命令：

$ git tag -l 'v1.4.2.*'

• 创建轻量级标签

$ git tag v1.4

• 创建含附注标签

  创建一个含附注类型的标签非常简单，用 -a (译注：取 annotated 的首字母)指定标签名字即可：

$ git tag -a v1.4 -m 'my version 1.4'

可以使用 git show 命令查看相应标签的版本信息，并连同显示打标签时的提交对象。

我们可以看到在提交对象信息上面，列出了此标签的提交者和提交时间，以及相应的标签说明。

如果你有自己的私钥，还可以用 GPG 来签署标签，只需要把之前的 -a 改为 -s (译注：取 signed 的首字母)即可：

$ git tag -s v1.5 -m 'my signed 1.5 tag'

可以使用 git tag -v [tag-name] (译注:取 verify 的首字母)的方式验证已经签署的标签。此命令会调用 GPG 来验证签名，所以你 需要有签署者的公钥 ，存放在 keyring 中，才能验证：

$ git tag -v v1.4.2.1

你甚至可以在后期对早先的某次提交加注标签。只要在打标签的时候跟上对应提交对象的校验和(或前几位字符)即可：

$ git tag -a v1.2 9fceb02

默认情况下，git push 并不会把标签传送到远端服务器上，只有通过显式命令才能分享标签到远端仓库。其命令格式如同推送分支，运行 git push origin [tagname] 即可：

$ git push origin --tags

如果你用的是 Bash shell，可以试试看 Git 提供的自动完成脚本。下载 Git 的源代码，进入 contrib/completion 目录，会看到一个 git-completion.bash 文件。将此文件复制到你自己的用户主目录中(译注:按照下面的示例，还应改名加上点:cp git-completion.bash ~/.git-completion.bash)，并把下面一行内容添加到你的 .bashrc 文件中:

source ~/.git-completion.bash

也可以为系统上所有用户都设置默认使用此脚本。Mac 上将此脚本复制到 opt/local/etc/bash_completion.d 目录中， Linux 上则复制到 /etc/bash_completion.d 目录中。这两处目录中的脚本，都会在 Bash 启动时自动加载。 如果在 Windows 上安装了 msysGit，默认使用的 Git Bash 就已经配好了这个自动完成脚本，可以直接使用。

Git 并不会推断你输入的几个字符将会是哪条命令，不过如果想偷懒，少敲几个命令的字符，可以用 git config 为命令设置别名。来看看下面的例子:

$ git config --global alias.co checkout
$ git config --global alias.br branch
$ git config --global alias.ci commit
$ git config --global alias.st status

现在，如果要输入 git commit 只需键入 git ci 即可。而随着 Git 使用的深入，会有很多经常要用到的命令，遇到这种情况，不妨建个别名提高效率。 使用这种技术还可以创造出新的命令，比方说取消暂存文件时的输入比较繁琐，可以自己设置一下:

$ git config --global alias.unstage 'reset HEAD --'

这样一来，下面的两条命令完全等同：

$ git unstage fileA
$ git reset HEAD fileA

显然，使用别名的方式看起来更清楚。另外，我们还经常设置 last 命令:

$ git config --global alias.last 'log -1 HEAD'

然后要看最后一次的提交信息，就变得简单多了:

$ git last

可以看出，实际上 Git 只是简单地在命令中替换了你设置的别名。不过有时候我们希望运行某个外部命令，而非 Git 的附属工具，这个好办，只需要在命令前加上 ! 就行。如果你自己写了些处理 Git 仓库信息的脚本的话，就可以用这种技术包装起来。作为演示，我们可以设置用 git visual 启动 gitk

$ git config --global alias.visual "!gitk"

$ git branch
iss53
* master
testing

注意看 master 分支前的 * 字符:它表示当前所在的分支。也就是说，如果现在提交更 新，master 分支将随着开发进度前移。若要查看各个分支最后一个提交对象的信息，运行 git branch -v:

$ git branch -v

要从该清单中筛选出你已经(或尚未)与当前分支合并的分支，可以用 –merge 和 –no-merged 选项(Git 1.5.6 以上版本)。