Cara Install dari Package Lock Json agar Versi Dependency Sama

Cara install dari package lock json yang benar adalah memakai npm ci, bukan npm install biasa. Perintah ini menghapus folder node_modules lalu menginstal ulang persis versi yang tercatat di package-lock.json.

npm install tetap membaca lockfile, tetapi ia boleh mengubahnya saat package.json tidak sinkron atau ada dependency baru. Untuk clone baru, server, dan CI/CD, npm ci memberi hasil lebih konsisten.

npm ci
npm install

Jawaban Cepat: npm ci vs npm install

Pakai npm ci bila package-lock.json sudah ada dan ingin versi dependency sama di semua mesin.

  • npm ci: install bersih sesuai lockfile, gagal bila lock tidak sinkron.
  • npm install: tambah atau ubah dependency, lalu perbarui lockfile.
  • Syarat: package.json dan package-lock.json berada di folder proyek yang sama.
  • Jangan commit folder node_modules, cukup commit kedua file package tersebut.

Langkah Install dari Package Lock Json

Urutan ini menghindari versi loncat antar laptop dan server.

1. Cek versi Node dan npm:

node -v
npm -v

2. Pastikan kedua file ada di folder proyek:

dir package.json package-lock.json

3. Jalankan install bersih untuk clone baru, deploy, atau CI:

npm ci

4. Jalankan npm install hanya bila perlu menambah, update, atau hapus package.

  • Verifikasi folder node_modules sudah terbentuk setelah install.
  • Cek versi terpasang dengan npm ls nama-package.
  • Samakan versi Node antar tim bila lock dibuat di Node berbeda.

Tabel Perintah dan Kapan Dipakai

Kondisi Perintah Hasil pada lockfile
Clone baru atau deploy npm ci Tidak diubah
Tambah package baru npm install nama-package Diperbarui
Lock rusak atau tidak sinkron npm install –package-lock-only Diperbaiki tanpa install ulang

Menghapus package-lock.json membuat npm menyelesaikan ulang semua rentang versi. Ini bisa menaikkan dependency kecil tanpa disadari. Flag --force dan --legacy-peer-deps juga berisiko karena memaksa instalasi melewati pemeriksaan konflik.

Atasi Gagal Install dari Lockfile

  • Lock rusak: biasanya ada pesan JSON parse error atau missing from lock file.
  • Versi Node beda: native module gagal build setelah pindah versi Node.
  • Conflict peer dependency: muncul ERESOLVE unable to resolve dependency tree.
  • Baca pesan error sampai baris package penyebab, jangan langsung hapus node_modules.
  • Sinkronkan ulang dengan npm install --package-lock-only, lalu ulangi npm ci.

FAQ

Apakah npm install selalu mengikuti package-lock.json?

Ya selama sinkron, tetapi npm install tetap boleh memperbarui lock bila ada perubahan rentang versi.

Kapan harus memakai npm ci?

Pakai untuk clone baru, pipeline CI, testing, dan deploy production agar versi sama.

Apa yang terjadi jika package-lock.json dihapus?

npm membuat lock baru dari package.json dan versi dependency bisa berbeda dari sebelumnya.