Git 暫存操作指南

在日常的 Git 使用場景中，我們常常會遇到各種復雜的情況，需要巧妙運用 Git 的功能來實現高效開發與代碼管理。接下來，我們將深入探討一個具體的開發實例，以及如何通過暫存功能完美解決其中的問題。

一、開發場景描述

當前，我們從遠程拉取了項目分支，本地同樣擁有與之對應的分支。在此基礎上，我們創建了一個特性分支用于專項開發。在特性分支的開發進程中，涉及對多個文件的操作，例如對 a 文件和 b 文件進行了多次修改，并且還有其他一系列文件也在不同階段有所變動。

此時，我們面臨的問題是：一方面，不想在每次提交時都將所有修改過的文件一股腦兒提交上去，而是希望有選擇性地控制提交內容；另一方面，在特性分支開發完成后，需要安全、準確地將成果合并回本地分支，并順利推送到遠程，同時確保整個過程中特性分支的修改不會對其他地方造成不必要的影響，并且在后續還能靈活地處理之前暫存的文件修改。

二、暫存操作詳解

（一）暫存單個或多個文件的某次修改

1. 指定文件名暫存
   • 當需要暫存特定文件，如 a 文件和 b 文件時，可使用以下命令：

git stash push -m "第一次修改 a 和 b 文件" a b

這會將 a 文件和 b 文件當前的修改狀態保存到一個暫存記錄中，并添加自定義的描述信息，方便后續識別。

• 但如果需要暫存的文件較多，逐個列出文件名就變得繁瑣。此時可以利用通配符：
  假設要暫存 src 目錄下所有 .js 文件的修改：

git stash push -m "第一次修改 src 目錄下的 js 文件" src/*.js

這樣就能一次性暫存符合條件的多個文件。
2. 交互式暫存部分文件修改

• 執行 git add -p 命令，Git 會逐塊顯示文件的修改內容，此時可以根據提示選擇是否暫存每個文件塊。例如：

# 交互式選擇要暫存的文件塊
git add -p
# 將暫存區的內容暫存起來
git stash push -m "第一次修改的部分文件"

通過這種方式，可以精細地選擇要暫存的文件部分，而非整個文件。

（二）查看暫存列表

使用 git stash list 命令可以查看所有的暫存記錄，輸出結果類似下面這樣：

stash@{0}: On <特性分支名>: 第二次修改 a 和 b 文件
stash@{0}: On <特性分支名>: 第一次修改 a 和 b 文件

每個暫存記錄都有對應的索引（如 stash@{0}、stash@{1} 等），方便后續操作時指定。

（三）切換到指定的暫存記錄

如果想應用某一次的修改，可以使用 git stash apply 命令。

1. 應用第一次修改

git stash apply stash@{1}

2. 應用第二次修改

git stash apply stash@{0}

應用暫存記錄后，相關文件的修改就會恢復到工作區，可按需進行提交等操作。

三、提交與合并流程

（一）提交修改

當應用了指定的暫存記錄后，若想提交這些修改，可按如下操作：

# 添加 a 文件和 b 文件到暫存區
git add a b
# 提交修改
git commit -m "提交 a 和 b 文件的指定修改"

這里的文件名根據實際情況替換，如果是使用通配符暫存的文件，一般添加相應的目錄或符合通配符條件的文件即可。

（二）切換回本地分支并合并特性分支

提交完成后，切換回原來的本地分支，并將特性分支的修改合并過來。

# 切換回本地分支
git checkout <本地分支名>
# 合并特性分支到本地分支
git merge <特性分支名>

（三）推送到遠程倉庫

合并完成后，將本地分支的修改推送到遠程倉庫。

# 推送到遠程倉庫
git push origin <本地分支名>

（四）拉取最新代碼

推送完成后，拉取遠程倉庫的最新代碼，確保本地和遠程倉庫同步。

# 拉取最新代碼
git pull origin <本地分支名>

四、清理暫存記錄（可選）

如果不再需要某些暫存記錄，可以使用 git stash drop 命令將其刪除。

1. 刪除第一次修改的暫存記錄

git stash drop stash@{1}

2. 刪除第二次修改的暫存記錄

git stash drop stash@{0}

通過合理利用 Git 的暫存功能，能夠在復雜的開發流程中，精準地管理文件修改狀態，確保代碼提交的準確性與靈活性，提升開發效率。在面對類似的復雜開發場景時，按照上述步驟操作，就能輕松駕馭 Git，讓開發工作有條不紊地進行。