Git之git checkout再理解及用法汇总_(use "git checkout -- <file>..." to discard change-CSDN博客

本文链接：https://blog.csdn.net/lovedingd/article/details/125660410

前言

checkout是Git最常用的命令之一，我们常常使用它来切换分支，但是切换分支的时候总会遇到一些莫名其妙的问题导致切换失败，查询资料会发现它还有一些其他用法，虽然能够解决当前的问题，但是总会感觉有些用不明白，用不明白的原因应该是没有深度地、全面地理解它，所以要对它好好整理一下。

checkout在CVS和SVN中都是检出的意思，从版本库检出一个版本，在Git中就不是这么简单了。手册上是这样介绍的：

git-checkout - Switch branches or restore working tree files

翻译这句话意思就是，checkout用于切换分支或者恢复工作树的文件。

那我们看下它的详细用法：

$ git checkout -h

usage: git checkout [<options>] <branch>
   or: git checkout [<options>] [<branch>] -- <file>...

    -q, --quiet           suppress progress reporting
    -b <branch>           create and checkout a new branch
    -B <branch>           create/reset and checkout a branch
    -l                    create reflog for new branch
    --detach              detach HEAD at named commit
    -t, --track           set upstream info for new branch
    --orphan <new-branch>
                          new unparented branch
    -2, --ours            checkout our version for unmerged files
    -3, --theirs          checkout their version for unmerged files
    -f, --force           force checkout (throw away local modifications)
    -m, --merge           perform a 3-way merge with the new branch
    --overwrite-ignore    update ignored files (default)
    --conflict <style>    conflict style (merge or diff3)
    -p, --patch           select hunks interactively
    --ignore-skip-worktree-bits
                          do not limit pathspecs to sparse entries only
    --ignore-other-worktrees
                          do not check if another worktree is holding the given ref
    --recurse-submodules[=<checkout>]
                          control recursive updating of submodules
    --progress            force progress reporting

usage后面的or表示这个命令有两种用法，第一种是切换分支，第二种是撤销修改。

checkout 本意是检出的意思，也就是将某次commit的状态检出到工作区；所以它的过程是先将HEAD指向某个分支的最近一次commit，然后从commit恢复index，最后从index恢复工作区。

切换分支

创建并切换到新的分支，参考语法：

git checkout -b|-B <new_branch> [<start point>]

git checkout branchname

如果不指定切换到哪个分支，那就是切换到当前分支

git checkout -b branchname 创建并切换到新的分支.
这个命令是将git branch newbranch和git checkout newbranch合在一起的结果。

这个时候分支是本地分支，并没有提交到服务器上去，如果这个分支已经被创建，这个命令会失败，这个时候，如果想要重置这个分支，需要使用-B参数。

（1）创造 index 和 工作区 都有变动的场景

$ git status
On branch master
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

        modified:   t5.txt

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   t2.txt
        
查看分支
$ git branch
  b1
* master

从 master 切换到 b1 
$ git checkout b1
error: Your local changes to the following files would be overwritten by checkout:
        t5.txt
Please commit your changes or stash them before you switch branches.
Aborting

只提到了 index 中的文件 t5.txt，那是不是我把他提交了就可以了呢？
$ git commit -m 'add'

$ git checkout b1
Switched to branch 'b1'
M       t2.txt

$ git branch
* b1
  master
  
$ git status
On branch b1
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   t2.txt

no changes added to commit (use "git add" and/or "git commit -a")

由此可见 index 中的变动会阻止切换分支，那是因为一旦切换了，index 的变动就会消失；而工作区的变动会体现在切换后的分支上。


（2）重新创造 index 和 工作区 都有变动的场景，然后使用 -f 来强制切换分支呢？
$ git status
On branch master
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

        modified:   t2.txt

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   a/b/c/t3.txt

$ git checkout -f b1
Switched to branch 'b1'

$ git status
On branch b1
nothing to commit, working tree clean

切回 master 看一看
$ git checkout master
Switched to branch 'master'

$ git status
On branch master
nothing to commit, working tree clean

可见 -f 参数会强制切换分支，并清除掉 index 和 工作区的全部变动！！

那么，如果既要切换分支，又希望全部修改在切换后的分支中体现，那么只需要将 index 中的变动撤销即可（git reset HEAD filename），这样之前add进来的文件就成了Unstaged，然后切换分支即可。