git checkout命令
精华
小牛编辑
135浏览
2023-03-14
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 时,如果其对应的文件被修改过,那么该修改会被覆盖掉。