git - "check out code"在行尾的 git 文档中意味着什么？

Question

我真的很困惑“ checkout 代码”在以下页面中的含义:https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration#__code_core_autocrlf_code

If you’re on a Windows machine, set it to true – this converts LF endings into CRLF when you check out code:

添加文件时是什么意思？因为每当我将 core.autocrlf 从 input 更改为 true 时，反之亦然，我在添加文件时看到的差异(是否“ checkout ”是指“添加”吗？):

> git config --global core.autocrlf true

> git add crlf-file.md

> git add lf-file.md
 warning: LF will be replaced by CRLF in lf-file.md.
 The file will have its original line endings in your working directory.

> git config --global core.autocrlf input

> git add crlf-file.md
  warning: CRLF will be replaced by LF in crlf-file.md.
  The file will have its original line endings in your working directory.
> git add lf-file.md

Answer 1

(注意:我试图回答潜在的问题，这似乎真的是:如果 checkout 意味着 git checkout，为什么我在 git add 期间收到这些消息?)

这方面的文档有点草率，可能是故意的，因为完全正确的细节有些模糊。要在概念层面上很好地理解它，您应该将行结束修改视为更一般的涂抹和干净过滤的一部分(因为这实际上是它的实现方式).

在 Git 中，您当前可以使用的每个文件同时存在于三个位置:

the HEAD commit      the index       the work-tree
---------------      ---------       -------------
README.md            README.md       README.md
file.txt             file.txt        file.txt

除了所有提交在任何时候都是只读的之外，文件可以在不同的方向被复制。因此，您可以从 HEAD 提交复制到索引中，或者从索引复制到工作树中。您还可以从工作树复制到索引中。

(您还可以从索引中进行新提交。这将保留旧的 HEAD 提交，而新提交成为 HEAD 提交。因此在进行新提交，HEAD 提交和索引匹配。这不是因为我们修改了任何提交；我们不能那样做。这是因为我们添加了一个新的提交，由索引创建，然后我们不再将旧提交称为 HEAD，而是将新提交称为 HEAD。)

请注意，索引位于 HEAD 和工作树之间的“中间”。为了将任何文件从 HEAD 复制到工作树，它必须首先通过索引。为了从工作树中进行新的提交，每个新文件都必须通过索引。因此，索引/工作树转换是发生清理和弄脏的地方。

“清理”一个文件意味着让它为提交做好准备。例如，此清理过程可以将 CRLF 行结尾转换为仅 LF 行结尾。 Or, using the ident filter, you can un-make many substitutions ，或编写您自己的过滤器来做几乎任何事情。 涂抹 一个文件意味着让它准备好在工作树中进行编辑和/或使用。例如，这可以将仅 LF 行结尾转换为 CRLF 结尾。与清理过程一样，您可以使用 ident 过滤器或您自己的过滤器驱动程序来做任何您想做的事情。 Git LFS使用这些驱动程序交换短引用和整个文件内容。

因此，确切的答案是在将文件复制到索引或从索引中复制出来的过程中应用行结束转换。最常见的是这两个:

• git add 从工作树复制到索引。
• git checkout 提取到工作树，从提交到索引然后到工作树，或者直接从索引到工作树。

仅在这些时候发生任何这些 CRLF 到 LF 或 LF 到 CRLF 的转换。但是 Git 有额外的代码试图凭直觉判断稍后进行这些转换是否会导致对现有提交数据的更改，即使它还没有完成。 那个代码会给你你看到的警告信息:

warning: LF will be replaced by CRLF ...
warning: CRLF will be replaced by LF ...

如果您启用“safe crlf”选项，这些警告就会出现。因为它们来自在不同时间运行的不同代码，所以一切都会非常困惑。