bugl
bugl
HomeLearnPatternsPathsSearch
HomeLearnPatternsPathsSearch

Loading lesson path

Learn/Git/Git Tutorial
Git•Git Tutorial

Git Stash

Flash cards

Review the key moves

1/4
Core idea

What is the main idea behind Git Stash?

Lesson checks

Practice each idea before moving on

Short Mimo-style checks built from this lesson's code, terms, and sequence.

1Quick choice

Which statement best captures the main point of this lesson?

2Fill blank

Complete the missing token from the example code.

___ working directory and index state WIP on main: 1234567 Add new feature
3Order

Put the learning moves in the order that makes the concept easiest to apply.

Stash with a Message ( git stash push -m )
Stash Your Changes ( git stash )
Key Commands for Stashing

Key Commands for Stashing

  • git stash - Stash your changes
  • git stash push -m "message" - Stash with a message
  • git stash list - List all stashes
  • git stash branch <branchname> - Create a branch from a stash

What is Git Stash? Why Use It?

Sometimes you need to quickly switch tasks or fix a bug, but you're not ready to commit your work.

git stash lets you save your uncommitted changes and return to a clean working directory.

You can come back and restore your changes later.

Here are some common use cases

  • Switch branches safely: Save your work before changing branches.
  • Handle emergencies: Stash your work to fix something urgent, then restore it.
  • Keep your work-in-progress safe: Avoid messy commits or losing changes.

Stash Your Changes ( git stash )

Save your current changes (both staged and unstaged tracked files) with:

  • Tracked files (both staged and unstaged) are stashed by default.
  • Untracked files (new files not yet added to Git) are not stashed by default.
  • To stash untracked files too, use git stash -u (or --include-untracked ).

Example: Stash Your Work

git stash
Saved working directory and index state WIP on main: 1234567 Add new feature

This command saves your changes and cleans your working directory so you can safely switch tasks or branches.

Your changes are now saved in a stack.

What is a stash stack?

Each time you run git stash , your changes are saved on top of a "stack".

The most recent stash is on top, and you can apply or drop stashes from the top down, or pick a specific one from the list.

Your working directory is clean, and you can switch branches or pull updates safely.

Stash with a Message ( git stash push -m )

Add a message to remember what you stashed:

Example: Stash with a Message

git stash push -m "WIP: homepage redesign"
Saved working directory and index state On main: WIP: homepage redesign

This command lets you add a descriptive message to your stash so you can remember what you were working on.

Example: List Stashes

git stash list
stash@{0}: On main: WIP: homepage redesign
stash@{1}: WIP on main: 1234567 Add new feature

This command shows all the stashes you have saved so far, with their names and messages.

Show Stash Details ( git stash show )

See what was changed in the latest stash:

Example: Show Latest Stash

git stash show
 src/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

This command gives a summary of what files and changes are in your most recent stash.

Example: Show Full Diff

git stash show -p
diff --git a/src/index.html b/src/index.html
index 1234567..89abcde 100644
--- a/src/index.html
+++ b/src/index.html
@@ ...

This command shows the exact lines that were changed in your most recent stash.

Apply the Latest Stash ( git stash apply )

Restore your most recent stashed changes (keeps the stash in the stack):

Example: Apply Latest Stash

git stash apply
On branch main
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: src/index.html

This command restores your most recent stashed changes, but keeps the stash in the list so you can use it again if needed.

Apply a Specific Stash ( git stash apply stash@{n} )

Restore a specific stash from the list:

Example: Apply a Specific Stash

git stash apply stash@{1}
On branch main
Changes not staged for commit:
 modified: src/index.html

This command lets you restore a specific stash from your list, not just the most recent one.

Pop the Stash ( git stash pop )

Apply the latest stash and remove it from the stack :

Example: Pop the Stash

git stash pop
On branch main
Changes not staged for commit:
 modified: src/index.html
Dropped refs/stash@{0} (abc1234d5678)

This command restores your most recent stash and removes it from the list at the same time.

Drop a Stash ( git stash drop )

Delete a specific stash when you no longer need it:

Example: Drop a Stash

git stash drop stash@{0}
Dropped stash@{0} (abc1234d5678)

This command deletes a specific stash from your list when you no longer need it.

  • Clear All Stashes ( git stash clear )

Example: Clear All Stashes

git stash clear

This command deletes all your stashes at once. Be careful! This cannot be undone!

Branch from a Stash ( git stash branch )

Create a new branch and apply a stash to it.

Useful if your stashed work should become its own feature branch:

Example: Branch from a Stash

git stash branch new-feature stash@{0}
Switched to a new branch 'new-feature'
On branch new-feature
Changes not staged for commit:
 modified: src/index.html
Dropped stash@{0} (abc1234d5678)

This command creates a new branch and applies your stashed changes to it.

This is useful if you decide your work should become its own feature branch.

Best Practices for Stashing

  • Use clear messages when stashing: git stash push -m "WIP: feature name"
  • Don't use stashes as long-term storage-commit your work when possible.
  • Check your stash list regularly and clean up old stashes you no longer need.

Troubleshooting

  • Did you lose your changes? Try git stash list and git stash apply to recover stashed work.
  • Stash didn't apply cleanly? You may need to resolve conflicts, just like a merge. Git will mark the conflicts in your files for you to resolve.
  • Untracked files missing? By default, untracked files are not stashed. If you need to stash them, use git stash -u next time.
  • Accidentally cleared all stashes? Unfortunately, git stash clear is permanent. Always double-check before running it!

Note

Stashes are useful for temporary work, but are not a replacement for commits!

Previous

Git Tagging

Next

Git History