git stash: tek dosyayı, gerisini kaybetmeden

Üç dosya yarıda ve sadece biri hareket edebilirken bir kod incelemesi düşer. Hepsini stash’leyip diğer ikisini yeniden yazmak — kimsenin özlemini duymadığı ritüel.

TL;DR: git stash push -m "neden" -- <yol> yalnızca adı geçen yolları stash’ler ve kirli ağacınızın gerisini rahat bırakır. Değişiklikleri git stash pop ile geri alın (veya herhangi bir stash’ten tek dosyayı git restore --source stash@{0} -- <yol> ile çıkarın). Pathspec biçimi Mayıs 2017’de çıkan git 2.13 ile geldi — son sekiz yılın her araç zincirinde var.

git stash push -m "app.conf prod tweak" -- app.conf
git stash list
# stash@{0}: On main: app.conf prod tweak
git stash pop

Ağacı değil, dosyayı stash’le.

git’te tek bir dosyayı nasıl stash’lerim?

Çıplak bir git stash tüm çalışma ağacını süpürür — izlenen her değişiklik stash’e gider, her şey HEAD‘e döner. Kirli ağaç karma olduğunda bu yanlış biçimdir: bir dosya teslime hazır, gerisi dürüstçe yarım. Çözüm, git-stash belgelerine göre bir pathspec’le push fiili:

# önce: üç kirli dosya
$ git status --short
 M app.conf
 M notes.md
 M main.py

# yalnızca app.conf'u stash'le
$ git stash push -m "app.conf prod tweak" -- app.conf
Saved working directory and index state On main: app.conf prod tweak

$ git status --short
 M notes.md
 M main.py

app.conf commit’lenmiş haline döner ve stash@{0}‘a düşer; notes.md ve main.py hiç kıpırdamadı. -m mesajı isteğe bağlıdır ama git stash list birden fazla girdi gösterdiğinde üç saniyeye değer — “WIP” diye vaftiz edilen stash’ler kötü yaşlanır.

Değen iki ayrıntı:

• Pathspec --‘den sonra gelir. Çift çizgiden sonraki her şey bayrak değil, yoldur. git checkout -- <yol> ile aynı konvansiyondur ve süs değildir: eski sürümlerde git stash push -- main.py ile git stash push main.py farklı davranabilir; çıplak yol yanlış okunabilirdi.
• İzlenmeyen dosyalar -u ister. Yepyeni bir dosyanın stash’lenecek izli geçmişi yoktur; düz push onu atlar. git stash push -u -- newfile.py onu dahil eder; -a daha da ileri gider ve yok sayılanları da süpürür.

Tek dosyanın yalnızca bir kısmını nasıl stash’lerim?

Dosyanın kendisi yarıdaysa — üç iyi hunk, bir utanç verici — etkileşimli akış onu dilimler:

git stash -p            # veya: git stash push -p

Git her hunk’ı dolaşır ve sorar: Stash this hunk [y,n,q,a,d,j,g,/,e,p,?]?. Stash’e girecek hunk’lara y, kalanlara n deyin. Sonuç, yalnızca onayladıklarınızı içeren bir stash’tir; dosyanın geri kalanı kirli kalmıştır. Aynı hunk hunk mekanizma git add -p‘yi de çalıştırır — refleks taşınır.

	git stash push -- <yol>	git stash -p
Tane boyutu	tüm dosyalar	tek tek hunk’lar
Hız	tek komut, betiklenebilir	etkileşimli, hunk hunk
CI’da tekrarlanabilir	evet (yollar argüman olarak)	hayır — istemde insan ister
En iyisi	“bu dosya, gerisi değil”	“bu değişiklik, öbürü değil”
Beri	git 2.13 (Mayıs 2017)	çoktandır var

Belgelerin kendi modelinden pratik kural: sınır dosya ise pathspec, dosyanın içindeyse -p.

Stash’lenmiş bir dosyayı nasıl geri alırım?

git stash pop stash@{0}‘ı geri yükler ve girdiyi siler. Normal yol budur — ama pop stash başına her şey-ya-da-hiçtir ve çakışma pop’u durdurur; girdi korunur. Daha ince iki seçenek:

# 1. silmeden uygula (güvenle tekrarlanabilir)
git stash apply stash@{0}

# 2. bir stash'ten TEK dosyayı çıkar, girdi yerinde kalsın
git restore --source stash@{0} -- app.conf
# aynı işlemin 2.23 öncesi yazımı:
git checkout stash@{0} -- app.conf

restore/checkout biçimi “üç değişikliği birlikte stash’lemiştim, artık yalnızca biri lazım” vakasını yanıtlar — o yolun stash’lenmiş içeriğini çalışma ağacına kopyalar ve stash@{0}‘ı ayakta bırakır. Dikkat: çalışma ağacı kopyasını üzerine yazar; o yoldaki mevcut düzenlemeleriniz önemliyse önce diff alın:

git diff stash@{0} -- app.conf

Stash’ler reflog benzeri bir yığında gerçek commit’ler olarak saklanır — bu yüzden stash@{0} her commit-ish söz dizimini kabul eder; ve yanlışlıkla silinen bir stash, çöp toplayıcı onu yiyene dek reflog’dan kurtarılabilir.

Stash ne zaman yanlış araçtır?

Stash bir karalama defteridir, dal değildir: git branch‘te adı yok, incelemesi yok, varsayılan görünür diff’i yok; girdiler sessizce unutulmak üzere birikir. Devam eden iş makine veya gün değişimlerinden sağ çıkmak zorundaysa, onu bir dala commit’leyin — ekli geçmiş, isimsiz yığından iyidir. Park edilmiş o commit’ler başka bir yere konulacaksa git cherry-pick taşır. Ve amaç park etmek değil geri almaksa, son commit’i geri almak maddesindeki karar ağacı geçerlidir.

Belgelenmiş davranıştan gelen dürüst arıza kütüğü:

Belirti	Sebep	Çözüm
Stash’ten sonra dosya yok	izlenmeyen yollar atlanır	git stash push -u -- <yol>
Pop’ta error: Your local changes ... would be overwritten	yol stash’ten sonra değişmiş	yeni hali commit’leyin veya stash’leyin, sonra pop
Alınan değişiklikler kayboldu	pop çakışmaya takılıp durdu	çözün, sonra git stash apply
“Hangi stash’ti?”	isimsiz stash yığını	her seferinde -m mesajı

git stash push‘a pathspec kazandıran Mayıs 2017 sürüm notu sekiz yaşında ve git stash kas hafızasının çoğu daha eski. Bir yeniden öğrenmeyi hak ediyor: tüm ağacı süpürmek artık varsayılan değil, özel durum.