Pembangun memeriksa fail projek sebelum commit

Kesilapan ini sangat klasik sampai hampir setiap pembangun pernah melakukannya sekali. Anda baru cipta repo, tergesa-gesa buat git add . dan git commit -m "init", kemudian push ke GitHub. Baru perasan fail .env, appsettings.Development.json, atau wp-config.php ikut naik sekali. Panik sekejap, anda terus buka .gitignore, tambah .env, simpan, dan jalankan git status. Bila terminal tunjuk working tree clean, anda pun tarik nafas lega.

Hakikatnya, fail itu masih ada di GitHub. Bukan sahaja dalam commit terdahulu, malah dalam commit terkini di branch main pun ia masih wujud dan masih boleh dibaca sesiapa yang ada akses ke repo tersebut.

.gitignore hanya memberitahu Git supaya mengabaikan fail yang belum dijejak (untracked files). Selagi sesuatu fail sudah pernah masuk ke dalam indeks Git, baris baharu dalam .gitignore tidak akan menyentuhnya.

Mengeluarkan fail daripada indeks tanpa memadam fail lokal

Jika anda mahu fail .env kekal pada mesin sendiri supaya aplikasi boleh berjalan, tetapi mahu Git berhenti menjejaknya untuk commit akan datang, gunakan --cached:

git rm --cached .env
git commit -m "Stop tracking .env"

Kalau fail itu satu folder penuh seperti vendor/ atau bin/Debug/, tambah flag -r:

git rm -r --cached bin/ obj/

Untuk menyemak sama ada sesuatu fail masih dijejak oleh Git atau sudah betul-betul keluar daripada indeks, jalankan:

git ls-files .env

Jika arahan itu tidak memulangkan apa-apa output, barulah Git berhenti menjejak fail tersebut untuk commit masa depan. Tetapi ingat: ini cuma memadam fail dari snapshot terkini. Sesiapa yang membuka sejarah commit lama masih boleh nampak isi .env yang asal dengan satu klik atau git show <commit-hash>:.env.

Apabila fail itu mengandungi secret sebenar

Di sinilah ramai orang tersilap langkah. Mereka fikir memadam fail dalam commit baharu, atau menulis sejarah semula, sudah cukup untuk menyelamatkan kunci API.

Kalau repo itu public — walaupun hanya selama lima minit — anggap semua secret di dalamnya sudah bocor. Bot pengimbas di GitHub sentiasa memantau commit baharu dalam masa beberapa saat. Perkara pertama yang perlu dibuat bukan membersihkan sejarah Git, tetapi memutar (rotate) semua kunci tersebut di penyedia asal:

  • Jana semula token API Cloudflare, AWS IAM key, atau kunci pembayaran (Stripe, ToyyibPay, Billplz).
  • Tukar kata laluan pangkalan data dan SMTP.
  • Batalkan (revoke) secret lama serta-merta supaya nilai dalam sejarah Git itu tidak lagi berguna kepada sesiapa.

Selepas secret diputar, barulah fikir sama ada perlu membersihkan sejarah repository. Untuk projek yang sudah dikongsi dengan pasukan, jangan guna git filter-branch yang perlahan dan mudah merosakkan repo. Alat yang lebih kemas ialah git filter-repo:

git filter-repo --path .env --invert-paths

Cuma ada kosnya: arahan ini menulis semula hash semua commit yang terlibat. Anda terpaksa buat git push --force, dan semua rakan sepasukan perlu clone semula repo atau reset branch lokal mereka dengan berhati-hati. Jika tidak diselaraskan, seseorang yang buat git pull atau git merge secara cuai boleh menolak semula sejarah lama ke remote.

Cegah sebelum commit pertama

Cara paling murah untuk mengelakkan drama ini ialah disiplin sebelum git commit pertama pada mana-mana projek baharu:

  1. Sediakan .gitignore dahulu sebelum menulis kod pertama. Untuk projek ASP.NET Core, dotnet new gitignore sudah cukup kemas untuk membuang bin/, obj/, dan fail user secrets. Untuk WordPress atau Drupal, pastikan wp-config.php, sites/default/settings.local.php, dan .env tersenarai dari awal.
  2. Cipta fail templat seperti .env.example atau appsettings.Example.json yang hanya menyimpan nama pemboleh ubah tanpa nilai rahsia:
DB_HOST=127.0.0.1
DB_NAME=app_prod
DB_USER=app_user
DB_PASS=replace_me
CLOUDFLARE_API_TOKEN=replace_me

Dengan adanya fail contoh ini, rakan baharu yang masuk projek tahu pemboleh ubah apa yang diperlukan tanpa perlu meminta fail .env melalui WhatsApp atau Slack.

  1. Biasakan semak git status dan git diff --cached --name-only sebelum git commit, bukannya main git add . secara membuta tuli.

.gitignore itu pagar awal yang bagus, tetapi ia bukan mesin pemadam masa. Sekali rahsia masuk ke dalam sejarah Git, anggap ia sudah keluar dari kawalan anda — putar kunci dahulu, baru kemas repository.