git checkout [commit-name]与git checkout [commit-name] .的区别

两个命令的行为差异核心来自git checkout的两套工作模式：不传路径参数时执行「分支/HEAD切换逻辑」，传入路径参数时执行「文件检出覆盖逻辑」。

• git checkout [commit-name] 属于切换模式：
  命令会直接移动HEAD指针指向你指定的提交，当前分支的指针不会跟着移动，因此进入分离头指针（detached HEAD）状态。这个状态下你做的新提交不会挂靠在任何现有分支下，切走分支后没有被引用的提交会被Git自动回收，适合临时查看旧版本、做实验性修改，需要保留修改时新建分支指向对应提交即可，和你已经了解的表现完全一致。
• git checkout [commit-name] . 属于文件检出模式：
  命令末尾的.是路径参数，代表当前仓库根目录下的所有文件。只要检测到路径参数，Git就不会动HEAD指针、不会切换分支，只会从你指定的提交中，把对应路径下的文件拷贝出来，直接覆盖暂存区和工作区的同名文件。这就是为什么你执行完还停留在master分支，只是文件内容变成了指定提交的版本——本质是文件内容被覆盖了，分支本身的指向根本没变化。

这个操作不会改动任何已有的提交历史，所有文件变更都停留在暂存区：

• 不会修改分支指针位置，不会进入分离头状态，全程在当前分支上下文操作
• 覆盖范围仅限你指定路径下的文件，如果你把.换成具体的文件/目录路径，就只会恢复对应部分的文件，不会改动其他内容
• 如果省略commit参数，直接执行git checkout .，默认会从当前HEAD指向的最新提交拉取文件，效果是清空对应路径下所有未提交的工作区、暂存区改动，把文件恢复到当前提交的状态。
• 和git reset --hard [commit-name]有本质区别：reset会把当前分支的指针直接挪到指定提交，相当于抹掉后续的提交历史；而带路径的checkout不会动分支指针和历史记录，只是把旧版本的文件作为当前的改动，你提交后会生成一个新的“回退内容”的提交，历史记录是持续向前追加的。

• 公共分支需要回退内容但不能改写历史：比如已经推送到远程的master分支，不能用reset硬回退打乱其他协作者的提交基线，就可以用这个命令把文件恢复到目标旧版本，提交一个新的回退提交再推送到远程，不会对其他人造成影响。
• 提取旧提交的部分文件到当前分支：不需要切分支，直接指定路径就能把某个旧提交里的特定文件/目录恢复到当前工作区，比如git checkout 3f7a2d src/components/Button就可以单独把Button组件恢复到3f7a2d提交的版本，其他文件不受影响。
• 快速清理未提交改动：如果本地做了大量零散的试验性修改，确定不需要保留，直接执行git checkout .就能一键清空所有未提交改动，回到当前提交的干净工作区，不用手动逐文件撤销。
• 临时查看旧版本文件：不想进入分离头状态切来切去，直接检出旧版本文件看完后，再执行git checkout .就能快速恢复到当前分支的最新状态。

注意：带路径的checkout会直接覆盖暂存区的内容，如果你之前有add过但没提交的改动，执行命令后会被直接覆盖无法找回，操作前务必确认没有需要保留的未提交内容。

内容的提问来源于stack exchange，提问作者ksgr5566