git diff-files --diff-filters=A 的作用是什么？

Question

git-diff-files(1) 的文档说

仅选择已添加 (A)、已复制 (C)、已删除 (D)、已修改 (M)、已重命名 (R) 的文件，其类型（即常规文件、符号链接、子模块……）已更改（T )、未合并 (U)、未知 (X) 或配对已损坏 (B)...

但是，以下命令不会显示添加的文件（不要在具有 origin 子目录的目录中运行此命令）：

start=$PWD
origin="$start/origin"

rm -rf $origin
mkdir $origin
cd $origin
touch 1.txt
echo "2" > 2.txt
git init
git add -A
git commit -m "init"

echo "1" > 1.txt
rm 2.txt
echo "3" > 3.txt
git diff-files --diff-filter=ADM

输出如下：

$ git diff-files --diff-filter=ADM
:100644 100644 e69de... 0000... M      1.txt
:100644 000000 0cfbf... 0000... D      2.txt

git diff-files 是否从不显示添加的文件？ diff-filter 选项表明它能够选择添加的文件。

Answer 1

确实git diff-files 永远不会显示添加的文件。

diff-files 命令显示索引和工作副本中的文件之间的差异。根据定义，尚未添加到索引的文件（通过git add）不会成为索引的一部分，因此不会出现在索引和工作副本之间的任何差异中。只需将文件添加到索引中，就会使索引和工作副本中的文件相同，因此索引和工作副本之间没有任何区别，因此也不会显示在 diff-files 中。修改工作副本中添加的文件将直接导致M 状态。

文档显示所有可能的--diff-filter 参数的原因是差异选项文档在所有采用差异选项的命令之间共享（diff-files、diff-index、diff-tree、format-patch 、log 和 show)。他们各自的文档仅包含diff-options 文档：

include::diff-options.txt[]

以this line of the git-diff-files documentation source 为例。普通的diff-options 拥有共享的--diff-filter 文本starting here。

由于这些文件是在构建文档时处理的，正如条件所证明的那样

ifndef::git-format-patch[]

在--diff-filter 文档上方的行中，可以想象diff-files 命令的文本可能会有所不同（或增加以说明某些参数不适用的事实）。针对此更改向 git 项目打开错误报告可能是有意义的。