
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:
- Sediakan
.gitignoredahulu sebelum menulis kod pertama. Untuk projek ASP.NET Core,dotnet new gitignoresudah cukup kemas untuk membuangbin/,obj/, dan fail user secrets. Untuk WordPress atau Drupal, pastikanwp-config.php,sites/default/settings.local.php, dan.envtersenarai dari awal. - Cipta fail templat seperti
.env.exampleatauappsettings.Example.jsonyang 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.
- Biasakan semak
git statusdangit diff --cached --name-onlysebelumgit commit, bukannya maingit 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.