2. 帶備注存儲：git stash push -m "備注信息" 【強烈推薦】

git stash push -m "首頁輪播圖樣式修改-未完成" 

git stash push -m "訂單模塊bug修復(fù)-待測試"

功能：和 git stash 功能一致，唯一區(qū)別是給本次儲藏添加「自定義備注」。

為什么強烈推薦？當(dāng)你多次 git stash 后，會有多個儲藏記錄，帶備注能一眼區(qū)分每個儲藏對應(yīng)的修改內(nèi)容，不會混淆，避免后續(xù)恢復(fù)錯代碼！

3. 查看所有儲藏記錄：git stash list

git stash list

功能：查看 Git 儲藏棧中所有的臨時存儲記錄，輸出格式如下：

stash@{0}: On dev: 搜索框樣式優(yōu)化-未完成 
stash@{1}: On dev: 篩選條單選失效問題修復(fù)-待測試 

• 儲藏棧是「后進先出」的結(jié)構(gòu)（棧結(jié)構(gòu)）：最新的儲藏記錄排在最上面，編號 stash@{0}；
• 每個記錄包含：編號、所屬分支、自定義備注。

4. 恢復(fù)儲藏的修改：git stash pop 【最常用恢復(fù)方式】

# 恢復(fù)「最新的儲藏記錄」(stash@{0})，恢復(fù)后自動刪除這條儲藏記錄 
git stash pop 

# 恢復(fù)「指定編號」的儲藏記錄，恢復(fù)后自動刪除該記錄 
git stash pop stash@{1}

• 核心功能：將儲藏的修改恢復(fù)到當(dāng)前工作區(qū)，恢復(fù)后代碼和你 stash 之前完全一致（工作區(qū) + 暫存區(qū)的修改都回來）。
• 關(guān)鍵特性：pop = 「恢復(fù) + 刪除」，恢復(fù)后這條儲藏記錄就從棧中消失了，適合確認(rèn)只恢復(fù)一次的場景。

5. 恢復(fù)儲藏的修改：git stash apply 【備選恢復(fù)方式】

# 恢復(fù)最新的儲藏記錄(stash@{0})，恢復(fù)后「不刪除」這條儲藏記錄
git stash apply

# 恢復(fù)指定編號的儲藏記錄，恢復(fù)后「不刪除」該記錄
git stash apply stash@{1}

• 核心功能：和 git stash pop 幾乎一樣，都是把儲藏的修改恢復(fù)到工作區(qū)。
• 關(guān)鍵區(qū)別：apply = 「只恢復(fù)，不刪除」，恢復(fù)后這條儲藏記錄依然保存在棧中，適合需要多次恢復(fù)同一份修改的場景。

? 重點區(qū)分：git stash pop vs git stash apply（必考必用）

這兩個命令是最容易混淆的，記住核心差異只有一個：是否刪除儲藏記錄

? git stash pop：恢復(fù) + 刪除記錄 → 「一次性恢復(fù)」，用完即刪，推薦日常使用；

? git stash apply：只恢復(fù)，不刪記錄 → 「可重復(fù)恢復(fù)」，恢復(fù)后還能再次恢復(fù)這份修改，適合特殊場景。

三、Git Stash 進階命令（必會，解決 80% 的問題）

1. 刪除指定儲藏記錄：git stash pop儲藏編號

# 刪除最新的儲藏記錄
git stash drop stash@{0}

# 刪除指定編號的儲藏記錄
git stash drop stash@{2}

功能：只刪除，不恢復(fù)。當(dāng)你有一些無用的儲藏記錄，不想恢復(fù)只想清理時，用這個命令。

2. 刪除所有儲藏記錄：git stash clear

git stash clear

功能：清空 Git 儲藏棧中的所有儲藏記錄，慎用執(zhí)行后無法恢復(fù)被刪除的記錄，適合確認(rèn)所有儲藏都無用時的批量清理。

3. 查看儲藏的「具體修改內(nèi)容」：git stash show

# 查看最新儲藏的「文件變更列表」（只顯示文件名+增刪行數(shù)） 
git stash show

# 查看最新儲藏的「完整diff詳情」（顯示具體修改的代碼行，推薦） 
git stash show -p

# 查看指定編號儲藏的完整diff詳情
git stash show -p stash@{1}

功能：在恢復(fù)儲藏前，想先看看這份儲藏里具體改了哪些代碼，避免恢復(fù)錯內(nèi)容時，用這個命令，-p 參數(shù)是核心（patch 補丁模式），能看到完整的代碼修改。

1. 儲藏「未追蹤的新文件」：git stash -u / git stash --include-untracked

git stash -u
# 等價寫法
git stash --include-untracked

重要特性補充：默認(rèn)的 git stash 只會儲藏「已追蹤的文件」（已經(jīng)被 Git 管理的文件，比如之前 commit 過的文件），對于工作區(qū)中新建的、從未被 git add 過的新文件（未追蹤文件） ，默認(rèn)不會被儲藏。

加 -u 參數(shù)后：會把「已追蹤文件的修改 + 未追蹤的新文件」一起儲藏，工作區(qū)徹底干凈，連新文件都被隱藏了。

5. 儲藏「忽略的文件」：git stash -a / git stash --all

git stash -a
# 等價寫法
git stash --all

功能：最強的儲藏命令，會儲藏「已追蹤文件修改 + 未追蹤新文件 + .gitignore 中忽略的文件」（比如 node_modules、dist 等），適合需要完全清空工作區(qū)的場景，日常開發(fā)很少用，特殊場景（比如切換分支前徹底清理）可用。

四、Git Stash 避坑指南 & 核心注意事項（重中之重，必看！）

這部分是最容易踩坑的地方，很多人用 stash 出問題，都是因為沒注意這些規(guī)則，全部記住，能避開 99% 的坑！

? 注意 1：git stash 不會儲藏的內(nèi)容（默認(rèn)行為）

默認(rèn)執(zhí)行 git stash 時，以下內(nèi)容絕對不會被儲藏，會原封不動留在工作區(qū)：

• 從未被 Git 追蹤過的文件（新建的、沒執(zhí)行過 git add 的文件）；
• 被 .gitignore 忽略的文件（比如依賴包、打包產(chǎn)物、日志文件）；
• 已經(jīng)提交到版本庫的文件（只會處理「未提交」的修改）。

? 解決辦法：需要儲藏未追蹤文件用 git stash -u，需要儲藏忽略文件用 git stash -a。

? 注意 2：stash 的恢復(fù)與「分支無關(guān)」，但有最佳實踐

很多人誤以為「在哪個分支 stash，就只能在哪個分支恢復(fù)」，這個認(rèn)知是錯誤的！

真相：Git 的 stash 是「全局的」，儲藏的是「文件的修改內(nèi)容」，不是和分支綁定的，你可以在 dev 分支 stash，然后切換到 test 分支恢復(fù)。

最佳實踐：盡量在哪個分支儲藏，就在哪個分支恢復(fù)！

原因：不同分支的代碼差異可能很大，跨分支恢復(fù) stash 大概率會觸發(fā)「代碼沖突」，處理沖突會增加不必要的麻煩，除非你明確知道兩份代碼無沖突。

? 注意 3：儲藏記錄的「生命周期」

儲藏記錄不是永久保存的，它是「臨時緩存」，以下操作會刪除儲藏記錄：

• 執(zhí)行 git stash pop 編號：恢復(fù)后自動刪除該記錄；
• 執(zhí)行 git stash drop 編號：手動刪除該記錄；
• 執(zhí)行 git stash clear：刪除所有記錄；
• 倉庫被刪除 / 遷移：儲藏記錄會跟著倉庫消失（不會同步到遠程倉庫）。

? 注意 4：stash 無法儲藏「空文件 / 空目錄」

如果你的修改只是新建了一個空文件 / 空目錄，執(zhí)行 git stash 不會生效，Git 會提示「No local changes to save」，這是 Git 的默認(rèn)規(guī)則，無需處理。

? 五、Git Stash 完整工作流程演示（工作中最常用，直接套用）

給你一套完整的「標(biāo)準(zhǔn)流程」，遇到「代碼沒寫完要切分支」的場景，直接按步驟執(zhí)行即可，零錯誤、零踩坑，這是工作中最經(jīng)典的用法：

場景：在 dev 分支開發(fā)新功能，寫到一半，需要切換到 test 分支修緊急 Bug

# 步驟1：當(dāng)前在 dev 分支，代碼沒寫完，帶備注儲藏所有修改（推薦帶-m）
git stash push -m "dev-個人中心模塊開發(fā)-未完成"

# 步驟2：查看儲藏記錄，確認(rèn)儲藏成功（可選，養(yǎng)成好習(xí)慣）
git stash list

# 步驟3：切換到目標(biāo)分支（此時工作區(qū)干凈，切換無任何問題）
git checkout test

# 步驟4：在 test 分支修復(fù) Bug，完成后正常提交
git add . git commit -m "test-修復(fù)訂單支付失敗bug"

# 步驟5：切回原分支
dev git checkout dev

# 步驟6：恢復(fù)之前儲藏的未完成代碼（推薦用pop，恢復(fù)后刪除記錄）
git stash pop

# 步驟7：繼續(xù)開發(fā)未完成的功能即可，代碼和之前完全一致 ??

核心知識點速記

核心概念

1. git stash：臨時保存未提交修改，讓工作區(qū)變干凈，核心場景「代碼沒寫完要切分支」；
2. stash 是「棧結(jié)構(gòu)」，后進先出，最新的記錄是 stash@{0}。

必會核心命令（按優(yōu)先級排序）

1. 儲藏：git stash push -m "備注" （帶備注，推薦首選）
2. 查看：git stash list
3. 恢復(fù)：git stash pop （恢復(fù) + 刪除，日常首選） / git stash apply（恢復(fù)不刪除，備選）
4. 刪除：git stash drop 編號（刪指定） / git stash clear（刪全部）
5. 查看修改：git stash show -p

兩大避坑重點

1. 默認(rèn)不儲藏「未追蹤文件」和「忽略文件」，需要則加 -u / -a；
2. 盡量「同分支儲藏、同分支恢復(fù)」，避免跨分支沖突。

核心區(qū)別速記

git stash pop → 恢復(fù) + 刪記錄；git stash apply → 恢復(fù)不刪記錄。

小劇場分享幾個好看的MD主題

• qklhk-chocolate
• scrolls-light
• Chinese-red
• nico
• devui-blue
• z-blue
• yu

以上就是一文詳解Git的暫存與stash功能的詳細(xì)內(nèi)容，更多關(guān)于Git暫存與stash操作的資料請關(guān)注腳本之家其它相關(guān)文章！