Mengatasi Error npm Not Recognized dan Cara Menghentikan npm run dev

Mengetik npm di terminal lalu muncul pesan npm not recognized, npm not found, atau npm is not recognized as an internal or external command memang menjengkelkan, apalagi saat sedang buru-buru menjalankan proyek. Pesan serupa juga muncul di macOS dan Linux sebagai npm: command not found, bahkan dalam bahasa Spanyol sebagai npm no se reconoce. Kabar baiknya, penyebabnya hampir selalu sama: sistem tidak menemukan program npm di PATH atau Node.js belum terpasang dengan benar.

Selain masalah npm yang tidak dikenali, banyak pengembang juga bingung saat ingin menghentikan npm run dev. Dev server sering dianggap hanya bisa dimatikan dengan menutup jendela terminal, padahal ada cara yang lebih rapi. Artikel ini membahas kedua masalah tersebut secara berurutan.

Apa Arti Error npm Not Recognized

npm adalah package manager bawaan Node.js. Saat Anda mengetik npm di terminal, shell akan mencari file executable bernama npm di daftar direktori yang tercantum pada variabel PATH. Jika file tersebut tidak ditemukan, munculah pesan error. Karena itu, inti masalahnya bukan pada npm itu sendiri, melainkan pada lokasi instalasi Node.js yang tidak dikenali sistem.

npm is not recognized as an internal or external command

Pesan ini khas Windows. Biasanya Node.js belum terpasang sama sekali, atau sudah terpasang tetapi folder C:/Program Files/nodejs/ tidak masuk ke PATH. Terminal yang dibuka sebelum proses instalasi juga masih memakai PATH lama, sehingga npm tetap tidak dikenali sampai terminal di-restart.

npm: command not found di macOS dan Linux

Di macOS dan Linux, shell melaporkan bahwa binary npm tidak ada di PATH. Penyebabnya bisa karena Node.js belum diinstal, dipasang lewat cara yang tidak menambahkan PATH, atau file konfigurasi shell seperti ~/.bashrc dan ~/.zshrc belum dimuat ulang.

npm no se reconoce

Pesan berbahasa Spanyol ini artinya sama, yaitu npm tidak dikenali. Langkah perbaikannya identik dengan dua varian di atas.

Cek Cepat Sebelum Memperbaiki

Sebelum mengubah apa pun, pastikan dulu apakah Node.js dan npm benar-benar ada di sistem. Jalankan dua perintah berikut di terminal:

node -v
npm -v

Hasilnya menentukan langkah berikutnya:

• Jika keduanya menampilkan nomor versi, instalasi sudah benar dan masalah kemungkinan besar ada di konfigurasi proyek.
• Jika node -v berhasil tetapi npm -v gagal, instalasi Node.js tidak lengkap dan sebaiknya diinstal ulang.
• Jika keduanya gagal, Node.js belum terpasang atau lokasinya tidak terdaftar di PATH.

Jika Anda baru mengenal ekosistem ini, artikel Pengenalan Nodejs dan Node Package Manager menjelaskan peran npm dan Node.js secara lebih mendetail sebelum Anda masuk ke tahap perbaikan.

Cara Mengatasi npm Not Recognized di Windows

Instal ulang Node.js versi LTS

Cara paling cepat dan paling aman adalah memasang ulang Node.js dari situs resminya:

1. Unduh installer LTS dari nodejs.org.
2. Jalankan installer dan pastikan opsi Add to PATH tercentang.
3. Selesaikan instalasi, lalu tutup semua jendela Command Prompt atau PowerShell.
4. Buka terminal baru dan uji dengan node -v serta npm -v.

Perbaiki PATH secara manual

Bila Node.js sudah terpasang tetapi npm tetap tidak dikenali, kemungkinan entri PATH-nya hilang:

1. Tekan Win + R, ketik sysdm.cpl, lalu buka tab Advanced.
2. Klik Environment Variables.
3. Pada bagian System variables, pilih Path lalu klik Edit.
4. Tambahkan entri C:/Program Files/nodejs/ bila belum ada.
5. Simpan perubahan dan restart terminal.

Setelah PATH benar, perintah npm akan dikenali di terminal mana pun.

Cara Mengatasi npm Not Found di macOS dan Linux

Gunakan nvm

Cara yang paling direkomendasikan adalah memakai nvm (Node Version Manager) karena memudahkan pengelolaan beberapa versi Node sekaligus:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v && npm -v

Ganti ~/.bashrc dengan ~/.zshrc bila Anda memakai zsh. Setelah nvm aktif, npm otomatis tersedia di PATH setiap kali terminal dibuka.

Periksa PATH shell

Jika Node.js dipasang lewat Homebrew atau installer resmi tetapi npm tetap tidak ditemukan, periksa isi PATH dengan echo $PATH. Pastikan direktori seperti /usr/local/bin atau ~/.nvm/versions/node/versi/bin tercantum di sana. Bila belum, tambahkan baris export PATH yang sesuai ke file konfigurasi shell, lalu jalankan source pada file tersebut.

Cara Menghentikan npm run dev yang Sedang Berjalan

Setelah npm dikenali, masalah berikutnya yang sering muncul adalah dev server yang terus berjalan dan sulit dimatikan. Perintah npm run dev menjalankan proses di foreground, sehingga terminal tetap terpakai sampai proses tersebut dihentikan.

1. Tekan Ctrl + C

Cara paling cepat adalah menekan Ctrl + C di jendela terminal tempat dev server berjalan. Tekan sekali dan tunggu beberapa detik. Jika proses belum berhenti, tekan sekali lagi. Di sebagian besar framework seperti Vite, Next.js, dan React Scripts, cara ini langsung mematikan server dengan rapi.

2. Hentikan proses lewat terminal lain di Windows

Bila terminal utama tidak merespons, buka Command Prompt baru dan cari proses yang memakai port dev server:

netstat -ano | findstr :3000

Catat angka PID di kolom paling kanan, lalu hentikan prosesnya:

taskkill /PID 12345 /F

Ganti 12345 dengan PID yang Anda temukan. Cara ini berguna ketika jendela terminal tertutup paksa tetapi proses node masih berjalan di latar belakang.

3. Hentikan proses di macOS dan Linux

Di macOS dan Linux, cari proses yang menempati port terlebih dahulu:

lsof -i :3000

Setelah PID diketahui, hentikan dengan kill -9 PID. Alternatif yang lebih singkat adalah pkill -f "npm run dev" untuk mematikan semua proses yang cocok dengan nama perintah tersebut.

4. Hentikan lewat editor atau jalankan di background

Di VS Code, klik ikon tempat sampah pada panel terminal untuk mematikan sesi dev server. Jika Anda menjalankan server di background dengan tanda &, gunakan kill %1 atau perintah jobs untuk melihat daftar proses lalu menghentikannya satu per satu.

5. Pastikan port benar-benar bebas

Setelah proses dihentikan, jalankan kembali npm run dev. Jika muncul pesan port already in use, berarti masih ada proses node yang tertinggal. Ulangi langkah pencarian PID di atas sampai port benar-benar kosong.

Kapan Sebaiknya Dev Server Dihentikan

Menghentikan dev server bukan sekadar soal kerapian. Sebaiknya matikan npm run dev sebelum memasang dependensi baru, berpindah versi Node.js, mengganti branch Git, atau menjalankan build produksi. Dev server yang masih berjalan dapat mengunci file dan membuat hasil build tidak konsisten.

Untuk memahami bagaimana Node.js menjalankan dev server di balik layar, artikel Mengenal Node.js: Fungsi, Contoh Aplikasi, dan Cara Build Website membahas alur kerjanya dari instalasi hingga menjalankan aplikasi. npm sendiri adalah pintu masuk ke ekosistem Node.js yang menjadi tulang punggung banyak aplikasi backend modern; jika ingin memperdalam konsepnya, panduan pengembangan sisi server dari MDN adalah rujukan yang tepat.

Kesimpulan

Error npm not recognized, npm not found, dan npm no se reconoce pada dasarnya berarti sistem tidak menemukan npm di PATH. Solusinya adalah memastikan Node.js terpasang, memperbaiki PATH, atau memakai nvm di macOS dan Linux, lalu selalu me-restart terminal setelah instalasi. Sementara itu, cara menghentikan npm run dev yang paling praktis adalah menekan Ctrl + C; bila proses membandel, gunakan taskkill di Windows atau lsof dan kill di macOS serta Linux. Dengan memahami kedua hal ini, Anda bisa berpindah antarproyek tanpa terganggu error npm maupun dev server yang tertinggal.

Foto sampul oleh Bernd Dittrich di Unsplash.