Lock Tertinggal setelah Ubah Dependency? Ini Cara Sinkron Package Json dan Package Lock

Edit package.json manual tidak otomatis mengubah package-lock.json. Cara sinkron package json dan package lock yang aman adalah menjalankan npm install tanpa argumen setelah edit valid, atau npm install nama-paket@versi untuk perubahan terkontrol. Jangan hapus lock hanya karena muncul error versi.

Tanda Package Json dan Package Lock Tidak Sinkron

npm ci gagal dengan pesan lock tidak sinkron dengan package.json, sedangkan npm install sering tetap jalan karena npm mencoba memperbaiki lock. Perbedaan ini penting saat deploy karena CI memakai npm ci.

  • Error muncul setelah tambah, hapus, atau ubah versi dependency tanpa install ulang.
  • Versi di dependencies berbeda dengan entri packages[""] atau packages["node_modules/nama-paket"] di lock.
  • Branch hasil merge mengubah package.json tetapi lock masih versi lama.

Cek tree bermasalah dengan perintah berikut:

npm ls nama-paket
npm ls --package-lock-only

Langkah Sinkron yang Aman Tanpa Hapus Lock

Urutan ini menjaga riwayat versi tetap terkontrol dan mudah direview sebelum commit.

1. Untuk tambah atau ubah satu paket, jalankan install dengan versi eksplisit:

npm install express@4.19.2
npm install lodash@latest --save-exact

2. Jika package.json sudah diedit manual dan versinya valid, sinkron lock tanpa menambah paket baru:

npm install --package-lock-only

3. Verifikasi hasil sinkron sebelum commit:

npm ls
git diff package.json package-lock.json
  • Pastikan hanya paket target yang berubah versinya.
  • Pastikan tidak ada perubahan besar tak disengaja di ratusan baris lock.
  • Commit package.json dan package-lock.json bersamaan.

Tabel: Kondisi Tidak Sinkron dan Perintah yang Tepat

Kondisi Penyebab Perintah Aman
Tambah dependency Paket ditulis manual npm install nama-paket@versi
Hapus dependency Entri lock tersisa npm uninstall nama-paket
Ubah versi manual Lock belum diperbarui npm install --package-lock-only
Konflik peer dependency Versi tidak kompatibel Perbaiki versi, hindari --legacy-peer-deps

Menghapus package-lock.json membuat npm menyelesaikan ulang seluruh dependency. Hasilnya bisa menaikkan banyak versi transitif sekaligus dan sulit dilacak. Flag --force dan --legacy-peer-deps juga menyembunyikan konflik, bukan memperbaikinya. Pakai hanya sementara untuk diagnosis, lalu catat risikonya.

FAQ

Apakah boleh edit package.json manual lalu sinkron?

Boleh, asal format versi valid, lalu jalankan npm install --package-lock-only.

Kapan harus regenerate package-lock.json?

Hanya bila lock rusak berat atau tercampur antar branch dan tidak bisa diperbaiki bertahap.

Mana yang dipakai saat deploy, install atau ci?

Pakai npm ci karena memasang persis sesuai lock dan gagal cepat bila tidak sinkron.