Kenapa Cara Regenerate Package Lock Json Tidak Selalu Berarti Hapus File

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.json diedit manual, lalu muncul peringatan lock tidak sinkron saat install.
  • package-lock.json corrupt, terpotong, atau penuh marker conflict seperti <<<<<<< setelah merge.
  • Pindah versi npm mayor, misalnya npm 8 ke npm 10, sehingga format lockfileVersion berubah.
  • 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.

  1. Backup dulu: salin package-lock.json ke package-lock.json.bak.
  2. Validasi package.json: pastikan JSON tidak koma ganda dan nama versi benar.
  3. Hapus folder node_modules saja bila instalasi lama dicurigai rusak.
  4. 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 ada invalid atau missing.
  • npm ci: memastikan install bersih dari lock berhasil.
  • Jalankan proyek, misalnya npm run dev atau npm start, untuk cek runtime error.

Tanda lock valid dan sinkron:

  • npm install tidak lagi mengubah lock.
  • lockfileVersion sesuai 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.