HOWTO · Git
通過 Git 以不同方式將檔案新增到暫存中
說明如何使用 git add -A、git add . 與 git add -u 暫存新增、修改及刪除的檔案,並在提交前檢查或調整索引。
本頁內容
Git 會將變更暫存到索引(也稱為暫存區),其中保存準備納入下一次提交的內容。暫存不會建立提交,而是讓你先選擇並檢查這份快照。若要暫存工作樹中的所有變更,請在儲存庫根目錄執行 git add -A,然後在提交前檢查索引。
Git 中「全部新增」的意思
「全部」指的是你指定給 Git 的範圍內所有變更,而不是電腦上的每個檔案。變更可能是新增檔案、修改已追蹤的檔案,或刪除檔案。索引會記錄下一次提交將包含的檔案版本與刪除項目。符合忽略規則的檔案通常不會納入一般的新增操作;如果預期中的未追蹤檔案沒有出現,請檢查忽略規則。
選擇合適的 git add 形式
| 命令 | 新檔案 | 已修改的追蹤檔案 | 已刪除的追蹤檔案 | 範圍 |
|---|---|---|---|---|
git add -A 或 git add --all |
是 | 是 | 是 | 未指定路徑時涵蓋整個工作樹;否則只涵蓋提供的 pathspec |
git add . |
是 | 是 | 是 | 目前目錄及其子目錄 |
git add -u |
否 | 是 | 是 | 工作樹中的追蹤檔案,或提供的 pathspec |
長選項是 git add --all;git add -all 並不是它的等效寫法。未提供 pathspec 時,git add -A 會暫存整個工作樹中的變更。若只想處理目前目錄及其子目錄,git add . 就很實用。從子目錄執行時,其範圍不包含同層的其他目錄或上層路徑。git add -u 會更新追蹤中的路徑,但不會新增檔案。pathspec 可以進一步限制各命令的範圍;若希望由 Git 而非 shell 解讀模式,請將模式加上引號。
使用 git add -A 暫存所有變更
如果要暫存工作樹中所有未被忽略的新增、修改和刪除,請在儲存庫根目錄執行此命令:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
set -eu
repo=$(mktemp -d)
trap 'rm -rf "$repo"' EXIT
git -C "$repo" init -q
git -C "$repo" config user.name Example
git -C "$repo" config user.email example@example.invalid
printf 'before\n' > "$repo/changed.txt"
printf 'keep\n' > "$repo/removed.txt"
git -C "$repo" add changed.txt removed.txt
git -C "$repo" commit -qm initial
printf 'after\n' > "$repo/changed.txt"
rm "$repo/removed.txt"
printf 'new file\n' > "$repo/new.txt"
git -C "$repo" add -A
git -C "$repo" status --short --untracked-files=all
這個範例會建立暫存儲存庫,在暫存前修改一個追蹤檔案、刪除另一個檔案,並新增一個檔案。最後的狀態會列出已暫存的路徑及其狀態字母。簡短狀態中的兩欄分別代表索引與工作樹;左欄出現字母表示該變更已暫存。範例可獨立執行,結束時也會移除暫存檔案。
如果只想處理某個子目錄,可以明確指定路徑,例如 git add -A -- src/。Git 會暫存該 pathspec 範圍內符合條件的新增、修改和刪除。提交前請確認範圍,尤其是從子目錄執行命令或使用涵蓋範圍較廣的 pathspec 時。
檢查並調整已暫存的變更
使用 git status 查看哪些路徑已暫存,以及哪些仍有尚未暫存的編輯。用 git diff --cached 檢查已暫存的差異;git diff --cached --stat 則會提供精簡摘要。請檢查差異內容本身,因為路徑顯示為已暫存,並不代表其內容適合納入提交。
若要將路徑從索引移除,但保留工作樹中的內容,請執行 git reset -- path/to/file。這只會改變暫存內容,不會捨棄該檔案的編輯。接著,你可以重新暫存修正後的版本或更小範圍的變更,再次檢查索引。
改為暫存指定檔案或部分內容
如果不打算納入所有變更,請指定檔案:git add README.md,或列出多個路徑,例如 git add src/app.py tests/test_app.py。若要互動式選擇已追蹤檔案中的部分編輯,請執行 git add -p,再選擇要暫存的區塊。這些命令能縮小暫存範圍,不會暫存工作樹中的所有變更。最後,檢查 git status 和 git diff --cached,確認下一次提交包含的是你預期的變更。