要新增內容的檔案。可以使用檔案萬用字元（例如 *.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 已廢棄，因為它不遵循配置變數的常規命名約定。