Git命令快速参考

Git命令快速参考

Git Command Quick Reference / E/ f, q0 c1 n( L- P9 ~( G6 O
; c6 I9 Z& J6 Z3 n' V2 G1 E! X
本附录为Git常见命令快速参考。每节介绍一种操作类型。 9 ^4 c: l1 m# L5 X4 Q! {
这里会列出很多命令，而相应的解释却不多。对于还不熟悉Git的读者，可回头翻阅第1章“Git的版本控制之道”（第3页）。
* K( V3 ?! m/ x: u; m# J, ^6 Z
A.1安装和初始化 . ?+ F/ i  }0 n) V  k/ d* ?
Setup and Initialization 7 P+ C. z! r- q/ m
, o3 v2 d% R4 t2 ]
在使用Git之前，须要先进行配置。在使用一个新的版本库之前，须要先初始化。本节介绍与Git设置和初始化相关的命令。

配置全局用户名和电子邮件地址
prompt> git config --global user.name "Your Name"
prompt> git config --global user.email "[e-mail]"
为特定的版本库配置用户名和电子邮件地址 + x+ s( _0 F. o9 q; s
, k- X8 [2 V0 w% U
注意：你可以为每个版本库单独设置用户名和邮件地址。这使得用户可在不同项目中使用不同的用户名和/或不同的邮件地址。

prompt> cd /path/to/repo
prompt> git config user.name "Your Name"
prompt> git config user.email [e-mail] 4 v1 e; k! [( t* V6 ~9 Z5 y) p% R# i

在命令行中使用不同颜色显示不同内容
prompt> git config --global color.ui "auto"

初始化新版本库
prompt> mkdir /path/to/repo
prompt> cd /path/to/repo
prompt> git init
Initialized empty Git repository in /path/to/repo/.git/
prompt> 6 |* {* D- \3 d0 c  y/ C
... create file(s) for first commit ...
prompt> git add . . o6 n) d' n( y6 H. E$ f  R
prompt> git commit -m 'initial import'
Created initial commit bdebe5c: initial import

1 files changed, 1 insertions(+), 0 deletions(-) : U4 t( X( Q' s0 v5 v! I
5 F+ W- Z5 `2 A, b0 J# _) `
create mode 100644 <some file>
+ q3 Q* ~. ?5 }/ p( c; a- d
克隆版本库 ' |$ i, W/ {& `, `5 J
prompt> git clone <repository url> 3 v( e: x. O. T+ ~
Initialize repo/.git , x  O9 b( l+ l) n7 r8 S5 A3 f
Initialized empty Git repository in /work/<remote repository>/.git/ 3 R+ d( E( y6 Z5 f

将目录中的内容纳入Git版本控制 + |$ X9 M. ?$ P/ b; X/ b
prompt> cd /path/to/existing/directory
prompt> git init
Initialized empty Git repository in /path/to/existing/directory/.git/
prompt> git add .
prompt> git commit -m "initial import of some project" ( x2 [- q) q4 ]: s: S
4 [9 {/ j6 b  Y
在本地版本库中设置远程版本库的别名 , N( x7 a4 l+ I" w# U
... from within the repository directory ... : o8 `7 _8 ~& y1 {2 J# y& K5 L
prompt> git remote add <remote repository> <repository url> * K8 I7 Y- R% t0 v6 _0 H

% W; H2 A) a  `' T$ |3 @0 X9 o
/ K  S3 A* c" L2 s2 C, {+ \
A.2 日常操作 7 h- V5 s# }. j$ g$ D% n
Normal Usage % g6 S8 y# f: V2 O8 N* |2 H7 _
; C; J# r" _9 P3 ?* `' [& t
本节列出Git日常操作命令，对应于第4章“添加与提交：Git基础”（第41页）。 2 w" o; c. F$ r2 Z" x

添加新文件或暂存已有文件上的改动，然后提交
prompt> git add <some file>
prompt> git commit -m "<some message>" / Z: H$ y  H1 u

暂存已有文件上的部分修改 $ W# U! \* W: W5 Z, `+ p
注意： [...] 表示可选参数。

prompt> git add -p [<some file> [<some file> [and so on]]]
选择要提交的文本块…… 1 O$ J7 i: B: `; o9 o/ G
+ |$ e' @4 H, Z. A! m! L* t! o' x
使用交互方式添加文件
prompt> git add -i / F% H; k; E2 f  |  Y* z! ]
& r* {$ L$ s& F' |
暂存已纳入Git版本控制之下的文件的修改 " M' T4 M& x& N! ]; E9 m. w5 ^# \. R
prompt> git add -u [<some path> [<some path>]] " I- ]0 \) r' O( S) B, D, s

提交已纳入Git版本控制之下的文件的所有修改 4 p3 s4 X& u; N  r: A% p$ [! O/ B
prompt> git commit -m "<some message>" -a
/ b+ p2 r: |( @  Q9 w
清除工作目录树中的修改
prompt> git checkout HEAD <some file> [<some file>] ! _; ?- E$ N' u: b
$ N7 `* g8 d* T  j( g8 j# F' y
取消已暂存但尚未提交的修改的暂存标识
prompt> git reset HEAD <some file> [<some file>] 4 R0 e# a. a' E3 T0 j& B# C# @

修复上一次提交中的问题

改动相关文件，并暂存…… ' k; L$ y3 i/ p  L! {3 H
prompt> git commit -m "<some message>" --amend

修复上一次提交中的问题，并复用上次的提交注释
prompt> git commit -C HEAD --amend



A.3 分支 & z* \! ?6 k3 {/ u+ S1 i8 c/ i
Branches % \3 R! L: ~: g* ~1 k
* o% G) @4 |; c3 @( d/ G* A
分支是Git的强项之一。本节介绍关于分支的各个命令。详细内容见第5章“理解和使用分支”（第55页）。 + r4 P- f/ U# Y$ S
- ^) c0 h1 k2 W1 u
列出本地分支 % M/ A$ ?! Q* Y0 {! E; `6 D$ |
prompt> git branch   S/ b$ A5 u6 Y+ P

列出远程分支
prompt> git branch -r ! O8 ?0 z7 y6 F; k) ?
; [3 c& z& U+ l
列出所有分支 " p9 @' i5 n0 U/ f" Z3 d. y
prompt> git branch -a

基于当前分支（的末梢）创建新分支 ) A6 ^0 T" r) `4 n7 p8 C2 D
prompt> git branch <new branch>

检出另一条分支
prompt> git checkout <some branch>

基于当前分支创建新分支，同时检出该分支   ]. T/ N9 i2 m. S  T
prompt> git checkout -b <new branch>

基于另一个起点，创建新分支 - d3 I+ [$ f7 j7 f
你可以从版本库中的任何一个版本开始创建新分支。这个起始点可以用一条已有的分支名称、一个提交名称，或者一个标签名称来表达。 ! _- u8 g0 W1 b: k$ l2 E
prompt> git branch <new branch> <start point>

创建同名新分支，覆盖已有分支
prompt> git branch -f <some existing branch> [<start point>] 6 Q; F# {! v6 O, ~+ z- a) v6 f8 m1 O4 Z

移动或重命名分支
只有当<new branch>不存在时   b1 ]) X: M3 J* t6 A0 R0 j) Y2 e
prompt> git checkout -m <existing branch name> <new branch name> 2 K0 O! Z* `5 o+ ~+ _6 `- L
* a& ^: h# \! @7 u1 w8 d; k
如果<new branch>已存在，就覆盖它 / v% Z1 R( ~2 w2 h; ]# a) a7 o
prompt> git checkout -M <existing branch name> <new branch name> 0 d1 Y0 s, K8 Y# R3 ~  _, S
3 E' B8 B' H' D8 d; S8 ^0 }9 E
把另一条分支合并到当前分支
prompt> git merge <some branch>
) {' O8 U  H+ i# P. U9 ?$ ?5 ^5 Q
合并，但不提交
prompt> git merge --no-commit <some branch>
  ]+ d. v) |8 v+ w- S& e
拣选合并，并且提交 2 k+ @4 e; b' D8 P3 d- ~
prompt> git cherry-pick <commit name> 6 i- u4 K! g# H5 Z* N1 _, U4 _
3 H1 h: u- d" K1 b" `) Z0 G/ Z2 ]
拣选合并，但不提交
prompt> git cherry-pick -n <commit name>

把一条分支上的内容压合到另一条分支（上的一个提交）
prompt> git merge --squash <some branch> / {. V9 G  `& T- S! [8 M

删除分支 9 `" h" R! C3 v1 Q0 g
仅当欲删除的分支已合并到当前分支时
prompt> git branch -d <branch to delete> * u/ \# n; ?0 m: @0 `

不论欲删除的分支是否已合并到当前分支
prompt> git branch -D <branch to delete> ) A4 h& M  _; a& ?; C4 T3 V2 f
. ]* z1 d6 g; F) E& J! x
! c5 |; E6 |- s+ J4 z
1 l0 B/ N5 g: E/ K4 w4 b
A.4 历史 0 f# N" T9 ~4 F
History
3 {. o! U0 M- d. E' W
这些命令用来显示版本库的历史信息，包括代码曾在哪里、谁在何时做了什么、修改的内容及其统计信息。详见第6章“查询Git历史记录”（第71页）。 % r6 j4 W8 e7 V5 ]

显示全部历史记录 ! \& u; |' R* V* u* E0 _1 i
prompt> git log 4 j0 P5 ^$ s5 x9 v; z% `  V
# o/ q7 o% Y2 U# k8 d% ~- s! U) |
显示版本历史，以及版本间的内容差异 6 c9 K& g" a$ o
prompt> git log -p

只显示最近一个提交
prompt> git log -1 ! q1 R- h. z! w; v4 C$ V

显示最近的20个提交，以及版本间的内容差异 9 F! W4 o2 Z  }( N3 S& N: @" I
prompt> git log -20 -p
, i/ `. s) p+ I: D
显示最近6小时的提交
prompt> git log --since="6 hours"

显示两天之前的提交
prompt> git log --before="2 days" 0 l* [9 g1 s2 L4 z

显示比HEAD（当前检出分支的末梢）早3个提交的那个提交 % q6 U: Q3 c7 v" ?7 O
prompt> git log -1 HEAD~3 * ~7 _6 R0 C7 {% N) [8 A
或者……
prompt> git log -1 HEAD^^^ & W9 `. W" Z( x6 r
或者…… % P( \6 B$ j' i. E: J* N5 M
prompt> git log -1 HEAD~1^^

显示两个版本之间的提交
下面命令中的 <start point> 和 <end point> 可以是一个提交名称、分支名称、标签名称，或者它们的混合。 1 k% U, ]2 d4 w; l  r- p
prompt> git log <start point>...<end point> + ?+ }; ^' a2 Z7 r* g3 p* o1 r
: X3 K) k, K; U
显示历史，每个提交显示一行，包括提交注释的第一行
prompt> git log --pretty=oneline 3 Y+ C8 X1 l) J! V, h4 a

显示改动行数统计 * Y+ K/ X; u8 F! X+ N) I
prompt> git log --stat 1 D- g0 b& ^6 I3 M3 V
; z9 ]: [* V8 t1 e% A) [2 _* A
显示改动文件的名称和状态
prompt> git log --name-status
8 W4 L/ F3 a0 Q( k
显示当前工作目录树和暂存区间的差别 / K3 L& g, ?7 j
prompt> git diff

显示暂存区和版本库间的差别 * r" }9 M3 t, G+ O6 F4 {" v% z9 c  o
prompt> git diff --cached
; C' h0 j1 e. O& K" s& p
显示工作目录树和版本库间的差别 - {. \- N- s- K& X0 D
prompt> git diff HEAD

显示工作目录树与版本库中某次提交版本之间的差别 8 x8 n' j3 u, I& t3 x
<start point> 可以是一个提交名称、分支名称或标签名称。 & W( y4 O: b# y
prompt> git diff <start point>

显示版本库中两个版本之间的差别
prompt> git diff <start point> <end point>
1 b7 L+ `* Y! \$ O3 w! i; N
显示差别的相关统计 3 I) v, k8 V, d1 u, C* h
prompt> git diff --stat <start point> [<end point>]

显示文件中各个部分的修改者及相关提交信息
prompt> git blame <some file>

显示文件中各个部分的修改者及相关提交信息，包括在该文件中复制、粘贴和移动内容等方面的情况。
prompt> git blame -M <some file> / j0 o5 f; W7 C6 c8 Y

显示文件中各部分的修改者及相关提交信息，包括在文件间移动内容方面的情况
prompt> git blame -C -C <some file>

显示历史时，显示复制和粘贴信息 : U: @6 a$ i4 {1 @; W$ T; G  S# o
prompt> git log -C -C -p -1 <some point>


# p9 B1 l5 v9 p5 Y9 ~+ ^% ~+ l
A.5 远程版本库
Remote Repositories 7 r2 i' C0 y  @$ q9 a- o
# l3 z; e& O6 ^
开发人员之间通过远程版本库来共享工作成果，相互协作。本节介绍关于这些操作的命令，详见第7章“与远程版本库协作”（第91页）。 ( S. |# v& E6 ]& Q5 @: i
9 U/ Y! j" t9 W/ z6 A7 J
克隆远程版本库
prompt> git clone <some repository> - F' T1 ~8 _$ m& T

克隆远程版本库，但只下载其中最近200个提交的历史记录
prompt> git clone --depth 200 <some repository>

在本地版本库中设置远程版本库的别名
prompt> git remote add <remote repository> <repository url>
  q1 N. r5 R% b: j, Q& k
显示远程分支
prompt> git branch -r % k# ]( Y9 W5 p
$ d6 [7 X/ j3 H$ Q5 {7 h* {
基于远程分支创建本地分支 $ o$ V' \8 o  w. n5 `
prompt> git branch <new branch> <remote branch>

基于远程标签创建本地分支
prompt> git branch <new branch> <remote tag> $ K4 a  {9 z3 ~

从别名为“origin”的远程版本库中取来修改变化，但不合并到本地分支 0 e" Y) U( i/ q2 H
prompt> git fetch & K; H( N, @6 b
# k- a2 L8 q. \( N/ {; X0 l/ ]4 D
从任意的远程版本库中取来修改变化，但不合并到本地分支
prompt> git fetch <remote repository>

从任意的远程版本库中取来修改变化，并合并到当前检出的本地分支 ' d9 U" {7 t  I2 P" q' A' u
prompt> git pull <remote repository>
/ }. R  ^$ c6 D
从别名为“origin”的远程版本库中取来修改变化，并合并到当前检出的本地分支 . w* L+ q* P1 Y
prompt> git pull 7 S) _; [  U% e7 T

把修改变化从本地分支推入远程版本库
prompt> git push <remote repository> <local branch>:<remote branch> / A- U& {5 }  j2 r! u$ @+ R
7 p) {* f8 I6 ]/ r0 V' M
把修改变化从本地分支推入远程版本库中同名分支
prompt> git push <remote repository> <local branch>

把修改变化从本地新建分支推入远程版本库
prompt> git push <remote repository> <local branch>

把修改变化推入别名为“origin”的远程版本库
当远程版本库中已有同名分支时，这个命令会推入本地分支到远程版本库对应的分支中。如果远程版本库中尚无同名分支，则须使用 git push <repository name> <local branch> 。   x) s9 }' g6 Q9 c- O  L# G
prompt> git push - H! _: v& G- \% a6 N: T( r3 \
) y' E& n" ^" F" |' i7 F
在远程版本库中删除分支 2 }4 P4 |5 Z& I6 H% B1 }
prompt> git push <remote repository> :<remote branch> 5 S! l; T" R$ _
" p  a+ t2 a' @+ i. Q
在本地版本库中删除所有远程版本库中已不存在的分支
prompt> git remote prune <remote repository>

在本地版本库中删除某个远程版本库的简称，以及该远程版本库相关的分支
prompt> git remote rm <remote repository>
$ c2 C( j5 s# V; @" w. X! `1 t3 w" b; @5 A
A.6 连接Git和SVN
Git to SVN Bridge 9 X5 w2 D0 `) r4 m; D5 ]

Git可以读取Subversion版本库中的数据，并把本地修改发送回Subversion版本库。这是Git区别于其他版本控制工具的必杀技之一。相关详细介绍请参见第10章“迁移到Git”（第131页）。
克隆SVN版本库的全部内容 5 x4 Z0 p. H6 h* R5 r4 }
prompt> git svn clone <svn repository> 0 D& M: c* C* L% G- r( z5 H

克隆具有标准结构的SVN版本库 1 W9 c  N: m) x& G$ a) c3 {
下面命令适用于克隆标准结构的SVN数据库，也就是说，主干命名为 trunk ，其他分支都存放于 branches 目录下，标签都存放于 tags 目录下。 ; {- W3 h+ D2 i- }0 S
prompt> git svn clone -s <svn repository> 0 P+ E2 h. s) x6 ?3 O* B* @- s

克隆非标准结构的SVN版本库   t: ?; _$ ?# n! r! g: i
prompt> git svn clone -T <trunk path> \
+ p' f7 P  }* M6 g0 X7 p4 r& A9 D
-b <branch path> \

-t <tag path> \

0 Z: k/ ]+ r: v) Q6 r( q/ c
<svn repository>
克隆具有标准结构的SVN版本库中的某个版本（比如第2321版） , R* }" l) u7 {  d
prompt> git svn clone -s -r 2321 ; G# R# j  x& }9 |+ M. W- C

克隆具有标准结构的SVN版本库，并对SVN中的分支添加前缀
prompt> git svn clone -s --prefix svn/ <svn repository>
1 O7 T& [: i& B; i( `) a4 l. f8 U
从上游SVN版本库中获得更新的内容，并依此在本地Git版本库中变基本地分支
prompt> git svn rebase 7 ^7 W' \6 S9 d: D+ @

把修改变化推回上游SVN版本库
prompt> git svn dcommit

列出所有将推入上游SVN版本库的提交 / W1 q1 p( h( X) D5 p6 w
prompt> git svn dcommit -n

显示SVN历史记录 9 h8 [/ y  j1 l) M
prompt> git svn log - E4 b$ r7 a3 A1 S! V$ }  h$ G$ l
8 |, Q5 p6 F# z7 C; i0 q9 Y: z1 }- H
显示文件中各个部分的SVN的修改者及相关提交信息 4 p% C9 X. q) t: O- g4 Y6 ^
prompt> git svn blame <some file>