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

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

显示详细信息。

允许添加原本被忽略的文件。

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

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

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

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

仅更新索引中已存在匹配 <pathspec> 的条目。这会删除并修改索引条目以匹配工作树，但不添加任何新文件。

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

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

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

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

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

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

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

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

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

路径规范（pathspec）在 <file> 中传递，而不是命令行参数。如果 <file> 恰好是 -，则使用标准输入。路径规范元素由 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 的选择中选择一个路径。选择路径后，它会显示索引和工作树文件之间的差异，并询问您是否要暂存每个补丁块（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 已废弃，因为它不遵循配置变量的常规命名约定。