git stash

W tym momencie można swobodnie wprowadzać zmiany, tworzyć nowe commity, przełączać gałęzie oraz wykonywać inne operacje Git, a wrócić i ponownie zastosować zmiany ze schowka, gdy wszystko będzie gotowe.

Należy zauważyć, że schowek jest lokalny względem repozytorium Git, a zapisane w nim zmiany nie są przesyłane na serwer podczas wypychania.

Za pomocą polecenia git stash pop można ponownie zastosować zmiany, które wcześniej zostały dodane do schowka:

Wykonanie operacji „pop” na schowku powoduje usunięcie zmian ze schowka i ponowne zastosowanie ich do kopii roboczej.

Można również ponownie zastosować zmiany do kopii roboczej i jednocześnie zachować je w schowku za pomocą polecenia git stash apply:

Jest ono przydatne, jeśli chcesz zastosować te same zmiany ze schowka w wielu gałęziach.

Znając już podstawy dodawania do schowka, należy pamiętać o pewnym zagrożeniu związanym z korzystaniem z polecenia git stash: domyślnie Git nie dodaje do schowka zmian wprowadzonych w plikach nieśledzonych lub ignorowanych.

Dodanie opcji -u (lub --include-untracked) pozwala uwzględnić w poleceniu git stash także nieśledzone pliki:

Można uwzględnić także zmiany wprowadzone w plikach ignorowanych, przekazując opcję -a (lub --all) podczas wykonywania polecenia git stash.

Aby zapewnić pewien kontekst, dobrze jest dodawać adnotacje z opisem do schowków za pomocą polecenia git stash save "message":

Domyślnie polecenie git stash pop spowoduje ponowne zastosowanie zmian z ostatnio utworzonego schowka: stash@{0}

Można wybrać schowek, z którego zmiany mają zostać ponownie zastosowane, przekazując jego identyfikator jako ostatni argument, na przykład:

Przekazanie opcji -p (lub --patch) umożliwia wyświetlenie pełnego zestawu różnic w schowku:

Naciśnięcie klawisza ? pozwala wyświetlić pełną listę poleceń dotyczących fragmentów ze zmianami. Najczęściej stosuje się następujące z nich:

Nie ma konkretnego polecenia przerwania operacji, ale użycie skrótu CTRL-C(SIGINT) spowoduje przerwanie procesu dodawania do schowka.

To spowoduje wyewidencjonowanie nowej gałęzi w oparciu o commit, z którego utworzono schowek, a następnie wykonanie polecenia „pop” w odniesieniu do schowka.

Można również usunąć wszystkie schowki, używając następującego polecenia:

W zależności od rodzaju zawartości dodawanej do schowka, pojedyncza operacja git stash powoduje utworzenie dwóch lub trzech nowych commitów. Na powyższym diagramie przedstawiono następujące commity:

• stash@{0} — nowy commit do przechowywania śledzonych plików, które znajdowały się w kopii roboczej w momencie wykonania polecenia git stash.
• Pierwszy element nadrzędny commita stash@{0} — istniejący wcześniej commit, na który w momencie wykonania polecenia git stash wskazywał wskaźnik HEAD.
• Drugi element nadrzędny commita stash@{0} — nowy commit reprezentujący indeks w momencie wykonania polecenia git stash.
• Trzeci element nadrzędny commita stash@{0}— nowy commit reprezentujący nieśledzone pliki, które w momencie wykonania polecenia git stash znajdowały się w kopii roboczej. Ten trzeci element nadrzędny jest tworzony tylko wówczas, gdy:
  • kopia robocza faktycznie zawierała nieśledzone pliki;
  • oraz użyto opcji --include-untracked lub --all podczas wywoływania polecenia git stash.

Sposób kodowania drzewa roboczego i indeksu jako commitów po użyciu polecenia git stash:

• Przed dodaniem do schowka drzewo robocze może zawierać zmiany wprowadzone w plikach śledzonych, nieśledzonych i ignorowanych. Niektóre z tych zmian mogą być również przechowywane w indeksie.

• Wywołanie polecenia git stash koduje wszelkie zmiany w śledzonych plikach jako dwa nowe commity w grafie DAG: jeden dla zmian poza przechowalnią i jeden dla zmian przechowywanych w indeksie. Specjalna referencja refs/stash zostanie zaktualizowana tak, aby je wskazywała.

• Użycie opcji --include-untracked pozwala również zakodować wszelkie zmiany w nieśledzonych plikach jako dodatkowy commit.

• Z kolei opcja --all umożliwia uwzględnienie zmian wprowadzonych we wszystkich ignorowanych plikach wraz ze zmianami w plikach nieśledzonych w tym samym commicie.

Po wykonaniu polecenia git stash pop kopia robocza oraz indeks są aktualizowane o zmiany z powyższych commitów, a dziennik reflog schowka jest modyfikowany w celu usunięcia commita zastosowanego za pomocą polecenia „pop”. Warto pamiętać, że commity zastosowane za pomocą polecenia „pop” nie są usuwane od razu, tylko stają się kandydatami do późniejszego usuwania zbędnych elementów.