Apakah git stash dan bila anda menggunakannya?

Question

Accepted Answer

**git stash** secara sementara **menyimpan perubahan anda yang belum di-commit** dan mengembalikan working directory anda kepada keadaan bersih — supaya anda boleh menukar konteks (cth. membetulkan pepijat segera pada branch lain) tanpa melakukan commit pada kerja separuh siap, kemudian memulihkan perubahan itu kemudian.

## Masalah yang diselesaikan oleh stash

```text
You're mid-work with uncommitted changes, but need to switch context urgently:
  → switch branches? Git may refuse (uncommitted changes would conflict) or carry
    them along messily
  → commit half-done work? No — it's not ready (pollutes history)
→ STASH saves your changes aside, giving you a clean working directory to switch.
```

## Menggunakan stash

```bash
git stash                      # save uncommitted changes; working dir becomes clean
git stash push -m "message"    # stash with a description
git stash list                 # list stashes (stash@{0}, stash@{1}, ...)

git stash pop                  # RESTORE the latest stash AND remove it from the list
git stash apply                # restore but KEEP it in the stash list
git stash apply stash@{1}      # apply a specific stash
git stash drop stash@{0}       # delete a stash
git stash clear                # remove all stashes
```

`git stash` menyimpan perubahan dan membersihkan working directory; `git stash pop` memulihkannya kemudian (dan membuang stash). `apply` memulihkan tanpa membuang.

## Senario biasa

```bash
# working on a feature, but an urgent bug needs fixing on main:
git stash                      # save the in-progress feature work
git switch main
# ... fix the urgent bug, commit, push ...
git switch feature
git stash pop                  # restore the feature work and continue
```

## Pilihan yang berguna

```text
git stash -u        → also stash UNTRACKED files (not just tracked changes)
git stash show -p   → see what's in a stash
→ Stash is for TEMPORARY storage — not a substitute for commits/branches long-term.
```

## Mengapa ia penting

Memahami `git stash` adalah bernilai untuk **mengendalikan pertukaran konteks dengan bersih**, satu situasi dunia sebenar yang biasa, jadi ia merupakan pengetahuan Git praktikal yang berguna.

Masalah yang diselesaikannya adalah kerap: anda berada di tengah-tengah kerja dengan perubahan yang belum di-commit apabila anda perlu **menukar konteks segera** (membetulkan pepijat produksi pada branch lain, menyemak kod seseorang, melakukan pull pada kemas kini) — tetapi menukar branch dengan perubahan yang belum di-commit adalah bermasalah (Git mungkin enggan atau membawanya secara berselerak), dan melakukan commit pada kerja separuh siap mengganggu sejarah. **Stash** menyelesaikan ini dengan elegan dengan **menyimpan perubahan anda di tepi** dan memberi anda working directory yang bersih untuk menukar konteks, kemudian **memulihkannya kemudian** apabila anda kembali — tepat menepati senario "saya perlu melepaskan apa yang saya lakukan buat sementara waktu" yang biasa.

Memahami arahan teras (`git stash` untuk menyimpan, `git stash pop` untuk memulih-dan-membuang, `git stash apply` untuk memulih-dan-mengekalkan, `git stash list` untuk melihat stash) dan aliran kerja tipikal (stash kerja dalam proses, tukar dan tangani tugas segera, tukar semula dan pop) ialah pengetahuan praktikal harian untuk mengurus gangguan.

Mengetahui pilihan yang berguna (`-u` untuk menyertakan fail yang tidak dijejaki, melihat kandungan stash) dan bahawa stash adalah untuk storan **sementara** (bukan ganti jangka panjang untuk commit/branch) mencerminkan penggunaan yang betul.

Memandangkan pertukaran konteks dan gangguan adalah biasa dalam pembangunan (pepijat segera, semakan, memerlukan working directory yang bersih), dan memandangkan stash menyediakan cara yang bersih dan mudah untuk mengetepikan kerja yang belum di-commit secara sementara dan memulihkannya kemudian, memahami `git stash` — apa yang diselesaikannya, arahan-arahannya, dan aliran kerja pertukaran-konteks yang biasa — merupakan pengetahuan Git yang bernilai dan relevan secara praktikal untuk mengendalikan keperluan dunia sebenar yang kerap untuk menukar konteks tanpa melakukan commit pada kerja yang belum siap, satu alat berguna yang melancarkan gangguan biasa dalam pembangunan harian.