git reset命令

git reset命令用於將當前HEAD復位到指定狀態。一般用於撤消之前的一些操作(如：git add,git commit等)。

簡介

git reset [-q] [<tree-ish>] [--] <paths>…​
git reset (--patch | -p) [<tree-ish>] [--] [<paths>…​]
git reset [--soft | --mixed [-N] | --hard | --merge | --keep] [-q] [<commit>]

描述

在第一和第二種形式中，將條目從<tree-ish>複製到索引。 在第三種形式中，將當前分支頭(HEAD)設置爲<commit>，可選擇修改索引和工作樹進行匹配。所有形式的<tree-ish>/<commit>默認爲 HEAD 。

這裏的 HEAD 關鍵字指的是當前分支最末梢最新的一個提交。也就是版本庫中該分支上的最新版本。

示例

以下是一些示例 -

在git的一般使用中，如果發現錯誤的將不想暫存的文件被git add進入索引之後，想回退取消，則可以使用命令：git reset HEAD <file>，同時git add完畢之後，git也會做相應的提示，比如：

# Changes to be committed: 
#   (use "git reset HEAD <file>..." to unstage) 
# 
# new file:   test.py

git reset [--hard|soft|mixed|merge|keep] [<commit>或HEAD]：將當前的分支重設(reset)到指定的<commit>或者HEAD(默認，如果不顯示指定<commit>，默認是HEAD，即最新的一次提交)，並且根據[mode]有可能更新索引和工作目錄。mode的取值可以是hard、soft、mixed、merged、keep。下面來詳細說明每種模式的意義和效果。

A). --hard：重設(reset) 索引和工作目錄，自從<commit>以來在工作目錄中的任何改變都被丟棄，並把HEAD指向<commit>。

下面是具體一個例子，假設有三個commit， 執行 git status結果如下:

commit3: add test3.c
commit2: add test2.c
commit1: add test1.c

執行git reset --hard HEAD~1命令後，
顯示：HEAD is now at commit2，運行git log，如下所示 -

commit2: add test2.c
commit1: add test1.c

應用場景

下面列出一些git reset的典型的應用場景：

(A) 回滾添加操作

$ edit    file1.c file2.c           # (1) 
$ git add file1.c file1.c           # (1.1) 添加兩個文件到暫存
$ mailx                             #  (2) 
$ git reset                           # (3) 
$ git pull git://info.example.com/ nitfol    # (4)

(1). 編輯文件 file1.c, file2.c，做了些更改，並把更改添加到了暫存區。
(2). 查看郵件，發現某人要您執行git pull，有一些改變需要合併下來。
(3). 然而，您已經把暫存區搞亂了，因爲暫存區同HEAD commit不匹配了，但是即將git pull下來的東西不會影響已經修改的file1.c 和 file2.c，因此可以revert這兩個文件的改變。在revert後，那些改變應該依舊在工作目錄中，因此執行git reset。
(4). 然後，執行了git pull之後，自動合併，file1.c 和 file2.c這些改變依然在工作目錄中。

(B)回滾最近一次提交

$ git commit -a -m "這是提交的備註信息"
$ git reset --soft HEAD^      #(1) 
$ edit code                        #(2) 編輯代碼操作
$ git commit -a -c ORIG_HEAD  #(3)

(1) 當提交了之後，又發現代碼沒有提交完整，或者想重新編輯一下提交的信息，可執行git reset --soft HEAD^，讓工作目錄還跟reset之前一樣，不作任何改變。
HEAD^表示指向HEAD之前最近的一次提交。
(2) 對工作目錄下的文件做修改，比如：修改文件中的代碼等。
(3) 然後使用reset之前那次提交的註釋、作者、日期等信息重新提交。注意，當執行git reset命令時，git會把老的HEAD拷貝到文件.git/ORIG_HEAD中，在命令中可以使用ORIG_HEAD引用這個提交。git commit 命令中 -a參數的意思是告訴git，自動把所有修改的和刪除的文件都放進暫存區，未被git跟蹤的新建的文件不受影響。commit命令中-c <commit> 或者 -C <commit>意思是拿已經提交的對象中的信息(作者，提交者，註釋，時間戳等)提交，那麼這條git commit 命令的意思就非常清晰了，把所有更改的文件加入暫存區，並使用上次的提交信息重新提交。

(C) 回滾最近幾次提交，並把這幾次提交放到指定分支中

回滾最近幾次提交，並把這幾次提交放到叫做topic/wip的分支上去。

$ git branch topic/wip     (1) 
$ git reset --hard HEAD~3  (2) 
$ git checkout topic/wip   (3)

(1) 假設已經提交了一些代碼，但是此時發現這些提交還不夠成熟，不能進入master分支，希望在新的branch上暫存這些改動。因此執行了git branch命令在當前的HEAD上建立了新的叫做 topic/wip 的分支。
(2) 然後回滾master分支上的最近三次提交。HEAD~3指向當前HEAD-3個提交，git reset --hard HEAD~3，即刪除最近的三個提交(刪除HEAD, HEAD^, HEAD~2)，將HEAD指向HEAD~3。

(D) 永久刪除最後幾個提交

$ git commit ## 執行一些提交
$ git reset --hard HEAD~3   (1)

(1) 最後三個提交(即HEAD, HEAD^和HEAD~2)提交有問題，想永久刪除這三個提交。

(E) 回滾merge和pull操作

$ git pull                         (1) 
Auto-merging nitfol 
CONFLICT (content): Merge conflict in nitfol 
Automatic merge failed; fix conflicts and then commit the result. 
$ git reset --hard                 (2) 
$ git pull . topic/branch          (3) 
Updating from 41223... to 13134... 
Fast-forward 
$ git reset --hard ORIG_HEAD       (4)
`

(1) 從origin拉取下來一些更新，但是產生了很多衝突，但您暫時沒有這麼多時間去解決這些衝突，因此決定稍候有空的時候再重新執行git pull操作。
(2) 由於git pull操作產生了衝突，因此所有拉取下來的改變尚未提交，仍然再暫存區中，這種情況下git reset --hard 與 git reset --hard HEAD意思相同，即都是清除索引和工作區中被搞亂的東西。
(3) 將topic/branch分支合併到當前的分支，這次沒有產生衝突，並且合併後的更改自動提交。
(4) 但是此時又發現將topic/branch合併過來爲時尚早，因此決定退滾合併，執行git reset --hard ORIG_HEAD回滾剛纔的pull/merge操作。說明：前面講過，執行git reset時，git會把reset之前的HEAD放入.git/ORIG_HEAD文件中，命令行中使用ORIG_HEAD引用這個提交。同樣的，執行git pull和git merge操作時，git都會把執行操作前的HEAD放入ORIG_HEAD中，以防回滾操作。

(F) 在污染的工作區中回滾合併或者拉取

$ git pull                         (1) 
Auto-merging nitfol 
Merge made by recursive. 
nitfol                |   20 +++++---- 
... 
$ git reset --merge ORIG_HEAD      (2)

(1) 即便你已經在本地更改了工作區中的一些東西，可安全的執行git pull操作，前提是要知道將要git pull下面的內容不會覆蓋工作區中的內容。
(2) git pull完後，發現這次拉取下來的修改不滿意，想要回滾到git pull之前的狀態，從前面的介紹知道，我們可以執行git reset --hard ORIG_HEAD，但是這個命令有個副作用就是清空工作區，即丟棄本地未使用git add的那些改變。爲了避免丟棄工作區中的內容，可以使用git reset --merge ORIG_HEAD，注意其中的--hard 換成了 --merge，這樣就可以避免在回滾時清除工作區。

(G) 中斷的工作流程處理

在實際開發中經常出現這樣的情形：你正在開發一個大的新功能(工作在分支：feature 中)，此時來了一個緊急的bug需要修復，但是目前在工作區中的內容還沒有成型，還不足以提交，但是又必須切換的另外的分支去修改bug。請看下面的例子 -

$ git checkout feature ;# you were working in "feature" branch and 
$ work work work       ;# got interrupted 
$ git commit -a -m "snapshot WIP"                 (1) 
$ git checkout master 
$ fix fix fix 
$ git commit ;# commit with real log 
$ git checkout feature 
$ git reset --soft HEAD^ ;# go back to WIP state  (2) 
$ git reset                                       (3)

(1) 這次屬於臨時提交，因此隨便添加一個臨時註釋即可。
(2) 這次reset刪除了WIP commit，並且把工作區設置成提交WIP快照之前的狀態。
(3) 此時，在索引中依然遺留着「snapshot WIP」提交時所做的未提交變化，git reset將會清理索引成爲尚未提交」snapshot WIP「時的狀態便於接下來繼續工作。

(H) 重置單獨的一個文件

假設你已經添加了一個文件進入索引，但是而後又不打算把這個文件提交，此時可以使用git reset把這個文件從索引中去除。

$ git reset -- frotz.c                      (1) 
$ git commit -m "Commit files in index"     (2) 
$ git add frotz.c                           (3)

(1) 把文件frotz.c從索引中去除，
(2) 把索引中的文件提交
(3) 再次把frotz.c加入索引

(I) 保留工作區並丟棄一些之前的提交

假設你正在編輯一些文件，並且已經提交，接着繼續工作，但是現在你發現當前在工作區中的內容應該屬於另一個分支，與之前的提交沒有什麼關係。此時，可以開啓一個新的分支，並且保留着工作區中的內容。

$ git tag start 
$ git checkout -b branch1 
$ edit 
$ git commit ...                            (1) 
$ edit 
$ git checkout -b branch2                   (2) 
$ git reset --keep start                    (3)

(1) 這次是把在branch1中的改變提交了。
(2) 此時發現，之前的提交不屬於這個分支，此時新建了branch2分支，並切換到了branch2上。
(3) 此時可以用reset --keep把在start之後的提交清除掉，但是保持工作區不變。