Dependency tidak masuk package.json biasanya karena kamu install di folder yang salah, memakai flag --no-save, atau npm disetel save=false. Cek dulu posisi folder dan isi package.json, lalu install ulang dengan flag --save-prod atau --save-dev yang tepat.
Penyebab Dependency Tidak Tersimpan di Package Json
npm hanya mencatat package kalau perintah dijalankan di folder yang berisi package.json. Salah folder sedikit saja, file tidak berubah walau instalasi terlihat sukses.
- Folder kerja salah. Tidak ada package.json di direktori aktif, jadi npm install package ke lokasi lain atau hanya ke node_modules sementara.
- Flag
--no-savedipakai. Contohnpm install express --no-savememang sengaja tidak mencatat ke package.json. - Konfigurasi
save=falseaktif. Cek dengannpm config get save. Nilaifalsemematikan pencatatan otomatis. - Salah memilih jenis dependency. Package produksi harus masuk
dependencies, tool pengembangan seperti nodemon masukdevDependencies. - Install global dengan
-g. Package global tidak tercatat di package.json proyek lokal. - npm versi lama atau permission folder bermasalah. Instalasi gagal tulis file walau proses tidak menampilkan error jelas.
Tabel Diagnosis Cepat
| Masalah | Penyebab | Solusi |
|---|---|---|
| package.json tidak berubah | Salah folder kerja | Pindah ke folder proyek lalu install ulang |
| Package terinstall tapi hilang saat clone | Terpakai --no-save |
Install ulang dengan --save-prod |
| Semua install tidak tercatat | save=false |
Kembalikan dengan npm config set save=true |
| Package hanya ada di satu komputer | Install global -g |
Install ulang sebagai dependency lokal |
Verifikasi dengan tiga perintah ini: npm list nama-package untuk status install, npm config get save untuk konfigurasi penyimpanan, dan buka manual package.json untuk melihat bagian dependencies.
Cara Memperbaiki Dependency yang Tidak Masuk Package Json
- Jalankan
pwddanls, pastikan kamu berada di folder yang berisi package.json. - Buka package.json, periksa apakah package sudah ada di
dependenciesataudevDependencies. - Install ulang package produksi dengan flag penyimpanan eksplisit.
- Install tool pengembangan dengan flag dev agar tidak terbawa ke production.
- Verifikasi perubahan file sebelum menjalankan aplikasi.
npm install
npm install express --save-prod
npm install nodemon --save-dev
- Cek package.json sudah berisi nama dan versi package yang benar.
- Cek package-lock.json ikut berubah sebagai tanda dependency terkunci.
- Jalankan ulang aplikasi untuk memastikan tidak ada error
Cannot find module.
Hapus node_modules dan package-lock.json bukan perbaikan pertama. Tindakan itu memaksa download ulang semua package dan bisa menimbulkan konflik versi. Pakai hanya kalau file lock rusak. Hindari juga --force kecuali kamu paham risikonya karena flag itu mengabaikan proteksi konflik npm.
FAQ
Kenapa npm install selesai tapi package.json tidak berubah?
Kemungkinan besar perintah jalan di folder salah atau memakai --no-save sehingga npm tidak mencatat perubahan.
Apakah perlu install ulang semua package yang hilang?
Tidak, install ulang hanya package yang belum tercatat, lalu jalankan npm install untuk sinkronisasi sisanya.
Bagaimana membedakan dependencies dan devDependencies?
Gunakan dependencies untuk kode yang jalan di production dan devDependencies untuk tool seperti linter atau auto-reload.