
Apabila repositori laman web anda menggunakan aliran kerja continuous deployment di mana setiap merge ke main terus menerbitkan versi baharu, sangat mudah untuk menjawab “Apa yang paling terkini?”. Masalahnya hanya timbul apabila pelanggan atau rakan sepasukan melaporkan sesuatu yang pelik: “Borang hubungi kami di laman web mula gagal sejak petang Jumaat lepas.”
Pada saat itu, soalan yang jauh lebih penting ialah: kod mana yang sebenarnya sedang berjalan di produksi pada petang Jumaat itu, dan apa yang berubah sejak keluaran stabil sebelumnya?
Menatal 40 commit dengan mesej seperti fix typo, tweak padding, update copy, dan merge branch main memang meletihkan—lebih-lebih lagi jika anda mengurus beberapa projek serentak. Di sinilah Git tag berfungsi sebagai penanda tetap yang mudah dirujuk oleh manusia, log insiden, dan skrip CI/CD.
Beza lightweight tag dengan annotated tag
Git menyokong dua jenis tag. Lightweight tag hanyalah penunjuk nama kepada satu commit tertentu—tiada metadata tambahan, tiada tarikh penciptaan tag, dan tiada mesej. Sebaliknya, annotated tag disimpan sebagai objek penuh dalam pangkalan data Git bersama nama pencipta, cap masa, dan mesej keluaran.
Untuk menandakan keluaran produksi atau titik rujukan penting, biasakan guna annotated tag dengan bendera -a:
git tag -a v1.4.0 -m "Lancar halaman carian baharu dan kemas kini peraturan WAF"
git push origin v1.4.0
Jika anda mahu menyemak senarai tag berserta mesej ringkasnya pada bila-bila masa, jalankan:
git tag -n9 --sort=-creatordate | head -n 10
Arahan ini memaparkan 10 tag terbaharu mengikut tarikh penciptaan, lengkap dengan sehingga sembilan baris mesej. Apabila berlaku pepijat selepas sesuatu keluaran, anda tidak lagi perlu meneka commit mana yang terlibat. Cukup bandingkan dua versi stabil dalam satu arahan:
git diff v1.3.0..v1.4.0 --stat
git log v1.3.0..v1.4.0 --oneline
Dengan output --stat, anda terus nampak fail mana yang disentuh—sama ada templat HTML, fail CSS, konfigurasi routing, atau skrip migrasi.
Penamaan versi untuk blog, portfolio, dan sistem pelanggan
Tidak semua laman web sesuai menggunakan nombor versi perisian tradisional seperti v1.4.0. Untuk projek blog statik, laman korporat WordPress, atau portal pelanggan yang dikemas kini hampir setiap hari, penanda berasaskan tarikh selalunya lebih praktikal—contohnya release-2026-10-13 atau release-2026-10-13.2 jika ada dua keluaran besar pada hari yang sama.
Saya sendiri tidak meletakkan tag untuk setiap suntingan ejaan atau artikel baharu. Jika anda menerbitkan lima hantaran seminggu dan menandakan setiap satunya, senarai tag akan penuh dengan hingar sehingga menyukarkan carian. Simpan tag hanya untuk titik yang benar-benar bermakna:
- Sebelum melakukan migrasi skema pangkalan data (contohnya menambah jadual baharu dalam D1 atau menukar struktur custom post type).
- Selepas melancarkan ciri besar seperti sistem carian, borang pembayaran, atau integrasi API pihak ketiga.
- Sebelum membuat rombakan besar pada susun atur CSS, build pipeline, atau konfigurasi pelayan.
Mencipta hotfix terus daripada tag produksi
Bayangkan senario ini: cawangan main sudah pun mempunyai lima commit ciri baharu yang belum sedia untuk dilancarkan, tetapi versi produksi v1.4.0 mengalami pepijat kritikal pada borang pendaftaran. Jika anda baiki terus di main dan deploy, ciri separuh siap itu akan ikut sama ke produksi.
Dengan adanya tag v1.4.0, anda boleh mencipta cawangan hotfix tepat daripada titik kod yang sedang berjalan di produksi:
git checkout -b hotfix/1.4.1 v1.4.0
# Baiki pepijat, uji secara tempatan, kemudian commit
git commit -am "Betulkan pengesahan nombor telefon pada borang daftar"
git tag -a v1.4.1 -m "Hotfix pengesahan nombor telefon"
git push origin hotfix/1.4.1 v1.4.1
Selepas hotfix selesai diterbitkan, jangan lupa merge semula pembetulan itu ke dalam main supaya pepijat yang sama tidak muncul kembali pada keluaran seterusnya.
Menghubungkan Git tag dengan aliran kerja CI/CD
Tag menjadi lebih berguna apabila digabungkan dengan automasi seperti GitHub Actions. Daripada membenarkan setiap push ke main menyentuh persekitaran produksi secara membuta tuli, sesetengah pasukan memilih untuk memicu keluaran produksi hanya apabila tag v* ditolak ke repositori:
on:
push:
tags:
- "v*"
Pendekatan ini memberi kawalan yang jelas kepada pembangun atau ketua projek untuk menentukan bila kod sedia dilepaskan ke pengguna akhir, sementara push biasa ke main hanya menerbitkan versi staging atau pratonton.
Tag Git bukan bukti deploy berjaya
Satu perkara yang sering disalah anggap: tag Git hanya membuktikan titik dalam kod sumber, ia tidak membuktikan proses build dan deploy di pelayan benar-benar berjaya. Jika Cloudflare Workers Build, Netlify, atau skrip deploy anda gagal di tengah jalan pada commit yang anda tag itu, kod yang sedang berjalan di produksi sebenarnya masih kekal pada versi sebelumnya.
Oleh itu, apabila mencipta keluaran utama—sama ada melalui GitHub Releases atau nota deploy pasukan—sertakan tiga maklumat ringkas: apa yang berubah untuk pengguna, sama ada terdapat migrasi pangkalan data atau pemboleh ubah persekitaran baharu yang perlu dikemas kini, dan pautan atau ID kepada rekod deployment yang sah berjaya di produksi. Gabungan tag Git yang kemas dan rekod deploy yang jelas akan menyelamatkan banyak masa pasukan apabila insiden berlaku pada waktu yang paling tidak dijangka.