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

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

详细日志。

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

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

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

参见这可以有效地运行 add --interactive ，但是会绕过初始命令菜单，而直接跳转到 patch 子命令。有关详细信息，请参见 '交互模式 '。

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

此选项的目的是选择并选择要应用的补丁的行，甚至修改要暂存的行的内容。与使用交互式补丁块选择器相比，其更快，更灵活。但是，很容易混淆自己并创建不应用于索引的补丁。请参阅下面的编辑补丁。

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

如果在使用 -u 选项时没有 <路径规范> ，则整个工作目录树中的所有跟踪文件都将更新（旧版本 Git 会限制更新当前目录及其子目录）。

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

如果在使用 -A 选项时没有提供 <路径规范> ，则整个工作目录树中的所有文件都将更新（旧版本的 Git 会限制当前目录及其子目录的更新）。

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

此选项主要用于帮助那些习惯于较旧版本 Git 的用户。旧版本中的 git add <路径规范>... 是 git add --no-all <路径规范>... 的同义词，即忽略已删除的文件。

只记录稍后将添加路径的事实。路径的项会被放置在索引中，但不包括改动的内容。这对于使用 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-from-file 选项时才有意义。指定路径元素用 NUL 字符分隔，所有其他字符都按字面意思（包括换行符和引号）表示。

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

    *** Commands ***
      1: status       2: update       3: revert       4: add untracked
      5: patch        6: diff         7: quit         8: help
    What now> 1

你也可以输入 s 、 sta 或 status ，只要候选项是唯一的。

主命令循环有 6 个子命令（包括帮助和退出）。

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

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

它表明 foo.png 与 HEAD 有区别（但其是二进制的，因此无法显示行数），索引副本和工作目录树版本之间没有区别（如果工作目录树版本也不同， nothing 的位置上会显示 binary ）。另一个文件 git add---interactive.perl 添加了403 行，如果提交索引中的内容，则删除了 35 行，但工作目录树文件有额外修改（一次添加一次删除）。

这将显示状态信息并发出 "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 - 打印当前差异块
? - 输出帮助

在决定了所有块的操作后，如果有选择的区块，则会使用其来更新索引。

通过将配置变量 interactive.singleKey 设置为 true ，在此处可以不必键入回车。

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

还可以执行更复杂的操作。但是请注意，由于补丁仅应用于索引而不是工作目录树，因此工作树似乎会 "撤消" 索引中的更改。例如，在索引中添加一行，而该行不在 HEAD 或工作目录树。此时会暂存其以进行提交，但是该行似乎在会在工作目录树中进行还原。

避免使用这些构造，除非格外小心。

索引和工作树之间没有区别的内容可能会显示在上下文行中，以 " "（空格）开头。您可以通过将空格转换为 "-" 来暂存要删除的上下文行。生成的工作目录树文件将重新添加内容。

也可以通过暂存上下文行（通过将 " " 转换为 "-"）以进行删除来修改上下文行，并在其中添加新内容的 "+" 行。类似地，可以修改 "+" 行以进行现有内容的添加或修改。在所有情况下，新的修改都将在工作目录树中还原。

您还可以添加补丁中不存在的新内容。只需添加新行，每行以 "+" 开头。添加的内容将还原到工作目录树中。