HOWTO · Git

在 Git 中遞迴新增檔案和資料夾

本教程演示瞭如何通過 git add 命令遞迴地在 Git 中新增檔案和資料夾。

本頁內容

Git 會將檔案變更放入索引(index),以便準備下一次提交。若要納入巢狀目錄中的檔案,可搭配整個儲存庫或特定目錄的路徑使用 git add。這個命令只會暫存變更;它不會建立提交,也不會將任何內容傳送到遠端儲存庫。

git add 如何遞迴暫存檔案

將目錄路徑交給 git add 時,Git 會暫存該路徑下符合條件的變更,包括子目錄中的檔案。你也可以使用 git add -A 暫存整個工作樹中的變更,或使用 git add . 暫存目前目錄及其下層的變更。這些命令都不需要另外指定遞迴選項。

路徑範圍很重要:從子目錄執行命令時,只會處理該命令所指定範圍內的路徑。若要暫存整個儲存庫,請選擇儲存庫根目錄;若要縮小選取範圍,則指定目錄。除非你刻意覆寫忽略規則,否則規則仍會套用於尚未追蹤的檔案。

從儲存庫根目錄暫存所有變更

若要暫存整個儲存庫中的變更,請先切換到儲存庫根目錄,再執行 git add -A。它會暫存整個工作樹中的新增、修改和刪除。若你在專案不同位置修改了檔案,並希望一次選取整個儲存庫的變更,這個命令就很實用。

請在已安裝 Git 的 Shell 中執行這個自成一體的範例。它會建立暫存儲存庫、新增兩個巢狀檔案、從儲存庫根目錄暫存變更,並輸出簡短狀態。指令碼結束時會移除暫存目錄。

本節中的程式碼以及顯示的標籤或輸出仍為英文。

work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
mkdir -p src/lib
printf 'app\n' > README.md
printf 'module\n' > src/lib/module.txt
git add -A
git status --short

若你只想暫存目前目錄及其下層的變更,請使用 git add .。在儲存庫根目錄執行時,它通常涵蓋與 git add -A 相同的工作樹路徑;但若從子目錄執行,git add . 的範圍就只限於該目錄及其下層,而 git add -A 則會暫存整個儲存庫中的變更。若要明確選取整個儲存庫,請在根目錄執行 git add -A。

暫存特定目錄

若要將暫存範圍限制在專案中的某個區域,請在儲存庫根目錄執行 git add path/to/directory/,並將範例路徑換成目標目錄。Git 會納入該路徑下符合條件的新增和修改檔案。指定目錄路徑也會讓 Git 暫存該目錄中已追蹤檔案的刪除,讓索引反映這些刪除。

如果工作樹其他位置還有無關變更,縮小範圍會很有幫助。暫存前請確認路徑指向正確的目錄;git add 會將所選變更記錄在索引中,不會另行複製該目錄。若只想暫存單一檔案,請改為提供該檔案的路徑。

處理遭忽略的檔案

.gitignore 檔案會告訴 Git,哪些尚未追蹤的路徑應排除於一般暫存之外。例如,*.log 這類模式可以讓產生的記錄檔不會被 git add -A、git add . 或目錄路徑暫存。忽略規則適合用來排除建置輸出、本機設定,以及其他不應納入提交的檔案。

若某個遭忽略的檔案確實應納入追蹤,請先查明它被忽略的原因,再使用 git add -f path/to/file 明確暫存該路徑。強制選項會覆寫指定路徑的忽略規則。只有在該檔案確實應納入儲存庫時才使用;若將產生的檔案或私人檔案強制加入索引,可能會暴露不該公開的內容。在 .gitignore 中新增模式,也不會移除 Git 已經追蹤的檔案。

提交前檢查已暫存的變更

暫存後,執行 git status,即可查看哪些路徑已暫存,以及是否還有未暫存的變更。若要查看精簡資訊,可執行 git status --short:狀態的第一欄標示已暫存的路徑,第二欄則標示尚未暫存的變更。建立提交前請檢查清單,尤其是在暫存整個儲存庫之後,並確認沒有加入遭忽略或無關的檔案。

暫存只是提交前的準備步驟。提交會將已暫存的快照記錄在本機儲存庫歷史中;推送則是另一個操作,會將提交傳送到遠端。你可以遞迴暫存而不提交或推送,也可以在提交前重新暫存預期的路徑來修改索引。