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

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

详细日志。

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

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

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

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

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

在索引已经有与 <路径规范> 匹配项的地方更新索引。这会删除和修改索引项以匹配工作目录树，但不添加新文件。

不仅在工作树中有与 <路径规范> 匹配的文件的地方更新索引，而且在索引中已经有一个项的地方更新索引。这将添加、修改和删除与工作目录树匹配的索引项。

通过添加索引未知的新文件和在工作树中修改的文件以更新索引，但忽略已从工作树中删除的文件。当不使用 <路径规范> 时，此选项是必须的。

只记录稍后将添加路径的事实。路径的项会被放置在索引中，但不包括改动的内容。这对于使用 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 在 <文件> 中传递，而不是在命令行参数中传递。如果 <文件> 正好是 -，则使用标准输入。路径规范元素由 LF 或 CR/LF 分隔。可以引用配置变量 core.quotePath 的路径规范元素（请参见 git-config[1]）。另请参见 --pathspec-file-nul 和全局 --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 - 暂存此区块
n - 不暂存此区块
q - 退出；不暂存包括此块在内的剩余的区块
a - 暂存此块与此文件后面所有的区块
d - 不暂存此块与此文件后面所有的 区块
g - 选择并跳转至一个区块
/ - 搜索与给定正则表达示匹配的区块
j - 暂不决定，转至下一个未决定的区块
J - 暂不决定，转至下一个区块
k - 暂不决定，转至上一个未决定的区块
K - 暂不决定，转至上一个区块
s - 将当前的区块分割成多个较小的区块
e - 手动编辑当前的区块
p - 打印当前差异块
? - 输出帮助

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