如何只提交部分文件？

Question

如上所说

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 和 clean。这意味着两个文件都已提交。）

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

即使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 设置到第二个提交，... 我为什么这样做：只是出于好奇。

Answer 1

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

Answer 2

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

所以你从一个空的仓库开始。您暂存了两个新文件：a 和 b。现在你有两件事上演了（你可以用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。

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

git commit --only b -m "b"

你只是说

git commit -m "b"

它会做你想做的事。

Answer 3

添加到Mark Adelsberger's answer 和地址your comment here：

我曾经将提交作为快照而不是差异内容。所以我希望提交命令只是拍摄索引的快照并存储它。

这是正确的。但是，当你使用git commit --only 时，Git 实现这一点的方式很复杂。 （它也没有很好的记录。）

我通常谈论“索引”/暂存区/缓存。 Git 确实有一个特殊的索引，“the”索引，虽然它实际上是每个工作树的：如果你运行git worktree add，你不仅会得到一个新的工作树，而且还有一个新的索引（和新的@987654326 @，以及其他特定于工作树的引用，例如 git bisect)。但是 Git 能够处理额外的临时索引文件，这就是 git commit --only 和 git 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. 从当前提交初始化那个索引；¹
3. 运行相当于GIT_INDEX_FILE=.git/index<em>digits</em> add a;
4. 运行相当于cp .git/index .git/index.<em>moredigits</em> 来创建秒临时索引；
5. 运行相当于GIT_INDEX_FILE=.git/index.<em>moredigits</em> add a;²
6. 从第一个临时索引构建提交，就像git commit 通常从主索引构建提交一样；³ 和
7. 通过将 second 临时索引重命名为 .git/index 来完成提交，使其成为主索引。

这是做什么的：

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

如果提交成功，第一个临时索引将被丢弃，第二个临时索引成为主索引（通过rename 操作，使其全部是原子的）。如果提交失败，则删除两个临时索引文件。

这意味着在 成功 git commit --only 之后，主索引会更新，就像您在 --only 文件上运行 git add 一样。在一个失败之后——提交可能由于预提交钩子或你删除提交消息而失败，例如——就像你根本没有运行过git commit --only一样。

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

当您继续运行 git commit --only b 时，这些步骤会重复，但使用文件 b 而不是文件 a。

---

¹当前没有提交，因为您还没有创建任何提交，所以这被视为一种特殊情况：Git 将其创建为空索引。

²这个git add 最终无效，因为名为@9​​87654354@ 的文件仍然是空的。如果此时您在工作树中修改了名为 a 的文件，它会更新第二个临时索引。

³由于 Git 没有使用文件 .git/index 来构建这个新的提交，任何 假定索引名为 .git/index 的预提交钩子都会做错事。请注意，添加工作树后，添加的工作树的主索引也有不同的名称（.git/worktrees/<name>/index，如果我没记错的话）。