git stash 命令實用指南

版本控制是軟體開發人員日常生活中不可分割的一部分。很難想像有哪個團隊在開發軟體時不使用版本控制工具。同樣也很難想像有哪個開發者沒有使用過（或沒有聽說過）Git。在 2018 年 Stackoverflow 開發者調查中，74298 名參與者中有 87.2% 的人 使用 Git 進行版本控制。

Linus Torvalds 在 2005 年創建了 Git 用於開發 Linux 內核。本文將介紹 git stash 命令，並探討一些有用的暫存變更的選項。本文假定你對 Git 概念 有基本的了解，並對工作樹、暫存區和相關命令有良好的理解。

為什麼 git stash 很重要？

首先要明白為什麼在 Git 中暫存變更很重要。假設 Git 沒有暫存變更的命令。當你正在一個有兩個分支（A 和 B）的倉庫上工作時，這兩個分支已經分叉了一段時間，並且有不同的頭。當你正在處理 A 分支的一些文件時，你的團隊要求你修復 B 分支的一個錯誤。你迅速將你的修改保存到 A 分支（但沒有提交），並嘗試用 git checkout B 來簽出 B 分支。Git 會立即中止了這個操作，並拋出錯誤：「你對以下文件的本地修改會被該簽出覆蓋……請在切換分支之前提交你的修改或將它們暫存起來。」

在這種情況下，有幾種方法可以啟用分支切換：

• 在分支 A 中創建一個提交，提交並推送你的修改，以修復 B 中的錯誤，然後再次簽出 A，並運行 git reset HEAD^ 來恢復你的修改。
• 手動保留不被 Git 跟蹤的文件中的改動。

第二種方法是個餿主意。第一種方法雖然看起來很傳統，但卻不太靈活，因為保存未完成工作的修改會被當作一個檢查點，而不是一個仍在進行中的補丁。這正是設計 git stash 的場景。

git stash 將未提交的改動保存在本地，讓你可以進行修改、切換分支以及其他 Git 操作。然後，當你需要的時候，你可以重新應用這些存儲的改動。暫存是本地範圍的，不會被 git push 推送到遠程。

如何使用 git stash

下面是使用 git stash 時要遵循的順序：

1. 將修改保存到分支 A。
2. 運行 git stash。
3. 簽出分支 B。
4. 修正 B 分支的錯誤。
5. 提交並（可選）推送到遠程。
6. 查看分支 A
7. 運行 git stash pop 來取回你的暫存的改動。

git stash 將你對工作目錄的修改存儲在本地（在你的項目的 .git 目錄內，準確的說是 /.git/refs/stash），並允許你在需要時檢索這些修改。當你需要在不同的上下文之間切換時，它很方便。它允許你保存以後可能需要的更改，是讓你的工作目錄乾淨同時保持更改完整的最快方法。

如何創建一個暫存

暫存你的變化的最簡單的命令是 git stash：

$ git stash
Saved working directory and index state WIP on master; d7435644 Feat: configure graphql endpoint

默認情況下，git stash 存儲（或稱之為「暫存」）未提交的更改（已暫存和未暫存的文件），並忽略未跟蹤和忽略的文件。通常情況下，你不需要暫存未跟蹤和忽略的文件，但有時它們可能會干擾你在代碼庫中要做的其他事情。

你可以使用附加選項讓 git stash 來處理未跟蹤和忽略的文件：

• git stash -u 或 git stash --includ-untracked 儲存未追蹤的文件。
• git stash -a 或 git stash --all 儲存未跟蹤的文件和忽略的文件。

要存儲特定的文件，你可以使用 git stash -p 或 git stash -patch 命令：

$ git stash --patch
diff --git a/.gitignore b/.gitignore
index 32174593..8d81be6e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,6 +3,7 @@
 # dependencies
 node_modules/
 /.pnp
+f,fmfm
 .pnp.js

 # testing
(1/1) Stash this hunk [y,n,q,a,d,e,?]?

列出你的暫存

你可以用 git stash list 命令查看你的暫存。暫存是後進先出（LIFO）方式保存的：

$ git stash list
stash@{0}: WIP on master: d7435644 Feat: configure graphql endpoint

默認情況下，暫存會顯示在你創建它的分支和提交的頂部，被標記為 WIP。然而，當你有多個暫存時，這種有限的信息量並沒有幫助，因為很難記住或單獨檢查它們的內容。要為暫存添加描述，可以使用命令 git stash save <description>：

$ git stash save "remove semi-colon from schema"
Saved working directory and index state On master: remove semi-colon from schema

$ git stash list
stash@{0}: On master: remove semi-colon from schema
stash@{1}: WIP on master: d7435644 Feat: configure graphql endpoint

檢索暫存起來的變化

你可以用 git stash apply 和 git stash pop 這兩個命令來重新應用暫存的變更。這兩個命令都會重新應用最新的暫存（即 stash@{0}）中的改動。apply 會重新應用變更；而 pop 則會將暫存的變更重新應用到工作副本中，並從暫存中刪除。如果你不需要再次重新應用被暫存的更改，則首選 pop。

你可以通過傳遞標識符作為最後一個參數來選擇你想要彈出或應用的儲藏：

$ git stash pop stash@{1}

或

$ git stash apply stash@{1}

清理暫存

刪除不再需要的暫存是好的習慣。你必須用以下命令手動完成：

• git stash clear 通過刪除所有的暫存庫來清空該列表。
• git stash drop <stash_id> 從暫存列表中刪除一個特定的暫存。

檢查暫存的差異

命令 git stash show <stash_id> 允許你查看一個暫存的差異：

$ git stash show stash@{1}
console/console-init/ui/.graphqlrc.yml        |   4 +-
console/console-init/ui/generated-frontend.ts | 742 +++++++++------console/console-init/ui/package.json          |   2 +-

要獲得更詳細的差異，需要傳遞 --patch 或 -p 標誌：

$ git stash show stash@{0} --patch
diff --git a/console/console-init/ui/package.json b/console/console-init/ui/package.json
index 755912b97..5b5af1bd6 100644
--- a/console/console-init/ui/package.json
+++ b/console/console-init/ui/package.json
@@ -1,5 +1,5 @@
 {
- "name": "my-usepatternfly",
+ "name": "my-usepatternfly-2",
  "version": "0.1.0",
  "private": true,
  "proxy": "http://localhost:4000"
diff --git a/console/console-init/ui/src/AppNavHeader.tsx b/console/console-init/ui/src/AppNavHeader.tsx
index a4764d2f3..da72b7e2b 100644
--- a/console/console-init/ui/src/AppNavHeader.tsx
+++ b/console/console-init/ui/src/AppNavHeader.tsx
@@ -9,8 +9,8 @@ import { css } from "@patternfly/react-styles";

interface IAppNavHeaderProps extends PageHeaderProps {
- toolbar?: React.ReactNode;
- avatar?: React.ReactNode;
+ toolbar?: React.ReactNode;
+ avatar?: React.ReactNode;
}

export class AppNavHeader extends React.Component<IAppNavHeaderProps>{
  render()

簽出到新的分支

你可能會遇到這樣的情況：一個分支和你的暫存中的變更有分歧，當你試圖重新應用暫存時，會造成衝突。一個簡單的解決方法是使用 git stash branch <new_branch_name stash_id> 命令，它將根據創建暫存時的提交創建一個新分支，並將暫存中的修改彈出：

$ git stash branch test_2 stash@{0}
Switched to a new branch 'test_2'
On branch test_2
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: .graphqlrc.yml
modified: generated-frontend.ts
modified: package.json
no changes added to commit (use "git add" and/or "git commit -a")
Dropped stash@{0} (fe4bf8f79175b8fbd3df3c4558249834ecb75cd1)

在不打擾暫存參考日誌的情況下進行暫存

在極少數情況下，你可能需要創建一個暫存，同時保持暫存參考日誌（reflog）的完整性。這些情況可能出現在你需要一個腳本作為一個實現細節來暫存的時候。這可以通過 git stash create 命令來實現；它創建了一個暫存條目，並返回它的對象名，而不將其推送到暫存參考日誌中：

$ git stash create "sample stash"
63a711cd3c7f8047662007490723e26ae9d4acf9

有時，你可能會決定將通過 git stash create 創建的暫存條目推送到暫存參考日誌：

$ git stash store -m "sample stash testing.." "63a711cd3c7f8047662007490723e26ae9d4acf9"
$ git stash list
stash @{0}: sample stash testing..

結論

我希望你覺得這篇文章很有用，並學到了新的東西。如果我遺漏了任何有用的使用暫存的選項，請在評論中告訴我。

via: https://opensource.com/article/21/4/git-stash

作者：Ramakrishna Pattnaik 選題：lujun9972 譯者：wxy 校對：wxy

本文由 LCTT 原創編譯，Linux中國 榮譽推出

本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive