Pesan node command not found berarti shell tidak menemukan executable Node.js. Cara mengatasi node command not found paling cepat adalah tutup terminal lama, buka terminal baru, lalu jalankan node -v. Kalau masih gagal, Node.js kemungkinan belum terinstal atau folder instalasinya belum masuk PATH.
Penyebab Node Tidak Terbaca di Terminal
Terminal hanya mencari perintah di direktori yang terdaftar pada PATH. Instalasi selesai pun bisa tetap gagal dibaca bila konfigurasi shell belum benar.
- Node.js belum terinstal atau proses instalasi berhenti di tengah jalan.
- Folder instalasi Node belum masuk PATH sistem atau user.
- Konflik antara nvm, fnm, Homebrew, dan paket apt karena ada beberapa versi Node.
- Terminal masih memakai sesi lama, sehingga perubahan PATH belum dimuat ulang.
Cek Cepat Sebelum Perbaikan
Jalankan tiga perintah ini untuk membedakan Node belum instal dengan PATH rusak:
node -v
npm -v
which node
Jika npm -v tampil tetapi node -v gagal, biasanya symlink node rusak. Jika keduanya gagal dan which node kosong, Node memang tidak ditemukan shell.
| Masalah | Penyebab | Solusi |
|---|---|---|
| node: command not found | Belum instal | Instal Node.js LTS |
| npm jalan, node gagal | Symlink rusak | Perbaiki instalasi atau link |
| Hilang setelah restart | PATH hanya sementara | Simpan PATH di profil shell |
Langkah Memperbaiki Perintah Node yang Hilang
- Windows: instal ulang Node.js LTS, centang opsi Add to PATH, lalu buka Command Prompt baru dan jalankan node -v.
- macOS Homebrew: jalankan brew install node, lalu buka ulang Terminal dan verifikasi dengan node -v.
- Linux apt: perbarui paket, instal Node.js, lalu cek lokasi binary dengan which node.
- Pengguna nvm: jalankan nvm install –lts, lalu nvm use –lts. Tetapkan default agar tidak hilang dengan nvm alias default lts/*.
- Pengguna fnm: jalankan fnm install lts-latest, lalu fnm use lts-latest. Pastikan init fnm sudah ada di profil shell.
- Verifikasi ulang dari terminal baru dengan perintah berikut:
node -v npm -v which node
FAQ
Kenapa npm terbaca tapi node tidak?
Kondisi ini biasanya karena symlink node hilang atau instalasi tidak lengkap, sehingga npm dari paket lain masih terbaca.
Apakah perlu instal ulang Node.js?
Tidak selalu. Coba terminal baru dan periksa PATH dulu, instal ulang hanya bila file Node memang hilang.
Kenapa node hilang setelah restart terminal?
Penyebabnya PATH atau versi nvm/fnm hanya dipasang sementara dan belum disimpan di file profil shell.