从中添加内容的文件。 可以给出文件通配符（例如 *.c）以添加所有匹配的文件。 也可以给出前导目录名称（例如 dir 以添加 dir/file1 和 dir/file2）以更新索引以匹配目录的整体当前状态（例如，指定 dir 将不仅记录工作目录中修改的文件 dir/file1、添加到工作目录的文件 dir/file2，还会记录从工作目录中删除的文件 dir/file3）。 请注意，旧版本的 Git 过去会忽略删除的文件；如果您想添加修改或新文件但忽略删除的文件，请使用 --no-all 选项。

实际上不添加文件，只是显示它们是否存在和/或是否将被忽略。

显示详细信息。

允许添加其他情况下将被忽略的文件。

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

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

以交互方式选择索引和工作树之间的补丁块，并将它们添加到索引。 这使用户有机会在将修改的内容添加到索引之前查看差异。

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

仅在索引已经有匹配 <pathspec> 的条目的位置更新索引。 这会删除以及修改索引条目以匹配工作树，但不添加新文件。

不仅在工作树具有匹配 <pathspec> 的文件的位置更新索引，而且在索引已经有条目的位置也更新索引。 这会添加、修改和删除索引条目以匹配工作树。

通过添加索引未知的新文件和工作目录中修改的文件来更新索引，但忽略已从工作目录中删除的文件。 当不使用 <pathspec> 时，此选项不起作用。

仅记录稍后将添加路径的事实。 路径的条目放置在索引中，没有内容。 这对于显示此类文件的未暂存内容 (使用 git diff) 以及使用 git commit -a 提交它们非常有用。

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

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

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

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

将 "clean" 过程重新应用于所有跟踪的文件，以强制将它们再次添加到索引。这在更改 core.autocrlf 配置或 text 属性之后非常有用，以便纠正以错误的 *CRLF/LF* 行尾添加的文件。此选项隐含 -u。单独的 CR 字符保持不变，因此，虽然 *CRLF* 清理为 *LF*，但 *CRCRLF* 序列仅部分清理为 *CRLF*。

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

Pathspec 在 *<file>* 中传递，而不是命令行参数。 如果 *<file>* 正好是 -，则使用标准输入。 Pathspec 元素由 *LF* 或 *CR/LF* 分隔。 Pathspec 元素可以像为配置变量 core.quotePath 所解释的那样进行引用（请参阅 git-config[1]）。 另请参阅 --pathspec-file-nul 和全局 --literal-pathspecs。

仅在与 --pathspec-from-file 一起使用时有意义。 Pathspec 元素用 *NUL* 字符分隔，所有其他字符都被视为字面量（包括换行符和引号）。

此选项可用于将命令行选项与文件列表分开，（当文件名可能被误认为是命令行选项时很有用）。

这显示了 HEAD 和索引之间的更改（即，如果您说 git commit 将提交的内容），以及索引和工作树文件之间的更改（即，在您使用 git add 之前可以进一步暂存的内容）。 示例输出如下所示

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

这显示了状态信息并发出 "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 add-interactive.c

Update>> -2

这具有与 *update* 非常相似的 UI，并且所选路径的暂存信息将恢复为 HEAD 版本的暂存信息。 还原新路径会使它们变为未跟踪。

这具有与 *update* 和 *revert* 非常相似的 UI，并允许您将未跟踪的路径添加到索引。

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

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 和索引之间）。

告诉 git add 在某些文件由于索引错误而无法添加时继续添加文件。 等效于 --ignore-errors 选项。 add.ignore-errors 已弃用，因为它不遵循配置变量的常用命名约定。