要从中添加内容的文件。可以使用文件通配符（例如 *.c）来添加所有匹配的文件。此外，还可以提供一个前导目录名（例如，指定 dir 以添加 dir/file1 和 dir/file2）来更新索引，使其与整个目录的当前状态相匹配（例如，指定 dir 不仅会记录在工作树中修改的文件 dir/file1，还会记录在工作树中添加的文件 dir/file2，还有从工作树中删除的文件 dir/file3）。请注意，旧版本的 Git 会忽略已删除的文件；如果要添加已修改的文件或新文件，但忽略已删除的文件，请使用 --no-all 选项。

实际上不添加文件，仅展示文件是否存在或是否忽略。

详细日志。

允许添加已被忽略的文件。

允许更新稀疏检出 cone 之外的索引条目。 通常，git add 拒绝更新其路径不适合稀疏检出 cone 的索引条目，因为这些文件可能会在没有警告的情况下从工作区中删除。有关更多详细信息，请参阅链接 git-sparse-checkout[1]。

以交互方式将工作目录树中的修改内容添加到索引。可以提供可选的路径参数，以将操作限制为工作目录树的子集。有关详细信息，请参见 '交互模式'。

交互地在索引和工作目录之间选择补丁块并将它们添加到索引中。这让用户有机会在将修改后的内容添加到索引之前查看差异。

在编辑器中打开与索引的差异，使用户进行编辑。关闭编辑器后，调整块补丁头并将其应用于索引。

Update the index just where it already has an entry matching <pathspec>. This removes as well as modifies index entries to match the working tree, but adds no new files.

Update the index not only where the working tree has a file matching <pathspec> but also where the index already has an entry. This adds, modifies, and removes index entries to match the working tree.

Update the index by adding new files that are unknown to the index and files modified in the working tree, but ignore files that have been removed from the working tree. This option is a no-op when no <pathspec> is used.

只记录稍后将添加路径的事实。路径的项会被放置在索引中，但不包括改动的内容。这对于使用 git diff 显示文件的未暂存内容以及使 git commit -a 提交这些文件非常有用。

不添加文件，只刷新索引中的 stat() 信息。

如果由于索引错误而无法添加某些文件，请不要中止操作，而是继续添加其他文件。命令仍应以非零状态退出。可以将配置变量 add.ignoreErrors 设置为 true，使其成为默认行为。

此选项只能与 --dry-run 一起使用。通过使用此选项，用户可以检查是否会忽略任何给定的文件，无论它们是否已存在于工作树中。

默认情况下， git add 将在向索引添加嵌入式存储库时发出警告，而不使用 git submodule add 在 .gitmodules 中创建条目。此选项将抑制警告（例如，如果手动对子模块执行操作）。

对所有跟踪文件重新应用 “清除” 程序，将它们强制添加到索引中。 这在更改 core.autocrlf 配置或 text 属性后非常有用，可以纠正添加文件时错误的 CRLF/LF 行尾。 该选项意味着 -u 。由于 CRLF 字符不会被清除，因此 CRLF 会被清除为 LF，而 CRCRLF 序列只会被部分清除为 CRLF。

重写添加文件的可执行位。可执行位仅在索引中更改，磁盘上的文件保持不变。

Pathspec is passed in <file> instead of commandline args. If <file> is exactly - then standard input is used. Pathspec elements are separated by LF or CR/LF. Pathspec elements can be quoted as explained for the configuration variable core.quotePath (see git-config[1]). See also --pathspec-file-nul and global --literal-pathspecs.

只有在使用 --pathspec-from-file 选项时才有意义。指定路径元素用 NUL 字符分隔，所有其他字符都按字面意思（包括换行符和引号）表示。

此选项可用于分离命令行选项和文件列表（当文件名可能被误认为命令行选项时非常有用）。

这将显示每个路径下 HEAD 和索引之间的更改（即，如果输入 git commit，将提交什么），以及索引和工作目录树文件之间的更改（即，在输入 git commit 之前，执行 git add 可以进一步暂存什么）。示例输出如下：

              staged     unstaged path
     1:       binary      nothing foo.png
     2:     +403/-35        +1/-1 git-add--interactive.perl

这将显示状态信息并发出 "Update>>" 提示。当提示以 >> 结尾时，可以进行多个选择，并用空格或逗号连接。你也可以输入范围。例如："2-5 7,9" 将从列表中选择 2、3、4、5、7、9。如果省略一个范围中的第二个数字，则将获取所有剩余的补丁。例如："7-" 从列表中选择 7、8、9。你可以输入 * 来选择全部补丁。

           staged     unstaged path
  1:       binary      nothing foo.png
* 2:     +403/-35        +1/-1 git-add--interactive.perl

Update>> -2

它有一个与 update 非常相似的交互过程，所选路径的暂存信息将还原为 HEAD 版本。还原新路径将使它们不被追踪。

它有一个与 update 和 revert 非常相似的交互过程，允许您向索引添加未跟踪的路径。

这允许您从类似 status 命令的选择中选择一条路径。在选择路径之后，它将显示索引和工作树文件之间的差异，并询问您是否要暂存每个块的更改。您可以选择以下选项之一并输入回车：

y - stage this hunk
n - do not stage this hunk
q - quit; do not stage this hunk or any of the remaining ones
a - stage this hunk and all later hunks in the file
d - do not stage this hunk or any of the later hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - leave this hunk undecided, see next undecided hunk
J - leave this hunk undecided, see next hunk
k - leave this hunk undecided, see previous undecided hunk
K - leave this hunk undecided, see previous hunk
s - split the current hunk into smaller hunks
e - manually edit the current hunk
p - print the current hunk
? - print help

这使您可以查看要提交的内容（即，在 HEAD 和索引之间）。