开发者日常使用的 Git 命令

这些命令分四种类型：①不需要和其他开发者协作的独立开发者，会经常用到 git init、git show branch、git commit 等命令；②需要和其他人协作的开发者，会常用到 git clone、git push、git pull、git format patch 。③在项目中负责接收其他开发者发来更新的核心开发者，会常用到 git am、git pull、git
format patch、git revert、git push；④ 代码仓库管理员常用 git daemon、git shell……
对于任何想做提交的人来说，甚至对于某位单独工作的人来说，【个人开发者（单独开发）】部分命令都是必不可少的。如果你和别人一起工作，你也会需要【个人开发者（参与者）】部分列出的命令。
除了上述的部分，担当【集成人员】角色的人需要知道更多命令。【代码库管理】命令帮助系统管理员负责管理，及向git代码库提交内容。
 
个人开发者（单独开发）
单独的个人开发者不会与他人交换修补程序，只用到下列命令，独自在单独的代码库上工作：

git-init(1)用来创建新代码库。

git-show-branch(1)用来查看你在哪里。

git-log(1)查看发生过什么。

git-checkout(1)和git-branch(1)用来切换分支。

git-add(1)用来管理索引文件。

git-diff(1)和git-status(1)查看你正在做什么。

git-commit(1)将内容推进现分支

git-reset(1)和git-checkout(1)（带路径名
参数）放弃修改。

git-merge(1)用来合并本地分支

git-rebase(1)用来维护主题分支

git-tag(1)用来给已知点打标签
实例
用Tar包作为一个新代码库的起始点
Shell
$ tar zxf frotz.tar.gz $ cd frotz $ git init $ git add . <1> $ git commit -m "import of frotz source tree." $ git tag v2.43 <2>

1 2 3 4 5 6

$ tar zxf frotz.tar.gz $ cd frotz $ git init $ git add . <1> $ git commit -m "import of frotz source tree." $ git tag v2.43 <2>

添加现目录下的所有文件。

打一个轻量的无注释的标签。
创建一个主题分支并开发
Shell
$ git checkout -b alsa-audio <1> $ edit/compile/test $ git checkout -- curses/ux_audio_oss.c <2> $ git add curses/ux_audio_alsa.c <3> $ edit/compile/test $ git
diff HEAD <4> $ git commit -a -s <5> $ edit/compile/test $ git reset --soft HEAD^ <6> $ edit/compile/test $ git diff ORIG_HEAD <7> $ git commit -a -c ORIG_HEAD <8> $ git checkout master <9> $ git merge alsa-audio <10> $ git log --since='3 days ago' <11> $
git log v2.43.. curses/ <12>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

$ git checkout -b alsa-audio <1> $ edit/compile/test $ git checkout -- curses/ux_audio_oss.c <2> $ git add curses/ux_audio_alsa.c <3> $ edit/compile/test $ git diff HEAD <4> $ git commit -a -s <5> $ edit/compile/test $ git reset --soft HEAD^ <6> $ edit/compile/test $ git diff ORIG_HEAD <7> $ git commit -a -c ORIG_HEAD <8> $ git checkout master <9> $ git merge alsa-audio <10> $ git log --since='3 days ago' <11> $ git log v2.43.. curses/ <12>

创建一个主题分支。

还原你在curses/ux_audio_oss.c文件里搞砸了的修改。

如果你要添加一个新文件是，你需要告诉git；之后，如果你使用git commit -a， 删除和修改就会被捕获。

查看你正在提交什么修改。

提交你已签署了的所有已测试文件。

退回到上一个提交，并保留工作树。

查看自从上一个不成熟提交后的修改。

使用原先写过的信息，重做在之前步骤中撤销了的提交。

切换到主干分支。

把主题分支合并到你的主分支。

回顾提交记录；其他限制输出的形式也可以合并包含： –max-count=10(显示10个提交)，–until=2005-12-10等

只查看影响到在curses/目录里，从v2.43标签开始的修改。
 
个人开发者（参与开发）
作为在一个团体项目里参与角色的开发人员，需要学习如何与他人沟通，除了那些单独开发者需要掌握的命令以外，还要使用这些命令。

git-clone(1)从上游代码库填充你的本地代码库。

git-pull(1)和git-fetch(1)从“origin”得到最新的上游代码库。

git-push(1)用来共享代码库，如果你采用cvs风格的代码库工作流的话。

git-format-patch(1)用来准备e-mail提交，如果你使用Linux内核风格的公共论坛工作流的话。
实例
复制上游代码库并在其之上工作。提交修改到上游代码库
Shell
$ git clone git://git.kernel.org/pub/scm/.../torvalds/linux-2.6 my2.6

1	$ git clone git://git.kernel.org/pub/scm/.../torvalds/linux-2.6 my2.6

Shell
$ cd my2.6 $ edit/compile/test; git commit -a -s <1> $ git format-patch origin <2> $ git pull <3> $ git log -p ORIG_HEAD.. arch/i386 include/asm-i386 <4> $ git
pull git://git.kernel.org/pub/.../jgarzik/libata-dev.git ALL <5> $ git reset --hard ORIG_HEAD <6> $ git gc <7> $ git fetch --tags <8>

1 2 3 4 5 6 7 8 9

$ cd my2.6 $ edit/compile/test; git commit -a -s <1> $ git format-patch origin <2> $ git pull <3> $ git log -p ORIG_HEAD.. arch/i386 include/asm-i386 <4> $ git pull git://git.kernel.org/pub/.../jgarzik/libata-dev.git ALL <5> $ git reset --hard ORIG_HEAD <6> $ git gc <7> $ git fetch --tags <8>

按需重复。

从你的分支中提取补丁文件，用于电子邮件提交。

git pull命令默认从“origin”里取得内容并合并到当前的分支中去。

在拉过内容之后，立即查看在上游仓库中从上次我们检查过之后提交的修改，只检查我们关心的区域。

从一个指定代码库的一个指定分支获取内容并合并。

撤销拉操作。

从撤销的拉操作中回收残存的对象。

不时地，从origin处获取官方的标签，并保存于.git/refs/tags/ 。
推进另一个代码库
Shell
satellite$ git clone mothership:frotz frotz <1> satellite$ cd frotz satellite$ git config --get-regexp '^(remote|branch)\.' <2> remote.origin.url mothership:frotz
remote.origin.fetch refs/heads/*:refs/remotes/origin/* branch.master.remote origin branch.master.merge refs/heads/master satellite$ git config remote.origin.push \ master:refs/remotes/satellite/master <3> satellite$ edit/compile/test/commit satellite$ git
push origin <4> mothership$ cd frotz mothership$ git checkout master mothership$ git merge satellite/master <5>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

satellite$ git clone mothership:frotz frotz <1> satellite$ cd frotz satellite$ git config --get-regexp '^(remote|branch)\.' <2> remote.origin.url mothership:frotz remote.origin.fetch refs/heads/*:refs/remotes/origin/* branch.master.remote origin branch.master.merge refs/heads/master satellite$ git config remote.origin.push \ master:refs/remotes/satellite/master <3> satellite$ edit/compile/test/commit satellite$ git push origin <4> mothership$ cd frotz mothership$ git checkout master mothership$ git merge satellite/master <5>

mothership机器在你的home目录下有一个frotz代码库；将它复制，以在satellite机器上启动一个代码库。

复制操作默认设定这些配置变量。它安排git pull去抓取并保存mothership机上的分支到本地的remotes/origin/* 的跟踪分支上。

安排git push去推送本地的主分支到mothership机的remotes/satellite/master分支

推操作会在mothership机的remotes/satellite/master的远程跟踪分支上收藏我们的工作。你可以用此作为一个备用方法。

在mothership机上，将satellite机上已完成的工作合并到master分支去。
分支的特定标签
Shell
$ git checkout -b private2.6.14 v2.6.14 <1> $ edit/compile/test; git commit -a $ git checkout master $ git format-patch -k -m --stdout v2.6.14..private2.6.14
| git am -3 -k <2>

1 2 3 4 5

$ git checkout -b private2.6.14 v2.6.14 <1> $ edit/compile/test; git commit -a $ git checkout master $ git format-patch -k -m --stdout v2.6.14..private2.6.14 | git am -3 -k <2>

创建一个私有分支，基于熟知（但稍许过时的）标签。

在没有正式的“合并”下，向前移植所有private2.6.14分支的修改到master分支上。
集成人员
在一个团队项目中担任集成者的是一名相当重要的人员，他接受别人的修改，评审并且集成并且发布结果，供他人使用；除了那些参与者需要的命令之外，还会使用这些命令。

git-am(1)用来采用你的贡献者发电邮寄来的补丁文件。

git-pull(1)用来从你的可信任的助手处合并内容。

git-format-patch(1)用来准备并向你的贡献者发送建议选项。

git-revert(1)用来撤销不好的提交。

git-push(1)用来发布最新的内容。
实例
我典型的GIT一天。
Shell
$ git status <1> $ git show-branch <2> $ mailx <3> s 2 3 4 5 ./+to-apply s 7 8 ./+hold-linus q $ git checkout -b topic/one master $ git am -3 -i -s -u ./+to-apply
<4> $ compile/test $ git checkout -b hold/linus && git am -3 -i -s -u ./+hold-linus <5> $ git checkout topic/one && git rebase master <6> $ git checkout pu && git reset --hard next <7> $ git merge topic/one topic/two && git merge hold/linus <8> $ git checkout
maint $ git cherry-pick master~4 <9> $ compile/test $ git tag -s -m "GIT 0.99.9x" v0.99.9x <10> $ git fetch ko && git show-branch master maint 'tags/ko-*' <11> $ git push ko <12> $ git push ko v0.99.9x <13>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

$ git status <1> $ git show-branch <2> $ mailx <3> s 2 3 4 5 ./+to-apply s 7 8 ./+hold-linus q $ git checkout -b topic/one master $ git am -3 -i -s -u ./+to-apply <4> $ compile/test $ git checkout -b hold/linus && git am -3 -i -s -u ./+hold-linus <5> $ git checkout topic/one && git rebase master <6> $ git checkout pu && git reset --hard next <7> $ git merge topic/one topic/two && git merge hold/linus <8> $ git checkout maint $ git cherry-pick master~4 <9> $ compile/test $ git tag -s -m "GIT 0.99.9x" v0.99.9x <10> $ git fetch ko && git show-branch master maint 'tags/ko-*' <11> $ git push ko <12> $ git push ko v0.99.9x <13>

查看我正在做什么，如果有的话。

查看我拥有的主题分支，并考虑它们的完成度。

读邮件，保存合适的，并且保存那些尚未完成的。

采用它们，交互式地，带着我的签名。

按需创建主题分支，还是由我签名采用。

为内部的还未合并到主分支，也没有作为稳定分支的一部分公开的主题分支重定基线。

从接下来开始，每次都重启pu。

合并仍然在料理中的主题分支

向后移植极其重要的修正。

创建一个签名的标签。

确保我不会意外将主分支回滚到我已经推出来的内容。简写的ko指向我在kernel.org上已有的代码库里，看起来像这样：
Shell
$ cat .git/remotes/ko URL: kernel.org:/pub/scm/git/git.git Pull: master:refs/tags/ko-master Pull: next:refs/tags/ko-next Pull: maint:refs/tags/ko-maint Push:
master Push: next Push: +pu Push: maint

1 2 3 4 5 6 7 8 9

$ cat .git/remotes/ko URL: kernel.org:/pub/scm/git/git.git Pull: master:refs/tags/ko-master Pull: next:refs/tags/ko-next Pull: maint:refs/tags/ko-maint Push: master Push: next Push: +pu Push: maint

在从git show-branch的输出里，主分支应该有所有ko-master有的，并且next应该有ko-next有的所有内容。

推出最新内容

也推标签
代码库管理
代码库管理员使用下列工具来设置及维护开发者对代码库的访问。

git-daemon(1)允许匿名者从代码库下载

git-shell(1)可以被用作为限制登录shell，用于共享中央代码库的用户
update hook howto有一个很好的管理共享中央代码库的实例。
实例
我们假设下面的内容均在/etc/services目录下。
Shell
$ grep 9418 /etc/services git 9418/tcp # Git Version Control System

1 2	$ grep 9418 /etc/services git 9418/tcp # Git Version Control System

从inetd运行git-daemon来服务于/pub/scm
$ grep git /etc/inetd.conf git stream tcp nowait nobody \ /usr/bin/git-daemon git-daemon --inetd --export-all /pub/scm

1 2 3

$ grep git /etc/inetd.conf git stream tcp nowait nobody \ /usr/bin/git-daemon git-daemon --inetd --export-all /pub/scm

实际的配置应该在1行里。
从xinetd运行git-daemon来服务于/pub/scm
Shell
$ cat /etc/xinetd.d/git-daemon # default: off # description: The git server offers access to git repositories service git { disable = no type = UNLISTED port
= 9418 socket_type = stream wait = no user = nobody server = /usr/bin/git-daemon server_args = --inetd --export-all --base-path=/pub/scm log_on_failure += USERID }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

$ cat /etc/xinetd.d/git-daemon # default: off # description: The git server offers access to git repositories service git { disable = no type = UNLISTED port = 9418 socket_type = stream wait = no user = nobody server = /usr/bin/git-daemon server_args = --inetd --export-all --base-path=/pub/scm log_on_failure += USERID }

检查xinetd(8)文档并设置，这个文档来自于Fedora系统。其他也许会不一样。
授予开发者只推/拉访问操作权限。
$ grep git /etc/passwd <1> alice:x:1000:1000::/home/alice:/usr/bin/git-shell bob:x:1001:1001::/home/bob:/usr/bin/git-shell cindy:x:1002:1002::/home/cindy:/usr/bin/git-shell
david:x:1003:1003::/home/david:/usr/bin/git-shell $ grep git /etc/shells <2> /usr/bin/git-shell

1 2 3 4 5 6 7

$ grep git /etc/passwd <1> alice:x:1000:1000::/home/alice:/usr/bin/git-shell bob:x:1001:1001::/home/bob:/usr/bin/git-shell cindy:x:1002:1002::/home/cindy:/usr/bin/git-shell david:x:1003:1003::/home/david:/usr/bin/git-shell $ grep git /etc/shells <2> /usr/bin/git-shell

登录shell被设置到/usr/bin/git-shell, 不允许git push和git pull以外的任何操作。用户应该会获得一个访问此机器的ssh权限。

在许多发布版本中，/etc/shells需要列出作为一个登录shell需要的内容。
CVS风格的共享代码库
Shell
$ grep git /etc/group <1> git:x:9418:alice,bob,cindy,david $ cd /home/devo.git $ ls -l <2> lrwxrwxrwx 1 david git 17 Dec 4 22:40 HEAD -> refs/heads/master
drwxrwsr-x 2 david git 4096 Dec 4 22:40 branches -rw-rw-r-- 1 david git 84 Dec 4 22:40 config -rw-rw-r-- 1 david git 58 Dec 4 22:40 description drwxrwsr-x 2 david git 4096 Dec 4 22:40 hooks -rw-rw-r-- 1 david git 37504 Dec 4 22:40 index drwxrwsr-x 2 david
git 4096 Dec 4 22:40 info drwxrwsr-x 4 david git 4096 Dec 4 22:40 objects drwxrwsr-x 4 david git 4096 Nov 7 14:58 refs drwxrwsr-x 2 david git 4096 Dec 4 22:40 remotes $ ls -l hooks/update <3> -r-xr-xr-x 1 david git 3536 Dec 4 22:40 update $ cat info/allowed-users
<4> refs/heads/master alice\|cindy refs/heads/doc-update bob refs/tags/v[0-9]* david

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

$ grep git /etc/group <1> git:x:9418:alice,bob,cindy,david $ cd /home/devo.git $ ls -l <2> lrwxrwxrwx 1 david git 17 Dec 4 22:40 HEAD -> refs/heads/master drwxrwsr-x 2 david git 4096 Dec 4 22:40 branches -rw-rw-r-- 1 david git 84 Dec 4 22:40 config -rw-rw-r-- 1 david git 58 Dec 4 22:40 description drwxrwsr-x 2 david git 4096 Dec 4 22:40 hooks -rw-rw-r-- 1 david git 37504 Dec 4 22:40 index drwxrwsr-x 2 david git 4096 Dec 4 22:40 info drwxrwsr-x 4 david git 4096 Dec 4 22:40 objects drwxrwsr-x 4 david git 4096 Nov 7 14:58 refs drwxrwsr-x 2 david git 4096 Dec 4 22:40 remotes $ ls -l hooks/update <3> -r-xr-xr-x 1 david git 3536 Dec 4 22:40 update $ cat info/allowed-users <4> refs/heads/master alice\|cindy refs/heads/doc-update bob refs/tags/v[0-9]* david

把开发者置于同一git组中。

将共享代码库配为可被组写。

使用Carl的update-hook实例，这个实例在Documentation/howto/， 讲述了分支策略控制。

alice和cindy可以推送到主分支，只有bob可以推送进doc-update。david是发布经理，并且是唯一一位可以创建并推送版本标签的人。
支持dumb协议传送的HTTP服务器
Shell
dev$ git update-server-info <1> dev$ ftp user@isp.example.com <2> ftp> cp -r .git /home/user/myproject.git

1 2 3

dev$ git update-server-info <1> dev$ ftp user@isp.example.com <2> ftp> cp -r .git /home/user/myproject.git

确保你的info/refes和objects/info/packs是最新的。

上传到由你的ISP拥有的公共HTTP服务器。