7 Menit Jadi 40 Detik dengan Cara Mengatasi Npm Install Terlalu Lama

npm install yang tadinya 7 menit bisa turun ke 40 detik kalau hambatannya tepat. Jalankan dulu npm install --prefer-offline --no-audit --no-fund sambil memastikan registry memakai https://registry.npmjs.org. Flag ini memangkas pemeriksaan audit dan unduhan ulang paket yang sebenarnya sudah ada di cache.

Kalau progres tetap diam di idealTree lebih dari 2 menit, masalahnya hampir pasti resolusi dependency atau jaringan, bukan CPU. Pindah diagnosis sebelum menghapus apa pun.

Penyebab Npm Install Berjalan Lambat

Lambat karena jaringan biasanya terlihat dari kecepatan unduh yang naik turun dan retry FETCH. Registry lambat terlihat dari jeda panjang sebelum progress muncul.

Cache rusak gejalanya berbeda. Proses jalan cepat di awal lalu macet, atau muncul EINTEGRITY dan EBADENGINE berulang. Dependency besar seperti Puppeteer, Sharp, Prisma, atau Electron membuat tahap postinstall jauh lebih lama karena mengunduh binary tambahan.

Cek kondisi awal dengan perintah ini:

npm -v
node -v
npm config get registry
npm ls --depth=0
du -sh node_modules 2>/dev/null || dir node_modules

Tabel Diagnosis Cepat Sebelum Perbaikan

Catat gejalanya dulu supaya tidak salah hapus file lock.

Gejala Kemungkinan Penyebab Pengecekan Awal
Stuck di idealTree Konflik versi, peer deps npm install –dry-run
Download paket lambat Jaringan, DNS, registry ping registry.npmjs.org
Postinstall sangat lama Binary besar, script build cek sharp, prisma, puppeteer
Install ulang selalu penuh Cache rusak atau lock berubah npm cache verify

Perintah berisiko butuh konteks:

  • Hapus package-lock.json membuat npm menyelesaikan versi dari nol, cocok hanya bila lock rusak parah.
  • Hapus node_modules aman untuk install ulang, tetapi tidak mempercepat tanpa cache yang sehat.
  • –force mengabaikan proteksi npm dan bisa menimpa dependency yang sedang dipakai.
  • –legacy-peer-deps melewati konflik peer, berguna sementara untuk proyek lama dengan React 17 atau ESLint lawas.

Percepat Npm Install dengan Langkah Aman

  1. Uji jaringan dan registry. Ganti WiFi ke tethering sebentar untuk memastikan. Kembalikan registry ke default bila memakai mirror tak dikenal dengan npm config set registry https://registry.npmjs.org/.
  2. Verifikasi cache, jangan langsung menghapus. Jalankan npm cache verify. Pakai npm cache clean --force hanya bila verify melaporkan kerusakan.
  3. Pilih perintah install yang tepat. Untuk deploy atau CI dengan package-lock.json utuh, pakai npm ci. Untuk pengembangan harian, pakai mode offline.
npm config get registry
npm cache verify
npm ci
npm install --prefer-offline --no-audit --no-fund
  • Update npm bila versi tertinggal: npm install -g npm@latest.
  • Mirror registry hanya bila koneksi ke registry global selalu lambat dan mirror tersebut tepercaya.
  • Aktifkan log detail saat macet: npm install --loglevel http.

FAQ

Apakah menghapus node_modules mempercepat install?

Tidak selalu. Install bersih justru mengunduh ulang semua paket, jadi hanya membantu bila folder lama rusak.

Kapan memakai npm ci dibanding npm install?

Pakai npm ci untuk instalasi bersih sesuai package-lock.json, terutama di CI dan server produksi.

Kenapa npm install tetap lama setelah ganti jaringan?

Cache rusak, lock berubah, atau postinstall binary besar masih jadi hambatan walau jaringan sudah cepat.