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的取值可以是hardsoftmixedmergedkeep。下面來詳細說明每種模式的意義和效果。

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.cfile2.c,因此可以revert這兩個文件的改變。在revert後,那些改變應該依舊在工作目錄中,因此執行git reset
(4). 然後,執行了git pull之後,自動合併,file1.cfile2.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 --hardgit 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 pullgit 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之後的提交清除掉,但是保持工作區不變。