下面是我整理的常用 Git 命令清單。幾個專用名詞的譯名如下。

• Workspace：工作區
• Index / Stage：暫存區
• Repository：倉庫區（或本地倉庫）
• Remote：遠端倉庫

本地分支關聯遠端：git branch --set-upstream-to=origin/beta beta

常用命令

一、新建程式碼庫

1 # 在當前目錄新建一個Git程式碼庫
2 $ git init
3 # 新建一個目錄，將其初始化為Git程式碼庫
4 $ git init [project-name]
5 # 下載一個專案和它的整個程式碼歷史
6 $ git clone [url]

二、配置

Git的設定檔案為.gitconfig，它可以在使用者主目錄下（全域性配置），也可以在專案目錄下（專案配置）。

1 # 顯示當前的Git配置
2 $ git config --list
3 # 編輯Git配置檔案
4 $ git config -e [--global]
5 # 設定提交程式碼時的使用者資訊
6 $ git config [--global] user.name "[name]"
7 $ git config [--global] user.email "[email address]"

三、增加/刪除檔案

 1 # 新增指定檔案到暫存區
 2 $ git add [file1] [file2] ...
 
 3 # 新增指定目錄到暫存區，包括子目錄
 4 $ git add [dir]
 5 # 添加當前目錄的所有檔案到暫存區
 6 $ git add .
 7 # 新增每個變化前，都會要求確認
 8 # 對於同一個檔案的多處變化，可以實現分次提交
 9 $ git add -p
10 # 刪除工作區檔案，並且將這次刪除放入暫存區
11 $ git rm [file1] [file2] ...
12 # 停止追蹤指定檔案，但該檔案會保留在工作區
13 $ git rm --cached [file]
14 # 改名檔案，並且將這個改名放入暫存區
15 $ git mv [file-original] [file-renamed]

四、程式碼提交

 1 # 提交暫存區到倉庫區
 2 $ git commit -m [message]
 3 # 提交暫存區的指定檔案到倉庫區
 4 $ git commit [file1] [file2] ... -m [message]
 5 # 提交工作區自上次commit之後的變化，直接到倉庫區
 6 $ git commit -a
 7 # 提交時顯示所有diff資訊
 8 $ git commit -v
 9 # 使用一次新的commit，替代上一次提交
10 # 如果程式碼沒有任何新變化，則用來改寫上一次commit的提交資訊
11 $ git commit --amend -m [message]
12 # 重做上一次commit，幷包括指定檔案的新變化
13 $ git commit --amend [file1] [file2] ...

五、分支

 1 # 列出所有本地分支
 2 $ git branch
 3 # 列出所有遠端分支
 4 $ git branch -r
 5 # 列出所有本地分支和遠端分支
 6 $ git branch -a
 7 # 新建一個分支，但依然停留在當前分支
 8 $ git branch [branch-name]
 9 # 新建一個分支，並切換到該分支
10 $ git checkout -b [branch]
11 # 新建一個分支，指向指定commit
12 $ git branch [branch] [commit]
13 # 新建一個分支，與指定的遠端分支建立追蹤關係
14 $ git branch --track [branch] [remote-branch]
15 # 切換到指定分支，並更新工作區
16 $ git checkout [branch-name]
17 # 切換到上一個分支
18 $ git checkout -
19 # 建立追蹤關係，在現有分支與指定的遠端分支之間
20 $ git branch --set-upstream [branch] [remote-branch]
21 # 合併指定分支到當前分支
22 $ git merge [branch]
23 # 選擇一個commit，合併進當前分支
24 $ git cherry-pick [commit]
25 # 刪除分支
26 $ git branch -d [branch-name]
27 # 刪除遠端分支
28 $ git push origin --delete [branch-name]
29 $ git branch -dr [remote/branch]
30  
31 
32 六、標籤
33 
34 # 列出所有tag
35 $ git tag
36 # 新建一個tag在當前commit
37 $ git tag [tag]
38 # 新建一個tag在指定commit
39 $ git tag [tag] [commit]
40 # 刪除本地tag
41 $ git tag -d [tag]
42 # 刪除遠端tag
43 $ git push origin :refs/tags/[tagName]
44 # 檢視tag資訊
45 $ git show [tag]
46 # 提交指定tag
47 $ git push [remote] [tag]
48 # 提交所有tag
49 $ git push [remote] --tags
50 # 新建一個分支，指向某個tag
51 $ git checkout -b [branch] [tag]

七、檢視資訊

 1 # 顯示有變更的檔案
 2 $ git status
 3 # 顯示當前分支的版本歷史
 4 $ git log
 5 # 顯示commit歷史，以及每次commit發生變更的檔案
 6 $ git log --stat
 7 # 搜尋提交歷史，根據關鍵詞
 8 $ git log -S [keyword]
 9 # 顯示某個commit之後的所有變動，每個commit佔據一行
10 $ git log [tag] HEAD --pretty=format:%s
11 # 顯示某個commit之後的所有變動，其"提交說明"必須符合搜尋條件
12 $ git log [tag] HEAD --grep feature
13 # 顯示某個檔案的版本歷史，包括檔案改名
14 $ git log --follow [file]
15 $ git whatchanged [file]
16 # 顯示指定檔案相關的每一次diff
17 $ git log -p [file]
18 # 顯示過去5次提交
19 $ git log -5 --pretty --oneline
20 # 顯示所有提交過的使用者，按提交次數排序
21 $ git shortlog -sn
22 # 顯示指定檔案是什麼人在什麼時間修改過
23 $ git blame [file]
24 # 顯示暫存區和工作區的差異
25 $ git diff
26 # 顯示暫存區和上一個commit的差異
27 $ git diff --cached [file]
28 # 顯示工作區與當前分支最新commit之間的差異
29 $ git diff HEAD
30 # 顯示兩次提交之間的差異
31 $ git diff [first-branch]...[second-branch]
32 # 顯示今天你寫了多少行程式碼
33 $ git diff --shortstat "@{0 day ago}"
34 # 顯示某次提交的元資料和內容變化
35 $ git show [commit]
36 # 顯示某次提交發生變化的檔案
37 $ git show --name-only [commit]
38 # 顯示某次提交時，某個檔案的內容
39 $ git show [commit]:[filename]
40 # 顯示當前分支的最近幾次提交
41 $ git reflog

八、遠端同步

 1 # 下載遠端倉庫的所有變動
 2 $ git fetch [remote]
 3 # 顯示所有遠端倉庫
 4 $ git remote -v
 5 # 顯示某個遠端倉庫的資訊
 6 $ git remote show [remote]
 7 # 增加一個新的遠端倉庫，並命名
 8 $ git remote add [shortname] [url]
 9 # 取回遠端倉庫的變化，並與本地分支合併
10 $ git pull [remote] [branch]
11 # 上傳本地指定分支到遠端倉庫
12 $ git push [remote] [branch]
13 # 強行推送當前分支到遠端倉庫，即使有衝突
14 $ git push [remote] --force
15 # 推送所有分支到遠端倉庫
16 $ git push [remote] --all

九、撤銷

 1 # 恢復暫存區的指定檔案到工作區
 2 $ git checkout [file]
 3 # 恢復某個commit的指定檔案到暫存區和工作區
 4 $ git checkout [commit] [file]
 5 # 恢復暫存區的所有檔案到工作區
 6 $ git checkout .
 7 # 重置暫存區的指定檔案，與上一次commit保持一致，但工作區不變
 8 $ git reset [file]
 9 # 重置暫存區與工作區，與上一次commit保持一致
10 $ git reset --hard
11 # 重置當前分支的指標為指定commit，同時重置暫存區，但工作區不變
12 $ git reset [commit]
13 # 重置當前分支的HEAD為指定commit，同時重置暫存區和工作區，與指定commit一致
14 $ git reset --hard [commit]
15 # 重置當前HEAD為指定commit，但保持暫存區和工作區不變
16 $ git reset --keep [commit]
17 # 新建一個commit，用來撤銷指定commit
18 # 後者的所有變化都將被前者抵消，並且應用到當前分支
19 $ git revert [commit]
20 # 暫時將未提交的變化移除，稍後再移入
21 $ git stash
22 $ git stash pop

十、其他

1 # 生成一個可供釋出的壓縮包
2 $ git archive

Git分支管理策略

一、主分支Master

首先，程式碼庫應該有一個、且僅有一個主分支。所有提供給使用者使用的正式版本，都在這個主分支上釋出。

Git主分支的名字，預設叫做Master。它是自動建立的，版本庫初始化以後，預設就是在主分支在進行開發。

二、開發分支Develop

主分支只用來分佈重大版本，日常開發應該在另一條分支上完成。我們把開發用的分支，叫做Develop。

這個分支可以用來生成程式碼的最新隔夜版本（nightly）。如果想正式對外發布，就在Master分支上，對Develop分支進行"合併"（merge）。

1 #Git建立Develop分支的命令：
2 git checkout -b develop master
3 #將Develop分支釋出到Master分支的命令：
4 # 切換到Master分支
5 git checkout master
6 # 對Develop分支進行合併
7 git merge --no-ff develop

這裡稍微解釋一下，上一條命令的--no-ff引數是什麼意思。預設情況下，Git執行"快進式合併"（fast-farward merge），會直接將Master分支指向Develop分支。

使用--no-ff引數後，會執行正常合併，在Master分支上生成一個新節點。為了保證版本演進的清晰，我們希望採用這種做法。關於合併的更多解釋，請參考Benjamin Sandofsky的《Understanding the Git Workflow》。

三、臨時性分支

前面講到版本庫的兩條主要分支：Master和Develop。前者用於正式釋出，後者用於日常開發。其實，常設分支只需要這兩條就夠了，不需要其他了。

但是，除了常設分支以外，還有一些臨時性分支，用於應對一些特定目的的版本開發。臨時性分支主要有三種：

　　* 功能（feature）分支

　　* 預釋出（release）分支

　　* 修補bug（fixbug）分支

這三種分支都屬於臨時性需要，使用完以後，應該刪除，使得程式碼庫的常設分支始終只有Master和Develop。

四、 功能分支

接下來，一個個來看這三種"臨時性分支"。

第一種是功能分支，它是為了開發某種特定功能，從Develop分支上面分出來的。開發完成後，要再併入Develop。

功能分支的名字，可以採用feature-*的形式命名。

1 #建立一個功能分支：
2 git checkout -b feature-x develop
3 #開發完成後，將功能分支合併到develop分支：
4 git checkout develop
5 git merge --no-ff feature-x
6 #刪除feature分支：
7 git branch -d feature-x

五、預釋出分支

第二種是預釋出分支，它是指釋出正式版本之前（即合併到Master分支之前），我們可能需要有一個預釋出的版本進行測試。

預釋出分支是從Develop分支上面分出來的，預釋出結束以後，必須合併進Develop和Master分支。它的命名，可以採用release-*的形式。

 1 #建立一個預釋出分支：
 2 git checkout -b release-1.2 develop
 3 #確認沒有問題後，合併到master分支：
 4 git checkout master
 5 git merge --no-ff release-1.2
 6 # 對合並生成的新節點，做一個標籤
 7 git tag -a 1.2
 8 #再合併到develop分支：
 9 git checkout develop
10 git merge --no-ff release-1.2
11 #最後，刪除預釋出分支：
12 git branch -d release-1.2

六、修補bug分支

最後一種是修補bug分支。軟體正式釋出以後，難免會出現bug。這時就需要建立一個分支，進行bug修補。

修補bug分支是從Master分支上面分出來的。修補結束以後，再合併進Master和Develop分支。它的命名，可以採用fixbug-*的形式。

 1 #建立一個修補bug分支：
 2 git checkout -b fixbug-0.1 master
 3 #修補結束後，合併到master分支：
 4 git checkout master
 5 git merge --no-ff fixbug-0.1
 6 git tag -a 0.1.1
 7 #再合併到develop分支：
 8 git checkout develop
 9 git merge --no-ff fixbug-0.1
10 #最後，刪除"修補bug分支"：
11 git branch -d fixbug-0.1

版本回退-撤銷檔案修改

一、工作區修改一個檔案後，又想回到修改前(git add前)

l 當然可以直接手動再在工作區中將檔案修改回去

l 修改後，通過命令git status檢視

1 $ git status
2 # On branch master
3 # Changes not staged for commit:
4 #  (use "git add <file>..." to update what will be committed)
5 #  (use "git checkout -- <file>..." to discard changes in working directory)
6 #  modified:   readme.txt
7 no changes added to commit (use "git add" and/or "git commit -a")

這時Git會告訴你，git checkout -- file可以丟棄工作區的修改：

$ git checkout -- readme.txt

Note:

1. git checkout -- file命令中的--很重要，沒有--，就變成了“切換到另一個分支”的命令，我們在後面的分支管理中會再次遇到git checkout命令。
2. 命令git checkout -- readme.txt意思就是，把readme.txt檔案在工作區的修改全部撤銷，這裡有兩種情況：
      一種是readme.txt自修改後還沒有被放到暫存區，現在，撤銷修改就回到和版本庫一模一樣的狀態；         
      一種是readme.txt已經新增到暫存區後，又作了修改，現在，撤銷修改就回到新增到暫存區後的狀態。總之，就是讓這個檔案回到最近一次git commit或git add時的狀態。
3. 工作區、暫存區的概念不清楚的可見於Git版本控制教程 - Git本地倉庫

二、如果在工作區中修改了檔案還git add到暫存區（但是在commit之前）

用git status檢視一下，修改只是新增到了暫存區，還沒有提交：

1 $ git status
2 # On branch master
3 # Changes to be committed:
4 #  (use "git reset HEAD <file>..." to unstage)
5 #  modified:   readme.txt

Git同樣告訴我們，用命令git reset HEAD file可以把暫存區的修改撤銷掉（unstage），重新放回工作區：

1 $ git reset HEAD readme.txt
2 Unstaged changes after reset:
3 M  readme.txt

git reset命令既可以回退版本，也可以把暫存區的修改回退到工作區。當我們用HEAD時，表示最新的版本。

再用git status檢視一下，現在暫存區是乾淨的，工作區有修改。然後丟棄工作區的修改

1 $ git checkout -- readme.txt
2 $ git status
3 # On branch master
4 nothing to commit (working directory clean)

三、不但修改了檔案還從暫存區提交commit到了版本庫 - 版本回退

版本回退可以回退到上一個版本。不過，這是有條件的，就是你還沒有把自己的本地版本庫推送到遠端。Git是分散式版本控制系統。

在工作中對某個檔案（如readme.txt）進行多次修改交commit。

可以通過版本控制系統命令告訴我們提交的歷史記錄，在Git中，我們用git log命令檢視：

 1 $ git log
 2 commit 3628164fb26d48395383f8f31179f24e0882e1e0
 3 Author: Michael Liao <[email protected]>
 4 Date:   Tue Aug 20 15:11:49 2013 +0800
 5 append GPL
 6 commit ea34578d5496d7dd233c827ed32a8cd576c5ee85
 7 Author: Michael Liao <[email protected]>
 8 Date:   Tue Aug 20 14:53:12 2013 +0800
 9 add distributed
10 commit cb926e7ea50ad11b8f9e909c05226233bf755030
11 Author: Michael Liao <[email protected]>
12 Date:   Mon Aug 19 17:51:55 2013 +0800
13 wrote a readme file

Note:

1. git log命令顯示從最近到最遠的提交日誌，我們可以看到3次提交，最近的一次是append GPL，上一次是add distributed，最早的一次是wrote a readme file。
2. 如果嫌輸出資訊太多，看得眼花繚亂的，可以試試加上--pretty=oneline引數：
　　a) $ git log --pretty=oneline
　　b) 3628164fb26d48395383f8f31179f24e0882e1e0 append GPL
　　c) ea34578d5496d7dd233c827ed32a8cd576c5ee85 add distributed
　　d) cb926e7ea50ad11b8f9e909c05226233bf755030 wrote a readme file
3. 你看到的一大串類似3628164...882e1e0的是commit id（版本號），和SVN不一樣，Git的commit id不是1，2，3……遞增的數字，而是一個SHA1計算出來的一個非常大的數字，用十六進位制表示，而且你看到的commit id和我的肯定不一樣，以你自己的為準。為什麼commit id需要用這麼一大串數字表示呢？因為Git是分散式的版本控制系統，後面我們還要研究多人在同一個版本庫裡工作，如果大家都用1，2，3……作為版本號，那肯定就衝突了。
4. 每提交一個新版本，實際上Git就會把它們自動串成一條時間線。如果使用視覺化工具（如GitX、github的客戶端、pycharm）檢視Git歷史，就可以更清楚地看到提交歷史的時間線。

四、現在我們想要把readme.txt回退到上一個版本

如“add distributed”的那個版本，怎麼做呢？首先，Git必須知道當前版本是哪個版本，在Git中，用HEAD表示當前版本，也就是最新的提交3628164...882e1e0（注意我的提交ID和你的肯定不一樣），上一個版本就是HEAD^，上上一個版本就是HEAD^^，當然往上100個版本寫100個^比較容易數不過來，所以寫成HEAD~100。

現在，我們要把當前版本“append GPL”回退到上一個版本“add distributed”，就可以使用git reset命令：

1 $ git reset --hard HEAD^
2 HEAD is now at ea34578 add distributed
3 這時readme.txt的內容就成了版本add distributed
4 我們用git log再看看現在版本庫的狀態：
5 $ git log
6 commit ea34578d5496d7dd233c827ed32a8cd576c5ee85
7 Author: Michael Liao <[email protected]>
8 Date:   Tue Aug 20 14:53:12 2013 +0800

a) add distributed

1. commit cb926e7ea50ad11b8f9e909c05226233bf755030
2. Author: Michael Liao <[email protected]>
3. Date: Mon Aug 19 17:51:55 2013 +0800

a) wrote a readme file

最新的那個版本append GPL已經看不到了！

五、恢復檔案後，要是我們又想回到修改後的檔案呢？（命令列視窗還沒有被關掉）

{這個是git reset --hard後，又反悔了，想回到修改後的狀態}

只要上面的命令列視窗還沒有被關掉，你就可以順著往上找啊找啊，找到那個append GPL的commit id是3628164...，於是就可以指定回到未來的某個版本：

1 $ git reset --hard 3628164
2 HEAD is now at 3628164 append GPL

版本號沒必要寫全，前幾位就可以了，Git會自動去找。

Git的版本回退速度非常快，因為Git在內部有個指向當前版本的HEAD指標，當你回退版本的時候，Git僅僅是把HEAD從指向append GPL：

改為指向add distributed：

然後順便把工作區的檔案更新了。所以你讓HEAD指向哪個版本號，你就把當前版本定位在哪。

六、恢復檔案後，要是我們又想回到修改後的檔案呢？（命令列視窗早就關掉了）

{這個是git reset --hard後，又反悔了，想回到修改後的狀態}

想恢復到新版本怎麼辦？找不到新版本的commit id怎麼辦？當你用$ git reset --hard HEAD^回退到add distributed版本時，再想恢復到append GPL，就必須找到append GPL的commit id。

Git提供了一個命令git reflog用來記錄你的每一次命令：[Git高階教程:git log與git reflog]

1 $ git reflog
2 ea34578 HEAD@{0}: reset: moving to HEAD^
3 3628164 HEAD@{1}: commit: append GPL
4 ea34578 HEAD@{2}: commit: add distributed
5 cb926e7 HEAD@{3}: commit (initial): wrote a readme file

第二行顯示append GPL的commit id是3628164，現在，你又可以乘坐時光機回到未來了。