Você com certeza já se deparou com uma situação na qual sua responsabilidade é desenvolver/corrigir uma feature, e em algum momento surge uma urgência de última hora, em uma outra branch, mas e o seu código que ainda não está pronto para o commit, o que fazer com ele? Com essa situação em mente, o git stash vem para nos ajudar.

Git Stash

git stash arquiva (ou faz o stash) de alterações que você fez na cópia de trabalho durante um determinado período, para que você possa trabalhar em outra coisa, depois voltar e fazer a reaplicação mais tarde. O stashing é útil quando você precisa alternar com rapidez o contexto e trabalhar em outra coisa, mas está no meio da alteração de código e não está pronto para fazer commit.

Com o git stash é possível “salvar” suas alterações sem precisar realizar um commit (Lembrando que arquivos preparados e não preparados são incluídos no stash) para você utilizar em algum outro momento.

Criando um Stashes

Digamos que você realizou parte da sua task no arquivo index.html e criou o styles.css, porém foi pedido para você realizar uma correção em uma outra branch, podemos então criar o nosso primeiro Stash.

Antes do stash, podemos ver o status dos nossos arquivos:

$ git status

Changes not staged for commit:
modified: index.html

Untracked files:
new file: styles.css

Podemos ver que existe o index.html como modified e o nosso styles.css como new file, agora criaremos o nosso Stash:

$ git stash

Saved working directory and index state WIP on main: fe442e6 Delete comments on index.html

E rodando novamente o git status, ele nos mostra que não existe alterações/criações.

$ git status

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

Nesse momento, você pode realizar alteração, criar novos commits, alternar branchs e executar quaisquer outras operações do Git. Quando estiver satisfeito, poderá “trazer” de volta o seu stash, explicarei mais a frente como realizar o git stash pop.

Lembrando que o stash só existe no local, e stashes não são enviados para o servidor remoto quando você realizar o push.

Trazendo as alterações com o pop

Nesse momento você já finalizou o que tinha que fazer em alguma outra ramificação do projeto, e está pronto para dar continuidade a sua antiga task, agora iremos ver como aplicar as alterações existentes no stash utilizando o git stash pop

Executamos o status para visualizarmos as alterações existentes:

$ git status

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

E agora trazemos as alterações utilizando o pop:

$ git stash pop
On branch main

Changes not staged for commit:
modified: index.html

Untracked files:
new file: styles.css

Dropped refs/stash@{0} (04aa236313d158de0edbf4a9d50e84ed7c23b92c)

Executar o pop no stash aplica as alterações no projeto e as remove.

Uma outra flag interessante nesse sentido é o apply que irá aplicar as alterações, porém o stash ainda vai existir, caso você queria aplicar em alguma outra branch:

$ git stash apply
On branch main
Changes to be committed:

new file: style.css

Changes not staged for commit:

modified: index.html

Por padrão, o Git não vai fazer o stash de alterações feitas a arquivos ignorados ou não rastreados.

Gerenciar múltiplos stashes

Importante destacar, que você não fica limitado a apenas um único stash, você é capaz de criar múltiplos stathes. Sendo possivel visualizar todos os stashes criados utilizando a flag list:

$ git stash list
stash@{0}: WIP on main: 5002d47 our new homepage
stash@{1}: WIP on main: 5002d47 our new homepage
stash@{2}: WIP on main: 5002d47 our new homepage

Por padrão, os stashes são nomeados com "WIP" — Work in Progress (Trabalho em progresso), Branch e Commit que foi criado.

Uma boa prática existente para você criar os seus stashes a longo prazo sem se perder, ou ficar totalmente confuso, é a flag save ela permite nós passarmos uma string que seria o nome/descrição daquele stash.

$ git stash save "add style to our site"
Saved working directory and index state On main: add style to our site
HEAD is now at 5002d47 our new homepage

$ git stash list
stash@{0}: On main: add style to our site
stash@{1}: WIP on main: 5002d47 our new homepage
stash@{2}: WIP on main: 5002d47 our new homepage

Por padrão, git stash pop vai trazer o stash mais recente: stash@{0}

Podemos escolher qual stash aplicar, utilizando o seu identificador (stash@{number}):

$ git stash pop stash@{2}

Limpar seu stash

Se em determinado momento você decidir que um stash não será mais necessário, é possível excluir um ou mais stashes:

Para apagar um stash isolado:

$ git stash drop stash@{1}
Dropped stash@{1} (17e2697fd8251df6163117cb3d58c1f62a5e7cdb)

Ou você pode excluir todos:

$ git stash clear

Visualizar comparações de stash

Imagine uma situação onde você tem alguns stashes criados, e não se lembra o que tem exatamente naquele primeiro stash criado, para isso temos a flag show , vale lembrar que ele sempre vai mostrar por padrão o stash mais recente (stash@{0}):

$ git stash show
index.html | 1 +
style.css | 3 +++
2 files changed, 4 insertions(+)

Para visualizar um stash em especifico, basta passar o identificador dele:

$ git stash show *stash@{0}*
index.html | 3 +++
style.css | 1 +
2 files changed, 4 insertions(+)

Lembrando que ele mostra de uma forma resumida, podemos utilizar o -p (ou --patch) para uma inspeção mais detalhada.

Fazer stash em arquivos ignorados ou não rastreados

Um problema (ou não), é que o stash não irá ser aplicado em arquivos não rastreados (Arquivos criados que não passaram por nenhum commit), para resolver essa questão, podemos adicionar a flag -u (ou --include-untracked).

Você também pode incluir alterações para arquivos ignorados (Dentro do .gitignore), passando a flag -a ou --all).

Fonte:

https://git-scm.com/docs/git-stash

https://www.atlassian.com/br/git/tutorials/saving-changes/git-stash