Hapus package-lock.json hanya aman untuk tiga kasus: file lock korup, konflik merge yang sulit di-resolve, atau versi dependency sudah kacau dan npm install selalu gagal. Error jaringan seperti ETIMEDOUT atau ECONNRESET bukan alasan menghapus lock. Coba ulang install atau ganti registry dulu.
Kapan Hapus Package Lock Json Diperbolehkan
Menghapus lock berarti npm membaca ulang rentang versi di package.json dan bisa menginstal versi minor atau patch terbaru. Project yang tadinya jalan bisa rusak karena API berubah.
- Lock korup: pesan
npm ERR! Missing: ... from lock fileatau JSON tidak bisa di-parse. - Konflik merge:
package-lock.jsonpenuh marker<<<<<<<setelah pull branch. - Dependency kacau:
ERESOLVE could not resolvetidak sembuh setelahnpm installbersih. - Jangan hapus untuk error jaringan, cache kotor, atau satu package gagal download.
Jadikan hapus lock sebagai jalan terakhir, bukan kebiasaan setiap npm error.
Persiapan Sebelum Hapus File Lock
Persiapan ini mencegah versi Node berbeda menghasilkan lock berbeda dan kehilangan titik kembali.
- Catat environment agar mudah dilacak: jalankan
node -vdannpm -v. - Backup dua file penting sebelum menghapus apa pun.
- Pastikan tidak ada proses
npm installlain yang berjalan di terminal atau CI.
node -v
npm -v
cp package.json package.json.bak
cp package-lock.json package-lock.json.bak
Langkah Regenerate Lockfile Tanpa Merusak Project
Ikuti urutan ini agar lock baru tetap mengikuti package.json yang ada:
- Hapus file lock dari folder project.
- Opsional, hapus
node_moduleshanya bila install masih gagal atau ada dependency ganda. - Jalankan
npm installuntuk membuat lock baru. - Verifikasi pohon dependency dan jalankan aplikasi atau test.
rm package-lock.json
rm -rf node_modules
npm install
npm ls
| Tahap | Tindakan | Catatan |
|---|---|---|
| Hapus | Hapus lock | Simpan file .bak dulu |
| Bersih | Hapus node_modules | Wajib bila folder korup |
| Install | npm install | Tunggu sampai selesai |
| Cek | npm ls | Pastikan tanpa error ERESOLVE |
FAQ
Apakah npm install membuat ulang package-lock.json?
Ya. npm membuat package-lock.json baru otomatis bila file tersebut tidak ditemukan saat install.
Haruskah hapus node_modules sekalian?
Tidak wajib. Hapus bila install bersih gagal atau folder modules tercampur versi lama dan baru.
Bagaimana jika npm install gagal setelah lock dihapus?
Kembalikan file backup, lalu perbaiki rentang versi di package.json sebelum regenerate ulang.