如何在提交前撤消'git add'?

我错误地使用以下命令将文件添加到了 Git:

git add myfile.txt

我还没有运行git commit 。有一种方法可以撤消此操作,以便这些文件不会包含在提交中?

答案

您可以在提交之前撤消git add

git reset <file>

这会将其从当前索引(“即将提交” 列表)中删除,而无需进行其他任何更改。

您可以使用

git reset

没有任何文件名可以取消所有应有的更改。当在合理的时间内有太多文件不能一一列出时,这可能会派上用场。

在旧版本的 Git 中,上述命令分别等效于git reset HEAD <file>git reset HEAD ,并且如果HEAD未定义(因为尚未在存储库中进行任何提交)或模棱两可(因为创建了一个名为HEAD的分支,这是愚蠢的事情,您不应该这样做)。但是, 在 Git 1.8.2 中对此进行了更改 ,因此在现代版本的 Git 中,甚至可以在进行首次提交之前使用上述命令:

当您的历史记录中没有任何提交时,“git reset”(没有选项或参数)会出错,但是现在它为您提供了一个空索引(以匹配您甚至没有参与的不存在的提交)。

你要:

git rm --cached <added_file_to_undo>

推理:

当我是新手时,我首先尝试

git reset .

(撤消我的整个初始添加),只是得到了此信息(不是这样),有帮助:

fatal: Failed to resolve 'HEAD' as a valid ref.

事实证明,这是因为 HEAD ref(分支?)在第一次提交之后才存在。也就是说,如果您的工作流程(例如我的)类似于以下内容,您将遇到与我相同的初学者问题:

  1. cd 到我伟大的新项目目录中,尝试 Git,新热点
  2. git init
  3. git add .
  4. git status

    ... 很多废话

    => 该死,我不想添加所有这些内容。

  5. 谷歌 “撤消 git 添加”

    => 查找堆栈溢出 - 是

  6. git reset .

    => 致命:无法将 “HEAD” 解析为有效的引用。

事实证明,在邮件列表中有一个针对此问题的日志记录一个错误

而且正确的解决方案就在 Git 状态输出中(是的,我掩饰为 “废话”)

...
# Changes to be committed:
#   (use "git rm --cached <file>..." to unstage)
...

解决方案的确是使用git rm --cached FILE

请注意此处其他地方的警告git rm删除文件的本地工作副本,但如果使用--cached 则 不会删除。这是git help rm的结果:

--cached 使用此选项可取消登台并仅从索引中删除路径。无论是否修改,都会保留工作树文件。

我继续使用

git rm --cached .

删除所有内容,然后重新开始。不过没有用,因为在add .是递归的,结果表明rm需要-r来递归。叹。

git rm -r --cached .

好的,现在我回到了起点。下次,我将使用-n进行空运行并查看将添加的内容:

git add -n .

在信任git help rm关于--cached不会破坏任何内容(以及我拼错的内容该怎么办)之前,我将所有内容压缩到一个安全的地方。

如果输入:

git status

Git 会告诉您已登台的内容等,包括有关如何取消登台的说明:

use "git reset HEAD <file>..." to unstage

我发现 Git 在这种情况下勉强我做正确的事情做得很好。

注意:最新的 Git 版本(1.8.4.x)更改了此消息:

(use "git rm --cached <file>..." to unstage)

需要说明的是: git add将更改从当前工作目录移动到暂存区 (索引)。

此过程称为暂存 。所以最自然的命令阶段的变化(变更的文件)是明显的:

git stage

git add只是git stage易于使用的别名

可惜的是没有git unstage也不git unadd命令。相关的难以猜测或记住,但很明显:

git reset HEAD --

我们可以轻松为此创建一个别名:

git config --global alias.unadd 'reset HEAD --'
git config --global alias.unstage 'reset HEAD --'

最后,我们有了新命令:

git add file1
git stage file2
git unadd file2
git unstage file1

我个人使用更短的别名:

git a # For staging
git u # For unstaging

除了已接受的答案之外,如果错误添加的文件很大,您可能会注意到,即使使用 ' git reset ' 将其从索引中删除后,它似乎仍会占据.git目录中的空间。

这没什么好担心的。该文件确实仍在存储库中,但仅作为 “松散对象”。不会将其复制到其他存储库(通过克隆,推送),最终将回收该空间 - 尽管可能不会很快。如果您着急,可以运行:

git gc --prune=now

更新 (以下是我的尝试,以消除因最不满意的答案而引起的一些混乱):

那么,哪个是git add的真正撤消

git reset HEAD <file>

要么

git rm --cached <file>

严格来说,如果我没记错的话: 没有

git add 无法撤消 - 通常来说安全的。

让我们首先回顾一下git add <file>实际作用:

  1. 如果<file> 先前未被跟踪 ,则git add 会将其及其当前内容添加到缓存中

  2. 如果<file> 已经跟踪git add 会将当前内容 (快照,版本)保存到缓存中。在 Git 中,此操作仍称为add ,(不仅仅是更新它),因为文件的两个不同版本(快照)被视为两个不同的项目:因此,我们确实向缓存中添加了一个新项目,最终以后提交。

鉴于此,这个问题有点模棱两可:

我错误地使用命令添加了文件...

OP 的场景似乎是第一个(未跟踪的文件),我们希望 “撤消” 从跟踪的项目中删除文件(而不仅仅是当前内容)。 如果是这种情况,那么可以运行git rm --cached <file>

我们也可以运行git reset HEAD <file> 。通常,这是可取的,因为它在两种情况下都可以工作:当我们错误地添加已跟踪项目的版本时,它也可以撤消操作。

但是有两个警告。

第一:(在答案中指出)只有一种情况,其中git reset HEAD不起作用,但是git rm --cached起作用:新的存储库(无提交)。但是,实际上,这实际上是无关紧要的情况。

其次:请注意git reset HEAD不能神奇地恢复以前缓存的文件内容,它只是与 HEAD 重新同步。如果我们误导的git add覆盖了先前暂存的未提交版本,我们将无法恢复它。因此,严格来说,我们不能撤消 [*]。

例:

$ git init
$ echo "version 1" > file.txt
$ git add file.txt   # First add of file.txt
$ git commit -m 'first commit'
$ echo "version 2" > file.txt
$ git add  file.txt   # Stage (don't commit) "version 2" of file.txt
$ git diff --cached file.txt
-version 1
+version 2
$ echo "version 3" > file.txt
$ git diff  file.txt
-version 2
+version 3
$ git add  file.txt    # Oops we didn't mean this
$ git reset HEAD file.txt  # Undo?
$ git diff --cached file.txt  # No dif, of course. stage == HEAD
$ git diff file.txt   # We have irrevocably lost "version 2"
-version 1
+version 3

当然,如果仅遵循通常的懒惰工作流(仅用于添加新文件)进行 “git add”(案例 1),然后通过 commit git commit -a命令更新新内容,这并不是很关键。


*(编辑:以上内容实际上是正确的,但是仍然可能有一些稍作修改 / 令人费解的方法来恢复已上演但未提交但随后被覆盖的更改 - 请参阅 Johannes Matokic 和 iolsmit 的评论)

使用 Git 撤消已经添加的文件非常容易。要重置已添加的myfile.txt ,请使用:

git reset HEAD myfile.txt

说明:

暂存不需要的文件后,要撤消,可以执行git resetHead是本地文件的头,最后一个参数是文件名。

我已为您在下图中创建了更详细的步骤,包括在这些情况下可能发生的所有步骤:

git reset HEAD文件

git rm --cached . -r

将递归 “取消添加” 从当前目录添加的所有内容

git gui

并手动删除所有文件,或者选择所有文件并单击从提交中取消登台按钮。

Git 有可以想象到的每个动作的命令,但是它需要广泛的知识来使事情正确,因此,它充其量是违反直觉的。

您之前做了什么:

  • 更改文件并使用git add .git add <file>

你想要什么:

  • 从索引中删除文件,但保持版本不变,并保留工作副本中未提交的更改:

    git reset head <file>
  • 将文件重置为 HEAD 的最后一个状态,撤消更改并将其从索引中删除:

    # Think `svn revert <file>` IIRC.
    git reset HEAD <file>
    git checkout <file>
    
    # If you have a `<branch>` named like `<file>`, use:
    git checkout -- <file>

    这是必需的,因为git reset --hard HEAD不适用于单个文件。

  • 从索引和版本控制中删除<file> ,保留未版本化的文件以及工作副本中的更改:

    git rm --cached <file>
  • 从工作副本和版本中完全删除<file>

    git rm <file>

这个问题没有明确提出。原因是git add具有两个含义:

  1. 将一个新文件添加到暂存区,然后使用git rm --cached file撤消。
  2. 将一个修改过的文件添加到暂存区域,然后使用git reset HEAD file撤消。

如有疑问,请使用

git reset HEAD file

因为在两种情况下都可以完成预期的操作。

警告:如果对修改过的文件(仓库中以前存在的文件)执行git rm --cached file ,则该文件将在git commit删除!它仍将存在于您的文件系统中,但是如果其他人拉您的提交,该文件将从他们的工作树中删除。

git status会告诉您该文件是新文件还是已修改的 文件

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

    new file:   my_new_file.txt
    modified:   my_modified_file.txt