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

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

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

一、新建程式碼庫

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

二、配置

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

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

三、增加/刪除檔案

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

四、程式碼提交

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

五、分支

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

六、標籤

1.    
2.   # 列出所有tag
3.   $ git tag
4.    
5.   # 新建一個tag在當前commit
6.   $ git tag [tag]
7.    
8.   # 新建一個tag在指定commit
9.   $ git tag [tag] [commit]
10.    
11.   # 刪除本地tag
12.   $ git tag -d [tag]
13.    
14.   # 刪除遠端tag
15.   $ git push origin :refs/tags/[tagName]
16.    
17.   # 檢視tag資訊
18.   $ git show [tag]
19.    
20.   # 提交指定tag
21.   $ git push [remote] [tag]
22.    
23.   # 提交所有tag
24.   $ git push [remote] --tags
25.    
26.   # 新建一個分支，指向某個tag
27.   $ git checkout -b [branch] [tag]

七、檢視資訊

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

八、遠端同步

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

九、撤銷

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

十、其他

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

Git分支管理策略

一、主分支Master

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

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

二、開發分支Develop

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

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

Git建立Develop分支的命令：

　　git checkout -b develop master

將Develop分支釋出到Master分支的命令：

　　# 切換到Master分支
　　git checkout master

　　# 對Develop分支進行合併
　　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-*的形式命名。

建立一個功能分支：

　　git checkout -b feature-x develop

開發完成後，將功能分支合併到develop分支：

　　git checkout develop

　　git merge --no-ff feature-x

刪除feature分支：

　　git branch -d feature-x

五、預釋出分支

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

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

建立一個預釋出分支：

　　git checkout -b release-1.2 develop

確認沒有問題後，合併到master分支：

　　git checkout master

　　git merge --no-ff release-1.2

　　# 對合並生成的新節點，做一個標籤
　　git tag -a 1.2

再合併到develop分支：

　　git checkout develop

　　git merge --no-ff release-1.2

最後，刪除預釋出分支：

　　git branch -d release-1.2

六、修補bug分支

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

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

建立一個修補bug分支：

　　git checkout -b fixbug-0.1 master

修補結束後，合併到master分支：

　　git checkout master

　　git merge --no-ff fixbug-0.1

　　git tag -a 0.1.1

再合併到develop分支：

　　git checkout develop

　　git merge --no-ff fixbug-0.1

最後，刪除"修補bug分支"：

　　git branch -d fixbug-0.1

版本回退-撤銷檔案修改

{針對檔案修改恢復}

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

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

2. 修改後，通過命令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.   #
7.   # modified: readme.txt
8.   #
9.   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.   #
6.   # modified: readme.txt
7.   #

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.    
3.   $ git status
4.   # On branch master
5.   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.    
6.   append GPL
7.    
8.   commit ea34578d5496d7dd233c827ed32a8cd576c5ee85
9.   Author: Michael Liao <[email protected]>
10.   Date: Tue Aug 20 14:53:12 2013 +0800
11.    
12.   add distributed
13.    
14.   commit cb926e7ea50ad11b8f9e909c05226233bf755030
15.   Author: Michael Liao <[email protected]>
16.   Date: Mon Aug 19 17:51:55 2013 +0800
17.    
18.   wrote a readme file

Note:

1. git log命令顯示從最近到最遠的提交日誌，我們可以看到3次提交，最近的一次是append GPL，上一次是add distributed，最早的一次是wrote a readme file。

2. 如果嫌輸出資訊太多，看得眼花繚亂的，可以試試加上--pretty=oneline引數：

1.   $ git log --pretty=oneline
2.   3628164fb26d48395383f8f31179f24e0882e1e0 append GPL
3.   ea34578d5496d7dd233c827ed32a8cd576c5ee85 add distributed
4.   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歷史，就可以更清楚地看到提交歷史的時間線。0

現在我們想要把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

這時readme.txt的內容就成了版本add distributed

我們用git log再看看現在版本庫的狀態：

1.   $ git log
2.   commit ea34578d5496d7dd233c827ed32a8cd576c5ee85
3.   Author: Michael Liao <[email protected]>
4.   Date: Tue Aug 20 14:53:12 2013 +0800
5.    
6.   add distributed
7.    
8.   commit cb926e7ea50ad11b8f9e909c05226233bf755030
9.   Author: Michael Liao <[email protected]>
10.   Date: Mon Aug 19 17:51:55 2013 +0800
11.    
12.   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，現在，你又可以乘坐時光機回到未來了。