Mengapa git stash pop mengatakan bahwa ia tidak dapat memulihkan file yang tidak terlacak dari entri simpanan?

Saya memiliki banyak perubahan bertahap dan tidak bertahap dan saya ingin segera beralih ke cabang lain dan kemudian beralih kembali.

Jadi saya melakukan perubahan saya menggunakan:

$ git stash push -a

(Kalau dipikir-pikir, saya mungkin bisa menggunakan --include-untrackedalih-alih --all)

Kemudian ketika saya pergi untuk membuka simpanan saya mendapatkan banyak kesalahan di sepanjang baris:

$ git stash pop
foo.txt already exists, no checkout
bar.txt already exists, no checkout
...
Could not restore untracked files from stash entry

Sepertinya tidak ada perubahan apa pun yang dipulihkan dari simpanan.

Saya juga mencoba $ git stash branch temptetapi itu menunjukkan kesalahan yang sama.

Saya memang menemukan cara untuk mengatasinya yang akan digunakan:

$ git stash show -p | git apply

Bencana dapat dihindari untuk saat ini, tetapi ini menimbulkan beberapa pertanyaan.

Mengapa kesalahan ini terjadi sejak awal dan bagaimana cara menghindarinya di lain waktu?

Sebagai sedikit penjelasan tambahan, catatan yang git stashmembuat dua komit, atau tiga komit. Defaultnya adalah dua; Anda mendapatkan tiga jika Anda menggunakan ejaan --allatau --include-untrackedopsi.

Dua, atau tiga, komit ini istimewa dalam satu hal penting: tidak ada cabang. Git menempatkannya melalui nama khusus stash. ¹ Namun, hal terpenting adalah apa yang Git izinkan untuk Anda — dan buat Anda — lakukan dengan dua atau tiga komitmen ini. Untuk memahami hal ini kita perlu melihat apa yang ada di dalam commit tersebut.

Apa yang ada di dalam simpanan

Setiap komit bisa mendaftar satu atau lebih komit orang tua . Ini membentuk grafik, di mana kemudian komitmen menunjuk kembali ke yang sebelumnya. Stash biasanya menampung dua komit, yang ingin saya panggil iuntuk konten index / staging-area, dan wuntuk konten work-tree. Ingat juga bahwa setiap komit menyimpan sebuah snapshot. Dalam komit normal, snapshot ini dibuat dari konten index / staging-area. Jadi ikomit sebenarnya adalah komit normal sempurna! Hanya saja tidak di cabang mana pun:

...--o--o--o   <-- branch (HEAD)
           |
           i

Jika Anda membuat simpanan normal, git stashkodenya wsekarang dengan menyalin semua file pohon kerja terlacak Anda (ke dalam indeks tambahan sementara). Git menetapkan orang tua pertama dari wkomit ini untuk menunjuk ke HEADkomit, dan orang tua kedua untuk menunjuk ke komit i. Terakhir, set stashuntuk menunjuk ke wkomit ini :

...--o--o--o   <-- branch (HEAD)
           |\
           i-w   <-- stash

Jika Anda menambahkan --include-untrackedatau --all, Git membuat komit ekstra u,, di antara pembuatan idan w. Konten snapshot untuk uadalah file yang tidak terlacak tetapi tidak diabaikan ( --include-untracked), atau file yang tidak terlacak meskipun diabaikan ( --all). Ekstra ini uberkomitmen memiliki tidak ada orang tua, dan kemudian ketika git stashmerek w, ia menetapkan w's ketiga orang tua untuk ini ukomit, sehingga Anda mendapatkan:

...--o--o--o   <-- branch (HEAD)
           |\
           i-w   <-- stash
            /
           u

Git juga, pada titik ini, menghapus semua file pohon kerja yang berakhir di ukomit (menggunakan git cleanuntuk melakukan itu).

Mengembalikan simpanan

Saat Anda pergi untuk memulihkan simpanan, Anda memiliki opsi untuk menggunakan --index, atau tidak menggunakannya. Ini memberitahu git stash apply(atau salah satu perintah yang menggunakan internal apply, seperti pop) yang seharusnya menggunakan yang iberkomitmen untuk mencoba mengubah indeks Anda saat ini. Modifikasi ini dilakukan dengan:

git diff <hash-of-i> <hash-of-i's-parent> | git apply --index

(kurang lebih; ​​ada banyak detail kecil yang menghalangi ide dasar di sini).

Jika Anda menghilangkan --index, git stash applymengabaikan ikomit sepenuhnya .

Jika simpanan hanya memiliki dua komit, git stash applysekarang dapat menerapkan wkomit. Ini dilakukan dengan memanggil git merge² (tanpa mengizinkannya untuk mengkomit atau memperlakukan hasil sebagai gabungan normal), menggunakan komit asli tempat simpanan dibuat ( iinduk pertama, dan winduk pertama) sebagai basis gabungan, wsebagai --theirskomit, dan komit (HEAD) Anda saat ini sebagai target penggabungan. Jika penggabungan berhasil, semua akan baik-baik saja — yah, setidaknya menurut Git — dan git stash applysukses itu sendiri. Jika Anda dulu git stash popmenggunakan simpanan, kode sekarang menjatuhkan simpanan. ³ Jika penggabungan gagal, Git menyatakan bahwa penerapan gagal. Jika Anda dulugit stash pop, kode mempertahankan simpanan dan memberikan status kegagalan yang sama seperti untuk git stash apply.

Tetapi jika Anda memiliki komit ketiga itu — jika ada ukomit di simpanan yang Anda terapkan — maka segalanya berubah! Tidak ada pilihan untuk berpura-pura bahwa ukomit tidak ada. ⁴ Git bersikeras mengekstrak semua file dari yang ukomit, ke dalam arus kerja-pohon. Ini berarti file harus tidak ada sama sekali, atau memiliki konten yang sama seperti di ukomit.

Untuk mewujudkannya, Anda dapat menggunakan git cleandiri Anda sendiri — tetapi ingat bahwa file yang tidak terlacak (diabaikan atau tidak) tidak memiliki keberadaan lain di dalam repositori Git, jadi pastikan semua file ini dapat dihancurkan! Atau, Anda dapat membuat direktori sementara, dan memindahkan file ke sana untuk diamankan — atau bahkan melakukan yang lain git stash save -uatau git stash save -a, karena itu akan berjalan git cleanuntuk Anda. Tapi itu hanya membuat Anda memiliki usimpanan gaya lain untuk ditangani nanti.

¹ Ini sebenarnya refs/stash. Ini penting jika Anda membuat cabang dengan nama stash: nama lengkap cabang adalah refs/heads/stash, jadi tidak ada konflik. Tapi jangan lakukan itu: Git tidak keberatan, tapi Anda akan membingungkan diri sendiri. :-)

² The git stashkode benar-benar menggunakan git merge-recursivelangsung di sini. Ini diperlukan karena berbagai alasan, dan juga memiliki efek samping untuk memastikan Git tidak memperlakukannya sebagai gabungan saat Anda menyelesaikan konflik dan melakukan.

³ Inilah mengapa saya merekomendasikan menghindari git stash pop, demi git stash apply. Anda mendapat kesempatan untuk meninjau apa yang telah diterapkan, dan memutuskan apakah itu benar - benar diterapkan dengan benar. Jika tidak, Anda masih memiliki simpanan yang berarti dapat Anda gunakan git stash branchuntuk memulihkan semuanya dengan sempurna. Nah, dengan asumsi kurangnya ukomitmen sial itu .

⁴ Benar-benar harus ada: git stash apply --skip-untrackedatau sesuatu. Juga harus ada varian yang berarti letakkan semua ufile komit itu ke direktori baru , misalnya git stash apply --untracked-into <dir>, mungkin.

Saya berhasil membuat ulang masalah Anda. Tampaknya jika Anda menyimpan file yang tidak terlacak lalu Anda membuat file tersebut (dalam contoh Anda, foo.txtdan bar.txt), maka Anda memiliki perubahan lokal pada file yang tidak terlacak yang akan ditimpa saat Anda melamar git stash pop.

Untuk mengatasi masalah ini, Anda dapat menggunakan perintah berikut. Ini akan menimpa semua perubahan lokal yang belum disimpan jadi hati-hati.

git checkout stash -- .

Berikut adalah beberapa informasi lebih lanjut yang saya temukan pada perintah sebelumnya .

Untuk memperluas jawaban Daniel Smith : kode itu hanya memulihkan file yang dilacak , meskipun Anda menggunakan --include-untracked(atau -u) saat membuat simpanan. Kode lengkap yang dibutuhkan adalah:

git checkout stash -- .
git checkout stash^3 -- .
git stash drop

# Optional to unstage the changes (auto-staged by default).
git reset

Ini sepenuhnya memulihkan konten yang dilacak (dalam stash) dan konten yang tidak terlacak (dalam stash^3), lalu menghapus simpanan. Beberapa catatan:

• Hati-hati - ini akan menimpa semuanya dengan konten simpanan Anda!
• Mengembalikan file dengan git checkoutmenyebabkan semuanya menjadi bertahap secara otomatis, jadi saya telah menambahkan git resetke semua unstage.
• Beberapa sumber daya menggunakan stash@{0}dan stash@{0}^3, dalam pengujian saya, cara kerjanya sama dengan atau tanpa@{0}

Sumber:

• Paksa git simpanan untuk menimpa file yang ditambahkan (ditautkan dalam jawaban Daniel Smith)
• Bagaimana cara saya melakukan checkout file yang tidak terlacak di git stash? (info tentang stash^3komit ajaib )
• Panduan Atlassian untuk git stash (periksa "Cara kerja git stash" untuk detail tentang komit internal)

Selain jawaban lain, saya melakukan sedikit trik

• Menghapus semua file baru ( file yang sudah ada, misalnya foo.txt dan bar.txt dalam pertanyaan)
• git stash apply (dapat menggunakan perintah apa saja, misalnya terapkan, pop, dll.)