Pembangun menyemak perubahan kod lokal

Situasi ini selalu berlaku: anda cuba ubah susun atur pada templat Razor, functions.php WordPress, atau skrip Cloudflare Worker, tetapi hasilnya makin bersepah. Anda mahu buang eksperimen itu dan kembali kepada keadaan asal sebelum mula tadi.

Arahan git restore memang direka untuk tujuan ini bagi fail yang sudah dijejak (tracked). Masalahnya, ramai pembangun terus menaip git restore . tanpa berfikir panjang. Git tidak tahu bahagian mana yang anda anggap “eksperimen gagal” dan bahagian mana yang sebenarnya pembetulan pepijat penting yang anda buat dua puluh minit sebelumnya. Sekali arahan itu dijalankan pada perubahan yang belum masuk commit, kod tersebut hilang terus daripada cakera keras.

Semak diff sebelum menekan Enter

Sebelum membuang apa-apa, jadikan tabiat untuk melihat dahulu apa yang sebenarnya berubah dalam ruang kerja anda:

git status
git diff -- path/ke/fail.cs

Jika git status menunjukkan ada lima fail berubah sedangkan anda cuma mahu membatalkan satu fail, jangan sesekali guna titik (.). Namakan fail tersebut secara khusus. Beberapa saat membaca output git diff jauh lebih murah daripada dua jam menulis semula kod yang terpadam secara tidak sengaja.

Beza working tree, staging dan fail baharu

Ramai masih keliru antara git checkout -- <fail>, git reset HEAD <fail>, dan git restore. Sejak Git memperkenalkan git restore, tugas memulihkan fail dipisahkan dengan lebih jelas daripada kerja menukar branch. Namun anda tetap perlu tahu di mana perubahan anda berada:

  • Membuang perubahan yang belum di-stage (working tree):
    git restore src/Controllers/OrderController.cs
    
  • Mengeluarkan fail daripada staging area tanpa membuang kodnya:
    git restore --staged src/Controllers/OrderController.cs
    
  • Memulihkan fail daripada commit tertentu (contohnya dua commit ke belakang):
    git restore --source=HEAD~2 -- config/nginx.conf
    

Satu lagi perkara yang sering memerangkap pembangun: git restore tidak menyentuh fail baharu yang belum pernah dijejak oleh Git (untracked files). Kalau anda ada fail migrasi baharu, aset gambar, atau fail .env.local, ia kekal di situ. Jika anda mahu membersihkannya menggunakan git clean, sentiasa jalankan mod dry-run terlebih dahulu supaya anda nampak senarai fail yang bakal dipadam:

git clean -fdn

Hanya selepas pasti tiada fail penting dalam senarai itu, barulah tukar -n kepada -f jika benar-benar perlu. Dokumentasi rasmi git restore juga wajar disimpan sebagai rujukan apabila menggunakan bendera seperti --source atau --worktree.

Pulihkan sebahagian sahaja dengan mod patch

Katakan dalam satu fail CSS atau C#, anda ada dua blok perubahan yang belum dikomit: satu ialah pembaikan aksesibiliti yang memang diperlukan, dan satu lagi ialah eksperimen gaya yang mahu dibuang. Jika anda jalankan git restore <fail>, kedua-duanya akan lesap.

Untuk kes sebegini, gunakan mod interaktif (patch):

git restore -p styles/main.css

Git akan memaparkan setiap blok perubahan (hunk) satu demi satu dan bertanya sama ada anda mahu membuangnya (y) atau mengekalkannya (n). Jika blok itu terlalu besar dan bercampur aduk, anda boleh tekan s (split) untuk memecahkannya kepada bahagian yang lebih kecil. Ini cara paling selamat untuk membersihkan fail tanpa mengorbankan kerja yang masih berguna.

Simpan sementara jika masih ada rasa ragu

Kelemahan terbesar membatalkan perubahan yang belum dikomit ialah tiada jaring keselamatan. Kod yang sudah masuk commit masih boleh dicari semula melalui git reflog walaupun branch dipadam. Sebaliknya, perubahan dalam working tree yang dibuang dengan git restore tidak wujud dalam sejarah Git; editor anda pun belum tentu menyimpan sejarah undo selepas fail ditulis semula di atas cakera.

Jika ada sedikit pun rasa ragu bahawa draf eksperimen itu mungkin berguna esok hari, simpan dahulu sebelum memulihkan fail:

git stash push -m "eksperimen-kad-produk"

Atau cipta satu branch sementara dan komit sahaja kerja yang separuh siap itu. Ruang storan untuk satu stash atau commit sementara hampir tidak memakan kos, tetapi ia menyelamatkan anda daripada rasa sesal apabila menyedari ada sebaris logik yang sebenarnya elok dipakai semula.