El stash permite tomar algunos cambios pendientes de aplicar en un repositorio de Git, y apartarlos para hacerlos desaparecer temporalmente. De este modo, podemos limpiar nuestro espacio de trabajo, pero sin perder lo que hayamos hecho hasta el momento, que puede ser rescatado posteriormente.
Resulta útil, por lo tanto, en los siguientes supuestos:
- Estás trabajando en un código de una rama, pero de repente tienes necesidad urgente de cambiar de rama para atender otra cosa.
- Te interesa apartar algunos cambios que no quieres introducir en el próximo commit (aunque recuerda que tienes otras formas más simples como el parámetro -p/--patch.
- Quieres ocultar temporalmente unos cambios para que no afecten la próxima compilación de un programa o la próxima ejecución del comando de unit testing.
Empujar todo al stash
Para todas estas tareas puedo simplemente ejecutar git stash, y sin mediar palabra, esconderá las modificaciones para que dejen de estar ahí. Cuando hagas git status ya no las verás. Eso no significa que hayan desaparecido, únicamente están apartadas en el stash.
Para ver todas las cosas que hay en el stash, siempre podrás usar el comando git stash list. Este comando te enumerará, a cambio por línea, todo lo que hayas metido en el stash.
stash@{0}: WIP on trunk: b3eca13
stash@{1}: WIP on trunk: b3eca13
Cada una de estas líneas se corresponde con una modificación enviada al stash. Lo primero que viene (stash@{0}) es su identificador. Esto es usado luego para poder referirse a ese cambio concreto cuando haya varios y queramos aclarar cuál. En cuanto al resto, nos indica la rama de la que procede el cambio, y un comentario, que por defecto será el hash del commit del que se retiró esto.
Es verdad que la salida de git stash list no es muy descriptiva, pero podemos cambiar esto si a la hora de enviar algo al stash le ponemos un comentario que indique qué hay en ese parche. Para poner este comentario, hazlo justo cuando vayas a enviar algo al stash usando el siguiente comando en su lugar:
git stash save [qué es todo esto]
Lo que pongas tras save será el comentario que veas cuando luego listes los elementos del stash.
Traerse las cosas del stash
Una vez que quieras recuperar las cosas del stash, puedes extraerlas rápidamente mediante el comando git stash pop. Este comando lo que hace es recuperar el último elemento que se haya enviado al stash, y tratar de rescatarlo para volver a ponerlo en el repositorio.
Esto resulta conveniente porque a menudo el cambio que más recientemente se haya mandado al stash es el que querremos volver a aplicar. Así los podremos desaplicar en orden inverso al orden en el que los hemos metido, y el riesgo de conflictos es menor.
En cualquier caso, también tenemos el comando git stash apply, que permite aplicar directamente alguno de los items que hay en el stash. Todo lo que tienes que hacer es poner git stash apply, y con eso aplicará por defecto el cambio más reciente, pero si quieres especificar cuál quieres aplicar en este momento, todo lo que tienes que hacer es agregar el identificador del stash (el que veíamos antes en el list, con la forma stash@{0}), como argumento después de apply:
git stash apply stash@{2}
Examinar el contenido de un stash
Si el mensaje de comentario que pones con save no te parece lo suficiente descriptivo, puedes usar el comando git stash show para ver el contenido de un parche mandado al stash.
Cuando digo parche, es literal, ya que lo que se manda al stash es el mismo diff que veríamos al ejecutar un comando como git diff.
Para ver uno de estos parches utiliza la siguiente invocación: git stash show seguido del identificador del stash a ver. Por ejemplo:
git stash show stash@{2}
Limpiar el stash
Usar git stash pop para sacar algo del stash lo borrará del stash.
Sin embargo, git stash apply no hará el mismo efecto. Además, a veces git stash pop tampoco lo hará. Si durante el proceso de extracción con pop se producen conflictos (porque se hayan hecho cambios en las líneas que modifica lo mandado al stash, y ya no se pueda volver a sacar de forma limpia), tampoco lo borrará del stash.
O a veces puede ocurrir que se te olvide que enviaste algo al stash, y lo empieces a hacer de nuevo. Con el tiempo, el stash acumulará parches que han quedado en el olvido.
Puedes borrar uno de estos parches si usas el subcomando git stash drop. Por defecto, si únicamente usas git stash drop borrarás el elemento más reciente enviado al stash, pero puedes especificar cuál quieres borrar si se lo indicas como parámetro. Por ejemplo:
git stash drop stash@{4}
También puedes borrar todo el stash usando el comando
git stash clear
Ten en cuenta en cualquier caso que esta es una operación destructiva y que podrías perder la posibilidad de recuperarlo si luego descubres que no debiste hacer eso, así que ve con cuidado.