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 Initialization7 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 "[email protected]"
爲特定的版本庫配置用戶名和電子郵件地址+ 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 [email protected]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 log4 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=oneline3 Y+ C8 X1 l) J! V, h4 a

顯示改動行數統計* Y+ K/ X; u8 F! X+ N) I
prompt> git log --stat1 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 Repositories7 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 pull7 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 Bridge9 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 rebase7 ^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>