如何在 Git 中命名 Stash 並按名稱檢索 Stash？

---

Git 是一種強大的版本控制系統，允許開發人員有效地管理專案中的更改。Git 提供的一個便捷功能是暫存（stash），它允許您臨時儲存更改而不提交它們。預設情況下，Git 暫存會為每個暫存分配一個自動生成的名稱，這使得以後難以識別和檢索特定的暫存。但是，Git 也提供了命名暫存的功能，這為管理您的工作提供了更組織化和便捷的方法。

在本教程中，我們將探討如何在 Git 中命名暫存以及如何按名稱檢索暫存。我們將逐步介紹該過程，並沿途解釋每個概念。無論您是 Git 新手還是經驗豐富的使用者，本指南都將幫助您利用命名暫存的功能並改進您的工作流程。

瞭解 Git 暫存

在深入探討 Git 中命名和檢索暫存之前，讓我們首先了解 Git 暫存的概念以及 Git stash 命令的預設行為。

什麼是 Git 暫存？

Git 暫存是一個功能，允許您儲存工作目錄中的更改而不提交它們。當您正在處理某個功能或錯誤修復，並且需要切換到另一個分支或處理緊急任務時，此功能非常方便。您可以暫存您的更改，並在以後準備好繼續時再應用它們，而不是提交不完整的更改或建立單獨的分支。

預設的暫存行為

預設情況下，當您使用 git stash 命令而不指定名稱時，Git 會建立一個帶有自動生成名稱的暫存，例如“stash@{n}”。n 表示一個數字索引，每次建立新的暫存時都會遞增。雖然此預設行為很有用，但當您儲存了多個暫存時，可能難以記住或識別特定的暫存。

現在我們對 Git 暫存有了基本的瞭解，讓我們來探討如何命名暫存以及如何使用其分配的名稱來檢索它們。

命名暫存

為了使您的暫存更易於識別和管理，Git 允許您為暫存分配自定義名稱。讓我們來探討如何在 Git 中建立命名暫存。

建立命名暫存

要在 Git 中建立命名暫存，您可以使用 git stash save 命令，並使用 -m 或 --message 選項，後跟引號中的所需名稱。以下是一個示例：

git stash save -m "my_stash_name"

上述命令將建立一個名為“my_stash_name”的暫存。您可以將“my_stash_name”替換為任何有意義的名稱，以幫助您記住暫存的目的或內容。

命名規則和最佳實踐

在命名暫存時，務必遵循以下一些規則和最佳實踐：

• 使用描述性名稱 − 選擇能夠清楚指示暫存內容或目的的名稱。

• 簡潔明瞭 − 保持名稱簡短且簡潔，同時仍然傳達必要的資訊。

• 避免使用特殊字元和空格 − 堅持使用字母數字字元，並在需要時使用連字元或下劃線，因為某些特殊字元可能會導致問題。

在下一節中，我們將探討如何在 Git 中按其分配的名稱檢索暫存。

按名稱檢索暫存

現在我們已經建立了一個命名暫存，讓我們來探討如何使用其分配的名稱在 Git 中檢索暫存。為此，可以使用幾種命令。

檢視可用的暫存

在按名稱檢索暫存之前，讓我們首先了解如何檢視所有可用的暫存及其相應的名稱。為此，我們可以使用 git stash list 命令。只需在您的 Git 儲存庫中執行以下命令：

git stash list

此命令將顯示所有暫存的列表，包括它們的名稱和其他相關資訊。然後，您可以根據其分配的名稱識別要檢索的暫存。

應用命名暫存

要應用特定的命名暫存，您有兩個選項：git stash apply 和 git stash pop。這兩個命令之間的主要區別在於，git stash apply 會保留暫存，以便您將來可以再次應用它，而 git stash pop 則在應用暫存後將其刪除。

要應用命名暫存，請使用以下命令：

git stash apply <stash_name>

將 <stash_name> 替換為您要應用的暫存的實際名稱。

刪除命名暫存

成功應用暫存後，您可能希望將其從暫存列表中刪除，尤其是在您不再需要它時。要刪除或移除命名暫存，您可以使用 git stash drop 命令，後跟暫存名稱：

git stash drop <stash_name>

此命令將從列表中刪除指定的暫存。

從命名暫存建立分支

在某些情況下，您可能希望根據儲存在特定命名暫存中的更改建立新的分支。Git 提供了一個方便的命令 git stash branch 來實現此目的。執行以下命令：

git stash branch <new_branch_name> <stash_name>

將 <new_branch_name> 替換為所需的新分支名稱，並將 <stash_name> 替換為您要基於其建立分支的暫存名稱。此命令會自動應用暫存並使用給定的名稱建立一個新分支，允許您繼續處理儲存在暫存中的更改。

管理命名暫存

現在您已經瞭解瞭如何在 Git 中建立和檢索命名暫存，讓我們來探討一些其他管理技巧，以幫助您有效地組織和處理暫存。

重新命名暫存

如果要更改暫存的名稱，Git 提供了一個名為 git stash rename 的命令。使用此命令，您可以更新現有暫存的名稱，而不會影響其內容。以下是語法：

git stash rename <old_stash_name> <new_stash_name>

將 <old_stash_name> 替換為您要重新命名的暫存的當前名稱，並將 <new_stash_name> 替換為所需的新名稱。

應用最近的暫存

有時您可能希望快速應用最近的暫存，而無需指定其名稱。Git 使用帶有 stash@{0} 表示法的 git stash apply 命令為此提供了快捷方式。只需執行以下命令：

git stash apply stash@{0}

此命令會將最近的暫存應用到您的工作目錄。

清除所有暫存

如果要從暫存列表中刪除所有暫存，可以使用 git stash clear 命令。它會永久刪除所有暫存，因此請確保在執行此命令之前已應用或儲存了所有必要的更改。

git stash clear

暫存組織技巧

為了維護井井有條的暫存工作流程，請考慮以下技巧：

• 使用有意義的名稱 − 為每個暫存提供一個描述性名稱，以反映其內容或目的。

• 為暫存添加註釋 − 在建立暫存時使用 -m 或 --message 選項，以包含有關更改的附加註釋或說明

• 定期檢視和管理暫存 − 定期檢視您的暫存列表並刪除任何不必要或過時的暫存，以保持其整潔和易於管理。

結論

在 Git 中按名稱命名和檢索暫存是一項寶貴的技巧，它可以增強您的工作流程並使暫存管理更高效。透過為您的暫存分配有意義的名稱，您可以輕鬆識別和回憶在需要時進行的特定更改。我們探討了如何建立命名暫存、檢視可用暫存、應用它們、刪除它們、從中建立分支以及有效地管理它們。