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
dependenciesberbeda dengan entripackages[""]ataupackages["node_modules/nama-paket"]di lock. - Branch hasil merge mengubah
package.jsontetapi 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.jsondanpackage-lock.jsonbersamaan.
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.