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
- 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/. - Verifikasi cache, jangan langsung menghapus. Jalankan
npm cache verify. Pakainpm cache clean --forcehanya bila verify melaporkan kerusakan. - 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.