tools/git

[giscus[bot]]

tools/git

NoughtQ的笔记本，主要记录一些 CS 相关的笔记

https://note.noughtq.top/tools/git

[XuebaStudy]

也许可以加上git restore相关介绍？个人感觉也挺常用的（有利于这篇文章的完备性）🥰感谢~

[NoughtQ]

感谢你的建议，但不好意思，我自认为还是个 git 小白，没有用过超出我笔记之外的其他命令（这个 git restore 我还是第一次看见hh）；而且我也没那么多时间整理这些知识，所以很有可能会被我鸽掉...

[XuebaStudy]

没关系啦，那我在评论中加点内容吧😊（来自Kimi）（如无特殊情况，不用回复~）

Git 常用命令详解：git restore、git revert、git reset 和 git checkout

1. git restore

git restore 是 Git 2.23 版本引入的一个新命令，用于恢复工作目录中的文件内容，而不影响分支的提交历史。它的主要功能是将文件从暂存区或仓库恢复到工作目录。

基本用法

• 从暂存区恢复文件到工作目录（取消暂存）

  git restore --staged <file>
  

  作用：将指定文件从暂存区取消暂存，恢复到工作目录的状态。 示例：

  git add file.txt
  git restore --staged file.txt
  

  执行后，file.txt 从暂存区中移除，但工作目录中的内容保持不变。

• 将文件恢复到仓库中的状态

  git restore <file>
  

  作用：将指定文件的工作目录内容恢复为仓库中最后一次提交的状态。 示例：

  # 修改了 file.txt，但未暂存
  git restore file.txt
  

  执行后，file.txt 的工作目录内容被恢复为最后一次提交时的状态。

• 恢复多个文件或目录

  git restore <file1> <file2>
  git restore path/to/directory
  git restore .
  

  可以同时恢复多个文件或整个目录。

特点

• git restore 是一个更直观的命令，专门用于操作工作目录中的文件状态，而不涉及分支切换或提交历史的修改。
• 它是 Git 对文件操作的现代化改进，避免了 git checkout 和 git reset 在某些场景下可能引起的混淆。

2. git revert

git revert 用于撤销一个或多个提交。它通过创建一个新的提交来反向操作之前的提交，而不是直接修改提交历史。

基本用法

• 撤销单个提交

  git revert <commit-hash>
  

  作用：创建一个新的提交，该提交的内容是撤销指定提交的更改。 示例：

  git revert abc123
  

  执行后，Git 会创建一个新的提交，其内容是撤销 abc123 提交的更改。

• 撤销多个连续提交

  git revert <commit-hash1>..<commit-hash2>
  

  作用：撤销从 <commit-hash1> 到 <commit-hash2> 之间的所有提交。 示例：

  git revert abc123..def456
  

  执行后，Git 会依次创建新的提交来撤销 abc123 到 def456 之间的所有提交。

• 撤销多个不连续提交

  git revert <commit-hash1> <commit-hash2>
  

  作用：分别对每个指定的提交创建一个新的反向提交。 示例：

  git revert abc123 def456
  

  执行后，Git 会分别创建两个新的提交，分别撤销 abc123 和 def456 的更改。

特点

• git revert 不会修改现有的提交历史，而是通过新的提交来实现撤销操作。因此，它是一种安全的操作，不会导致分支的提交历史丢失。
• 它适用于需要保留提交历史的场景，例如在公共分支上撤销错误的提交。

3. git reset

git reset 是一个功能强大的命令，用于重置当前分支的指针到指定的提交，并根据选项选择是否修改暂存区和工作目录。

基本用法

• 软重置（--soft）

  git reset --soft <commit-hash>
  

  作用：将当前分支的指针重置到指定的提交，但保留暂存区和工作目录的更改。 示例：

  git reset --soft HEAD~1
  

  执行后，当前分支的指针回退到上一个提交，但暂存区和工作目录的更改仍然保留。

• 混合重置（--mixed，默认选项）

  git reset <commit-hash>
  

  作用：将当前分支的指针重置到指定的提交，并将暂存区的内容更新为该提交的状态，但工作目录的更改保留。 示例：

  git reset HEAD~1
  

  执行后，当前分支的指针回退到上一个提交，暂存区的内容被更新为上一个提交的状态，但工作目录的更改仍然保留。

• 硬重置（--hard）

  git reset --hard <commit-hash>
  

  作用：将当前分支的指针重置到指定的提交，并将暂存区和工作目录的内容更新为该提交的状态。 示例：

  git reset --hard HEAD~1
  

  执行后，当前分支的指针回退到上一个提交，暂存区和工作目录的内容都被更新为上一个提交的状态。

特点

• git reset 可以直接修改分支的提交历史，因此需要谨慎使用。
• 它适用于需要回退分支指针的场景，例如在本地开发中撤销错误的提交或调整提交顺序。

4. git checkout

git checkout 是一个多功能命令，用于切换分支、恢复文件内容以及创建新分支。

基本用法

• 切换分支

  git checkout <branch-name>
  

  作用：切换到指定的分支。 示例：

  git checkout feature-branch
  

  执行后，当前分支切换为 feature-branch。

• 创建并切换到新分支

  git checkout -b <new-branch-name>
  

  作用：创建一个新的分支并切换到该分支。 示例：

  git checkout -b new-feature
  

  执行后，创建了一个名为 new-feature 的新分支，并切换到该分支。

• 恢复文件内容（工作目录）

  git checkout <commit-hash> -- <file>
  

  作用：将指定文件的工作目录内容恢复为指定提交时的状态。 示例：

  git checkout abc123 -- file.txt
  

  执行后，file.txt 的工作目录内容被恢复为 abc123 提交时的状态。

• 恢复文件内容（暂存区和工作目录）

  git checkout <commit-hash> -- <file>
  

  作用：将指定文件的暂存区和工作目录内容恢复为指定提交时的状态。 示例：

  git checkout abc123 -- file.txt
  

  执行后，file.txt 的暂存区和工作目录内容都被恢复为 abc123 提交时的状态。

特点

• git checkout 是一个多功能命令，既可以用于分支操作，也可以用于文件恢复。
• 它在某些场景下可能会引起混淆，例如在恢复文件内容时，可能会误操作分支切换。

总结

• git restore：用于恢复工作目录中的文件内容，不涉及分支切换或提交历史的修改。
• git revert：通过创建新的提交来撤销之前的提交，不修改现有的提交历史。
• git reset：重置当前分支的指针到指定的提交，并根据选项选择是否修改暂存区和工作目录。
• git checkout：用于切换分支、恢复文件内容以及创建新分支，功能强大但可能引起混淆。

在实际使用中，可以根据具体需求选择合适的命令。例如，如果只是需要恢复文件内容，推荐使用 git restore；如果需要撤销提交并保留提交历史，使用 git revert；如果需要回退分支指针，使用 git reset；而 git checkout 更适合用于分支操作。