Git命令快速参考

本附录为Git常见命令快速参考。每节介绍一种操作类型。
这里会列出很多命令，而相应的解释却不多。对于还不熟悉Git的读者，可回头翻阅第1章“Git的版本控制之道”（第3页）。
  m% B+ q. Y9 x. [% |
A.1安装和初始化8 ^4 u  u; e+ S/ L# X+ J6 @
Setup and Initialization; Q9 J: A: @, M0 `5 [3 z

在使用Git之前，须要先进行配置。在使用一个新的版本库之前，须要先初始化。本节介绍与Git设置和初始化相关的命令。
- h6 z. F/ h. z# w3 h
配置全局用户名和电子邮件地址
prompt> git config --global user.name "Your Name"
prompt> git config --global user.email "[e-mail]"
为特定的版本库配置用户名和电子邮件地址
* V2 v4 }8 o( C* a7 Z
注意：你可以为每个版本库单独设置 用户名和邮件地址。这使得用户可在不同项目中使用不同的用户名和/或不同的邮件地址。. F5 r) F- e' b% d

prompt> cd /path/to/repo; B( c% b. z8 |& X
prompt> git config user.name "Your Name"
prompt> git config user.email [e-mail]
9 a% l* Q$ z- S# e
在命令行中使用不同颜色显示不同内容+ D9 C3 \9 E, B9 n) P5 e/ H
prompt> git config --global color.ui "auto"

初始化新版本库
prompt> mkdir /path/to/repo4 q1 f6 Y: N! S/ N
prompt> cd /path/to/repo
prompt> git init
Initialized empty Git repository in /path/to/repo/.git/5 B) I7 h$ H1 h7 P
prompt>) `; D, f8 B* r$ L; F0 o
... create file(s) for first commit ...- h2 e  o9 l" D6 e+ X8 u7 s$ [
prompt> git add .( V6 C( @+ ^5 y$ r- K
prompt> git commit -m 'initial import'
Created initial commit bdebe5c: initial import4 R# E) s, R! Z& C$ O: {

1 files changed, 1 insertions(+), 0 deletions(-). L4 X9 S$ q: Z+ }5 F+ F
, I5 p2 |) |- [+ C" k" q
create mode 100644 & [" r/ `( v, f7 G8 }  `! b- k

克隆版本库
prompt> git clone 0 c- p  L( R# h- u& c5 c. z$ y
Initialize repo/.git
Initialized empty Git repository in /work//.git/

将目录中的内容纳入Git版本控制
prompt> cd /path/to/existing/directory
prompt> git init4 Y! k4 ?5 e* N3 @- L8 S
Initialized empty Git repository in /path/to/existing/directory/.git/
prompt> git add .
prompt> git commit -m "initial import of some project"1 q7 o- t. W) w/ X' b

在本地版本库中设置远程版本库的别名( g7 b; j9 t6 z  ?( o+ z% ^6 x  ^' b+ ?
... from within the repository directory ...
prompt> git remote add ( H  ?8 |5 s- t2 D8 P+ B
, t* n1 ]9 U0 }
9 n4 u9 [/ h. g

A.2 日常操作/ j. W: c. `+ Q; a8 {+ h  {# J
Normal Usage. R" i. ]6 T. O( O2 T2 ^5 d
  M: g/ E& A4 J% B6 A
本节列出Git日常操作命令，对应于第4章“添加与提交：Git基础”（第41页）。

添加新文件或暂存已有文件上的改动，然后提交
prompt> git add
prompt> git commit -m ""

暂存已有文件上的部分修改
注意：[...]表示可选参数。* k1 M8 k: A6 |) S& U" S

prompt> git add -p [ [ [and so on]]]
选择要提交的文本块……

使用交互方式添加文件
prompt> git add -i

暂存已纳入Git版本控制之下的文件的修改
prompt> git add -u [ []]( b  M! [8 E& m7 u% G
2 l, D' y" p9 |8 O+ |; e' d
提交已纳入Git版本控制之下的文件的所有修改) @( |% T# R) c# M( F( u
prompt> git commit -m "" -a
% F2 F  p( ~$ v1 W/ N0 |  W
清除工作目录树中的修改- y/ a3 {9 l* ]- V" |3 j+ s
prompt> git checkout HEAD []
% `$ d; R8 {; A* ?) t# `
取消已暂存但尚未提交的修改的暂存标识
prompt> git reset HEAD []

修复上一次提交中的问题9 h: k3 j7 W! o# k. n

改动相关文件，并暂存……
prompt> git commit -m "" --amend8 ^" J& {+ Z( V6 g

修复上一次提交中的问题，并复用上次的提交注释* l- f* O0 E# s
prompt> git commit -C HEAD --amend
$ x: s+ H- j1 N. R7 t8 U
" _; X3 U" E' X8 d+ [  p: t

A.3 分支& E5 L7 Y' J% _$ x  O
Branches

分支是Git的强项之一。本节介绍关于分支的各个命令。详细内容见第5章“理解和使用分支”（第55页）。, j0 S; L& W0 `( s

列出本地分支' P& K% x! T( k5 {  a  \' S
prompt> git branch! s8 E" f! Q6 h* O0 `) L1 {

列出远程分支
prompt> git branch -r( J' J) h) @$ r6 o* E  z

列出所有分支
prompt> git branch -a  ~* }& P4 m  o, P8 y
, r8 q1 h0 t8 X0 Z* X
基于当前分支（的末梢）创建新分支% ?7 e% @9 f) P8 r
prompt> git branch / Q# L- }# ?& j% l$ B6 `7 e1 s

检出另一条分支& D: f& \, f! w1 y: {
prompt> git checkout 8 k. k0 t( e) W# |, e- L# t' Y
1 K$ _. T- E0 S! J( x
基于当前分支创建新分支，同时检出该分支. U) n" y/ X& E
prompt> git checkout -b * p/ a' v7 Y5 h( c

基于另一个起点，创建新分支0 ?: T9 l. G+ L
你可以从版本库中的任何一个版本开始创建新分支。这个起始点可以用一条已有的分支名 称、一个提交名称，或者一个标签名称来表达。
prompt> git branch , i: }5 s! t3 D+ K; g

创建同名新分支，覆盖已有分支
prompt> git branch -f []" g  V; x, }6 k! |

移动或重命名分支/ J# i3 \+ v0 ]) A
只有当<new branch>不存在时8 O' s" |0 `( k* {, J
prompt> git checkout -m 3 B# w! {9 m1 S; M  |4 h) ~" q1 v+ g
6 @3 x& J1 w' r4 A" p4 p: h
如果<new branch>已存在，就覆盖它) t' o( M: S1 G& J1 G: D& q
prompt> git checkout -M 4 @1 ]" {' s, A7 H) t: I, @) W6 \
2 m' {* v& e7 Y6 F8 D" g& h
把另一条分支合并到当前分支) p5 w# i; l% B! H
prompt> git merge
3 y5 ~. {/ ?! S" J0 L* x0 J/ o
合并，但不提交
prompt> git merge --no-commit ( O4 h8 b( E. @' m

拣选合并，并且提交( u& ^3 X4 q5 u$ e7 w# U1 X1 B
prompt> git cherry-pick , n5 C! G( g, C8 w  U6 z4 X' k

拣选合并，但不提交! `, N2 c$ s* h7 k$ S  \
prompt> git cherry-pick -n

把一条分支上的内容压合到另一条分支（上的一个提交）
prompt> git merge --squash / j  o* P4 ~! r4 G8 ^

删除分支
仅当欲删除的分支已合并到当前分支时
prompt> git branch -d

不论欲删除的分支是否已合并到当前分支
prompt> git branch -D , Q& {6 N1 }# i: i* H; r7 ^


5 V! ?( F3 ?7 L- g1 ]
A.4 历史
History
: h5 z5 o) x* d" `2 p( y$ o. V. |
这些命令用来显示版本库的历史信息，包括代码曾在哪里、谁在何时做了什么、修改的内容 及其统计信息。详见第6章 “查询Git历史记录” （第71页）。

显示全部历史记录1 n2 K/ B3 I, C* G
prompt> git log
; n, ^  _* A' y9 V6 }5 X/ P
显示版本历史，以及版本间的内容差异
prompt> git log -p
- Z5 D7 V1 f, k; K+ w( h
只显示最近一个提交5 y% \4 Q% t' h; G" l" i
prompt> git log -1$ F6 E( V) h) {% Y% n$ H4 W* E

显示最近的20个提交，以及版本间的内容差异
prompt> git log -20 -p8 T/ e( {+ ]0 B$ @. c0 s

显示最近6小 时的提交* g" F8 f- _2 u# D6 R0 V
prompt> git log --since="6 hours"

显示两天之前的提交
prompt> git log --before="2 days"

显示比HEAD（当前检出分支的末梢）早3个提交的那个提交$ \8 d+ P) N; w0 [9 ?+ @) E
prompt> git log -1 HEAD~3" _% V. U0 C* Z% _, a/ v9 S0 ?: K+ c& s
或者……
prompt> git log -1 HEAD^^^
或者……
prompt> git log -1 HEAD~1^^* t9 k: z) z# @/ l6 j
0 t1 Z; o2 h0 G8 t: ]" C/ C
显示两个版本之间的提交
下面命令中的和可以是一个提交名称、分支名称、标签名称，或者它们的混合。
prompt> git log ...
8 @. R; v/ v0 l/ p+ I# y
显示历史，每个提交显示一行，包括提交注释的第一行
prompt> git log --pretty=oneline# ~+ O5 Q8 z) X, t6 t6 C; y

显示改动行数统计$ s( Y6 j0 ^4 G- Z' |4 [
prompt> git log --stat

显示改动文件的名称和状态
prompt> git log --name-status' K! G* Y. {, x! `. ^4 Q

显示当前工作目录树和暂存区间的差别
prompt> git diff1 ]2 l3 e. ]/ i$ a( |
8 n) I! B$ j1 a: A/ R0 |
显示暂存区和版本库间的差别% A# H1 `9 O( E; k
prompt> git diff --cached
; a% l* @% e3 g4 o3 d& T, Y
显示工作目录树和版本库间的差别5 A" z- V* z' c9 H+ [- \+ l
prompt> git diff HEAD

显示工作目录树与版本库中某次提交版本之间的差别# J3 y) I9 l$ J4 z, }+ F! z/ x
可以是一个提交名称、分支名称或标签名称。3 e; Z( O. I5 ?( M. N
prompt> git diff ) y+ b2 o, K. m  U

显示版本库中两个版本之间的差别
prompt> git diff
( |( L3 q9 e2 w* @3 @) ]% _
显示差别的相关统计
prompt> git diff --stat []

显示文件中各个部分的修改者及相关提交信息
prompt> git blame 5 U$ Z5 R% _# c: Q2 S/ @3 j8 M# _
5 B: j( t9 C0 d
显示文件中各个部分的修改者及相关提交信息，包括在该文件中复制、粘贴和移动内容等方 面的情况。; H- u7 i0 r8 {7 l: u, f$ D0 k
prompt> git blame -M
* P9 \2 _: [8 R1 s
显示文件中各部分的修改者及相关提交信息，包括在文件间移动内容方 面的情况
prompt> git blame -C -C 8 {" `0 W. q7 K% ~( K2 |: t/ J$ Q

显示历史时，显示复制和粘贴信息4 V6 ]2 B! Z5 r" H8 n( I
prompt> git log -C -C -p -1 8 X- K7 @- [. u$ \: Z% e



A.5 远程版本库
Remote Repositories6 Y5 e) R! T& V% a: _
5 a0 r2 S5 t) M) s
开发人员之间通过远程版本库来共享工作成果，相互协作。本节介绍关于这些操作的命令， 详见第7章“与远程版本 库协作”（第91页）。* i7 ?& ^1 c4 B+ t; W% V

克隆远程版本库- c1 {& q9 s6 p. ~, X: Q5 ~
prompt> git clone ! ]- t$ F5 s; @; e

克隆远程版本库，但只下载其中最近200个提交的历史记录
prompt> git clone --depth 200 . j' F  R8 p; \

在本地版本库中设置远程版本库的别名6 S7 q' I) D% P3 Q" I5 G% \( {
prompt> git remote add 9 S, L$ l$ M8 `- W; X3 a  f/ Y3 B

显示远程分支! Z6 `2 Z/ Q& M+ R) j2 x4 a) Q0 _+ p
prompt> git branch -r
  G$ O7 B! R. e6 A; p" ?% O
基于远程分支创建本地分支' B. [3 N  G; s: ]
prompt> git branch , N5 q6 S) ~- P/ l
: }. o$ T1 T) s5 \
基于远程标签创建本地分支! b! q# V9 k$ D% C
prompt> git branch & T0 }# [/ b; L, C1 V9 s6 h. v9 P

从别名为“origin”的远程版本库中取来修改变化，但不合并到本地分支" @% F& ^/ M% t$ i$ o
prompt> git fetch) o  ^3 W' T2 G; M) q- W
7 l% p4 v1 o# B, y$ l4 ~
从任意的远程版本库中取来修改变化，但不合并到本地分支
prompt> git fetch & Y! A0 O6 m% K( _* q  v

从任意的远程版本库中取来修改变化，并合并到当前检出的本地分支
prompt> git pull

从别名为“origin”的远程版本库中取来修改变化，并合并到当前检出的本地分支9 D4 j- w1 o" g& A1 A1 K
prompt> git pull4 f, d' V! S# x6 U1 g0 D

把修改变化从本地分支推入远程版本库$ B' K. z4 o  K; v
prompt> git push :2 D) Z7 b$ H8 b6 s
$ [+ F4 X- t9 @: I; }8 w6 y$ x) Y
把修改变化从本地分支推入远程版本库中同名分支  P0 G$ Y  b1 ]
prompt> git push
9 d/ Q3 c# K* F& X4 p- o
把修改变化从本地新建分支推入远程版本库2 U" P' w- V, ^  e
prompt> git push . B5 k& Z7 t3 g- m' |8 o2 v0 w9 A

把修改变化推入别名为“origin”的远程版本库
当远程版本库中已有同名分支时，这个命令会推入本地分支到远程版本库对应的分支中。如 果远程版本库中尚无同名分支，则须使用git push 。
prompt> git push
6 [+ Q5 @" z1 T
在远程版本库中删除分支6 ~* b5 n$ _. q0 a% |1 a
prompt> git push :

在本地版本库中删除所有远程版本库中已不存在的分支( U! X& c+ D/ L+ i2 q; P
prompt> git remote prune & t, ?' ]' _1 u

在本地版本库中删除某个远程版本库的简称，以及该远程版本库相关的 分支
prompt> git remote rm $ U0 ^9 {. {3 D. ?; H1 }; _
5 u' r, A0 z# i5 ]8 ]
A.6 连接Git和SVN7 g: M2 U. I4 y3 _7 l/ A) R
Git to SVN Bridge
* W. l6 _$ O; W8 r& g) O6 Y
Git可 以读取Subversion版 本库中的数据，并把本地修改发送回Subversion版本库。这是Git区别于其他版本控制工具的必杀技之一。相关详细介绍请参见第10章“迁移到Git”（第131页）。
克隆SVN版 本库的全部内容
prompt> git svn clone , C3 b+ d9 l1 @! X, j4 X

克隆具有标准结构的SVN版本库: \7 r" @9 N, S
下面命令适用于克隆标准结构的SVN数据库，也就是说，主干命名为trunk，其他分支都存放于branches目录下，标签都存放于tags目录下。
prompt> git svn clone -s
9 K) V7 O- A7 ^+ W: Z; T1 A  S1 q4 K  Q* l
克隆非标准结构的SVN版本库
prompt> git svn clone -T \6 N/ @1 w  {' {0 }; b  g

-b \
  B, P  w4 N7 T
-t \


$ J. X$ r& o  r0 z% e1 I" P
克隆具有标准结构的SVN版本库中的某个版本（比如第2321版）
prompt> git svn clone -s -r 2321+ ?3 |$ L) W' @2 ^& b" X

克隆具有标准结构的SVN版本库，并对SVN中的分支添加前缀/ o) t9 s3 k( s  S' e' V
prompt> git svn clone -s --prefix svn/   j/ }, v0 p9 y' Q4 o' b

从上游SVN版本库中获得更新的内容，并依此在本地Git版本库中变基本地分支' Y: W, p0 t; f) g& W7 o
prompt> git svn rebase
( r- |) D/ H" l9 h
把修改变化推回上游SVN版本库
prompt> git svn dcommit

列出所有将推入上游SVN版本库的提交" l6 U9 H. a/ o% P0 ]5 o4 Q
prompt> git svn dcommit -n% q; K+ O# q: O2 q

显示SVN历 史记录
prompt> git svn log
1 d7 y( v- d: S
显示文件中各个部分的SVN的修改者及相关提交信息$ Y% [% l& x% m3 u9 f8 [7 s" [
prompt> git svn blame