如何只提交部分文件?

How to commit only part of files?

中所述

git - How do I commit only some files? - Stack Overflow

我们可以使用

 git commit [--only] a b c -m "only part of files"

但是在下面的例子中:

$ mkdir t
$ cd t
$ git init
Initialized empty Git repository in /mnt/c/test/git-test/t/.git/
$ touch a b
$ git add .
$ git commit a -m a
[master (root-commit) c7939f9] a
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 a
$ git commit b -m b
[master cf4514a] b
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 b
$ git status
On branch master
nothing to commit, working tree clean
$ ls
a  b

我试图只将文件 b 提交到第二次提交中,但失败了。 (工作树中的 a、b 和干净的工作树。这意味着这两个文件都已提交。)

那么如何真正提交部分文件呢?

甚至 git add 单个文件也不起作用:

$ mkdir t
$ cd t
$ git init
Initialized empty Git repository in /mnt/c/test/git-test/t/.git/
$ touch a b
$ git add a
$ git commit --only a -m "a"
[master (root-commit) 04383c9] a
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 a
$ git rm --cached -r .
rm 'a'
$ git add b
$ git commit --only b -m "b"
[master d518916] b
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 b
$ git checkout -f head~
Note: switching to 'head~'.

...
HEAD is now at 04383c9 a
$ ls
a
$ git checkout -f master
Previous HEAD position was 04383c9 a
Switched to branch 'master'
$ ls
a  b

文件a仍在第二次提交中。

背景: 假设我有一个包含许多文件的文件夹,并且我想将文件集 A 提交到第一次提交中(即第一次提交仅包含文件集 A),将文件集 B 提交到第二次提交中,... 为什么我这样做:只是出于好奇。

解决方案非常简单:将您感兴趣的文件添加到阶段。 例如 add . 表示 - 添加到暂存当前目录中的所有文件。反而 转到带有 a 的文件夹并键入添加 a.

git commit [--only] path 仅对指定文件提交 更改

所以你从一个空的仓库开始。您暂存了两个新文件:ab。现在你有两件事上演了(你可以用 git status 确认):

  • 新建文件a
  • 新建文件b

你说

git commit a -m a

如果此时你 运行 git status,你会看到确实只有对 a 的更改被提交; a 现已提交,b 仍作为“新文件”上演。那你说

git commit b -m b

仅提交了 b与之前的提交.

保持不变 a

您可以再次确认每次提交只影响您指定的文件

git log --name-status

这会告诉你第一次提交只添加了 a 而第二次提交只添加了 b.

听起来您想要一个命令来创建一个 仅包含 指定文件的提交。为此,您不仅需要将 changes 提交给要添加的任何新文件,还需要提交要删除的所有旧文件。这就是您第二次尝试失败的原因:您成功创建了一个只包含您想要的文件的暂存区,但随后您告诉 git 除了新文件之外不要对任何内容应用更改。如果不是

git commit --only b -m "b"

你只是说

git commit -m "b"

它会完成您想要做的事情。

添加到 and address

I used to take commit as a snapshot but not diff content. So I expect the commit command just takes a snapshot of the index and stores it.

这个是正确的。但是,当您使用 git commit --only 时,Git 实现这一点的方式很复杂。 (它也没有很好的记录。)

我通常谈论“那个”索引/暂存区/缓存。 Git 确实有一个特殊的索引,“the”索引,尽管它实际上是每个工作树:如果你 运行 git worktree add,你不仅会得到一个新的工作树,还有一个新索引(和新的 HEAD,以及其他特定于工作树的引用,例如 git bisect 的引用)。但是 Git 能够处理额外的临时索引文件,这就是 git commit --onlygit commit --include 所做的。

让我们再看看您的设置:

$ mkdir t
$ cd t
$ git init
Initialized empty Git repository in /mnt/c/test/git-test/t/.git/
$ touch a b
$ git add .

此时,“the”索引(.git/index 中的主要索引)包含两个文件。他们在这里:

$ git ls-files --stage
100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 0       a
100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 0       b

但是现在,您 运行 git commit a -m a 创建初始提交(根提交,没有父项)。这个命令——git commit --only a,或多或少——适用于:

  1. 创建一个新的临时索引,.git/index<em>digits</em>;
  2. 正在从当前提交中初始化该索引;1
  3. 运行宁相当于GIT_INDEX_FILE=.git/index<em>位数</em>加一个
  4. 运行ning 相当于 cp .git/index .git/index.<em>moredigits</em> 到创建一个 second 临时索引;
  5. 运行ning 相当于 GIT_INDEX_FILE=.git/index.<em>moredigits</em> 添加一个 ;2
  6. 从第一个临时索引构建提交,git commit 通常从主索引构建提交;3
  7. 通过将 第二个 临时索引重命名为 .git/index 来完成提交,使其成为主索引。

它的作用是:

  • 为包含 HEAD 提交和 --only 文件的提交创建并使用临时索引。万一新提交失败(尽管在您的情况下成功),主索引不受干扰。
  • 创建并设置第二个临时索引,以便在提交成功时使用。
  • 尝试使用第一个临时索引提交。

如果提交成功,第一个临时索引将被丢弃,第二个临时索引将成为主索引(通过 rename 操作,因此它都是原子的)。如果提交失败,两个临时索引文件都会被删除。

这意味着在 成功 git commit --only 之后,主索引会更新,就好像您在 [=] 上有 运行 git add 24=] 文件。在 失败 之后——提交可能由于预提交挂钩而失败,或者你擦除提交消息,例如——一切就好像你从未 运行 git commit --only 完全没有。

(在您的情况下,由于您没有在 运行 宁 git commit --only a 之前修改文件 a,因此您无法区分其中的一些情况。)

当您继续 运行 git commit --only b 时,重复了这些步骤,但文件 b 而不是文件 a.


1没有当前提交,因为您还没有创建任何提交,所以这被视为一种特殊情况:Git 将其创建为空指数.

2这个 git add 最终没有任何效果,因为名为 a 的文件仍然是空的。但是,如果此时您在工作树中修改了名为 a 的文件,它会更新第二个临时索引。

3因为 Git 没有使用文件 .git/index 来构建这个新的提交,任何 假定的预提交挂钩 索引被命名为 .git/index 会做错事。请注意,随着添加的工作树,该添加的工作树的主索引也有不同的名称(.git/worktrees/<name>/index,如果我没记错的话)。