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

不实际添加文件，仅显示它们是否存在以及/或者是否会被忽略。

显示详细信息。

允许添加通常被忽略的文件。

允许更新稀疏检出（sparse-checkout）锥体之外的索引项。通常，git add 会拒绝更新路径不符合稀疏检出锥体的索引项，因为这些文件可能会在没有警告的情况下从工作树中删除。详见 git-sparse-checkout[1]。

以交互方式将工作树中修改过的内容添加到索引中。可以提供可选的路径参数来将操作限制在工作树的子集中。详情请参“交互模式”。

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

生成具有 <n> 行上下文的 diff。如果配置选项未设置，则默认为 diff.context 或 3。

在差异块之间显示上下文，最多达指定行数 <number>，从而合并彼此接近的块。默认为 diff.interHunkContext，如果未设置配置选项则为 0。

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

仅在索引中已有匹配 <路径规格> 的条目处更新索引。这会移除或修改索引条目以匹配工作树，但不会添加新文件。

不仅在工作树有匹配 <路径规格> 的文件处更新索引，也在索引已有条目处更新。这会添加、修改和删除索引条目以匹配工作树。

通过添加索引未知的新文件和工作树中修改过的文件来更新索引，但忽略从工作树中删除的文件。当未使用 <路径规格> 时，此选项无效。

仅记录稍后将添加该路径的事实。该路径的一个条目被放入索引中，但不包含内容。这对于诸如使用 git diff 显示此类文件的未暂存内容，以及使用 git commit -a 提交它们等操作非常有用。

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

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

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

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

对所有已跟踪文件重新应用“清理（clean）”过程，以强制重新将它们添加到索引。在更改了 core.autocrlf 配置或 text 属性后，这对于纠正以错误 CRLF/LF 换行符添加的文件非常有用。此选项隐含了 -u。单独的 CR 字符不会被处理，因此虽然 CRLF 会清理为 LF，但 CRCRLF 序列仅会部分清理为 CRLF。

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

路径规格通过 <文件> 传递，而不是通过命令行参数。如果 <文件> 正好是 -，则使用标准输入。路径规格元素由 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 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 非常相似的界面，所选路径的暂存信息将还原为 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 - go to the next undecided hunk, roll over at the bottom
J - go to the next hunk, roll over at the bottom
k - go to the previous undecided hunk, roll over at the top
K - go to the previous hunk, roll over at the top
s - split the current hunk into smaller hunks
e - manually edit the current hunk
p - print the current hunk
P - print the current hunk using the pager
? - print help

这让您可以查看将要提交的内容（即 HEAD 与索引之间的差异）。

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