git checkout命令

git checkout命令用於切換分支或恢復工作樹文件。git checkout是git最常用的命令之一,同時也是一個很危險的命令,因爲這條命令會重寫工作區。

使用語法

git checkout [-q] [-f] [-m] [<branch>]
git checkout [-q] [-f] [-m] --detach [<branch>]
git checkout [-q] [-f] [-m] [--detach] <commit>
git checkout [-q] [-f] [-m] [[-b|-B|--orphan] <new_branch>] [<start_point>]
git checkout [-f|--ours|--theirs|-m|--conflict=<style>] [<tree-ish>] [--] <paths>…​
git checkout [-p|--patch] [<tree-ish>] [--] [<paths>…]

描述

更新工作樹中的文件以匹配索引或指定樹中的版本。如果沒有給出路徑 - git checkout還會更新HEAD,將指定的分支設置爲當前分支。

示例

以下是一些示例 -

示例-1

以下順序檢查主分支,將Makefile還原爲兩個修訂版本,錯誤地刪除hello.c,並從索引中取回。

$ git checkout master             #(1)
$ git checkout master~2 Makefile  #(2)
$ rm -f hello.c
$ git checkout hello.c            #(3)

(1) 切換分支
(2) 從另一個提交中取出文件
(3)從索引中恢復hello.c

如果想要檢出索引中的所有C源文件,可以使用以下命令 -

$ git checkout -- '*.c'

注意:*.c是使用引號的。 文件hello.c也將被檢出,即使它不再在工作樹中,因爲文件globbing用於匹配索引中的條目(而不是在shell的工作樹中)。

如果有一個分支也命名爲hello.c,這一步將被混淆爲一個指令切換到該分支。應該寫:

$ git checkout -- hello.c

示例-2

在錯誤的分支工作後,想切換到正確的分支,則使用:

$ git checkout mytopic

但是,您的「錯誤」分支和正確的「mytopic」分支可能會在在本地修改的文件中有所不同,在這種情況下,上述檢出將會失敗:

$ git checkout mytopic
error: You have local changes to 'frotz'; not switching branches.

可以將-m標誌賦給命令,這將嘗試三路合併:

$ git checkout -m mytopic
Auto-merging frotz

在這種三路合併之後,本地的修改沒有在索引文件中註冊,所以git diff會顯示從新分支的提示之後所做的更改。

示例-3

當使用-m選項切換分支時發生合併衝突時,會看到如下所示:

$ git checkout -m mytopic
Auto-merging frotz
ERROR: Merge conflict in frotz
fatal: merge program failed

此時,git diff會顯示上一個示例中乾淨合併的更改以及衝突文件中的更改。 編輯並解決衝突,並用常規方式用git add來標記它:

$ edit frotz # 編輯 frotz 文件中內容,然後重新添加
$ git add frotz

其它示例

git checkout的主要功能就是遷出一個分支的特定版本。默認是遷出分支的HEAD版本
一此用法示例:

$ git checkout master     #//取出master版本的head。
$ git checkout tag_name    #//在當前分支上 取出 tag_name 的版本
$ git checkout  master file_name  #//放棄當前對文件file_name的修改
$ git checkout  commit_id file_name  #//取文件file_name的 在commit_id是的版本。commit_id爲 git commit 時的sha值。

$ git checkout -b dev/1.5.4 origin/dev/1.5.4

# 從遠程dev/1.5.4分支取得到本地分支/dev/1.5.4
$ git checkout -- hello.rb
#這條命令把hello.rb從HEAD中籤出.
$ git checkout .
#這條命令把 當前目錄所有修改的文件 從HEAD中籤出並且把它恢復成未修改時的樣子.
#注意:在使用 git checkout 時,如果其對應的文件被修改過,那麼該修改會被覆蓋掉。