Cara regenerate package-lock.json yang benar bukan selalu menghapus filenya. Untuk sebagian besar kasus, cukup jalankan npm install setelah package.json valid, karena npm akan menyinkronkan ulang lock secara otomatis. Hapus lock hanya untuk kasus lock rusak berat atau conflict merge yang tidak bisa diselesaikan.
Kapan Package Lock Json Perlu Diregenerate
File lock menyimpan pohon dependensi yang terinstal. Regenerate dibutuhkan saat catatannya tidak lagi cocok dengan kondisi proyek.
package.jsondiedit manual, lalu muncul peringatan lock tidak sinkron saat install.package-lock.jsoncorrupt, terpotong, atau penuh marker conflict seperti<<<<<<<setelah merge.- Pindah versi npm mayor, misalnya npm 8 ke npm 10, sehingga format
lockfileVersionberubah. - Pindah registry atau scope package, misalnya dari registry publik ke registry privat kantor.
Perintah Aman untuk Regenerate Ulang
Menghapus lock membuat npm menghitung ulang semua versi. Itu bisa menaikkan versi minor atau patch tanpa disadari.
- Backup dulu: salin
package-lock.jsonkepackage-lock.json.bak. - Validasi
package.json: pastikan JSON tidak koma ganda dan nama versi benar. - Hapus folder
node_modulessaja bila instalasi lama dicurigai rusak. - Jalankan regenerate sesuai kebutuhan:
npm install
npm install --package-lock-only
Perintah pertama menginstal package sekaligus menulis ulang lock. Perintah kedua hanya menulis ulang lock tanpa mengunduh node_modules, cocok untuk memperbaiki lock di CI atau setelah edit manual. Jangan pakai --force sebagai jalan pintas karena flag itu memaksa overwrite conflict dan menyembunyikan masalah versi peer dependency.
Tabel Pilihan Regenerate Sesuai Kondisi
| Kondisi | Tindakan | Catatan |
|---|---|---|
| Edit manual package.json | npm install –package-lock-only | Cepat, tidak unduh ulang |
| Tambah atau update satu package | npm install nama-package@versi | Lock berubah selektif |
| Lock rusak atau conflict merge | Hapus lock, lalu npm install | Opsi terakhir, cek diff versi |
Verifikasi Setelah Regenerate Berhasil
Jalankan tiga pemeriksaan ini sebelum commit:
npm ls --depth=0: pastikan tidak adainvalidataumissing.npm ci: memastikan install bersih dari lock berhasil.- Jalankan proyek, misalnya
npm run devataunpm start, untuk cek runtime error.
Tanda lock valid dan sinkron:
npm installtidak lagi mengubah lock.lockfileVersionsesuai versi npm yang dipakai tim.- Diff Git hanya berisi versi yang memang sengaja diubah.
FAQ
Apakah aman menghapus package-lock.json setiap error?
Tidak. Hapus lock bisa menaikkan banyak versi sekaligus dan menimbulkan bug baru.
Apa beda npm install dan npm install –package-lock-only?
npm install menginstal folder node_modules dan memperbarui lock, sedangkan --package-lock-only hanya memperbarui lock.
Kenapa npm ci gagal setelah regenerate?
Umumnya lock dan package.json belum sinkron atau lock dibuat dengan versi npm berbeda, jadi regenerate ulang dengan npm yang sama lalu coba lagi.