Hapus atau Biarkan? Cara Menghapus Package Lock Json dengan Aman saat Npm Error

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 file atau JSON tidak bisa di-parse.
  • Konflik merge: package-lock.json penuh marker <<<<<<< setelah pull branch.
  • Dependency kacau: ERESOLVE could not resolve tidak sembuh setelah npm install bersih.
  • 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 -v dan npm -v.
  • Backup dua file penting sebelum menghapus apa pun.
  • Pastikan tidak ada proses npm install lain 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:

  1. Hapus file lock dari folder project.
  2. Opsional, hapus node_modules hanya bila install masih gagal atau ada dependency ganda.
  3. Jalankan npm install untuk membuat lock baru.
  4. 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.