npm Command Not Found Hatası Nasıl Çözülür?

Terminalde npm komutunu çalıştırdığınızda npm: command not found, 'npm' is not recognized veya benzer bir hata alıyorsanız sistem npm komutunu bulamıyor demektir. Bunun en yaygın nedenleri Node.js'in kurulu olmaması, kurulumun eksik olması veya Node.js/npm dizininin PATH değişkeninde bulunmamasıdır.

Sorunu çözmek için önce Node.js ve npm'in gerçekten kurulu olup olmadığını kontrol etmek gerekir.

1. Node.js kurulumunu kontrol edin

Terminal, PowerShell veya Komut İstemi'nde:

node -v

komutunu çalıştırın.

Bir sürüm numarası görüyorsanız Node.js sistem tarafından bulunabiliyor demektir.

Ardından:

npm -v

komutunu deneyin.

Node çalışıyor ancak npm bulunamıyorsa kurulum veya PATH yapılandırmasında problem olabilir.

2. Node.js de bulunamıyorsa

Hem:

node -v

hem de:

npm -v

çalışmıyorsa Node.js büyük ihtimalle kurulmamıştır veya sistem PATH değişkeninde bulunmuyordur.

Node.js'i resmi dağıtım yöntemlerinden sisteminize uygun şekilde kurun.

Node.js kurulumu npm'i de genellikle beraberinde getirir.

3. Kurulumdan sonra terminali yeniden açın

Node.js'i yeni kurduysanız açık olan PowerShell, Komut İstemi, terminal veya kod editörü eski PATH bilgisini kullanmaya devam edebilir.

Kurulum tamamlandıktan sonra:

- Terminali kapatın.

- Yeniden açın.

- node -v çalıştırın.

- npm -v çalıştırın.

Gerekirse Visual Studio Code gibi açık geliştirme ortamlarını da yeniden başlatın.

4. Windows'ta PATH değişkenini kontrol edin

Node.js kurulu olduğu halde:

'npm' is not recognized as an internal or external command

benzeri bir hata alıyorsanız PATH yapılandırmasını kontrol edin.

Windows'ta:

where node

ve:

where npm

komutları sistemin bu komutları hangi konumdan bulduğunu göstermeye yardımcı olabilir.

Komutlar hiçbir sonuç vermiyorsa Node.js kurulum dizininin PATH içerisinde bulunup bulunmadığını kontrol edin.

PATH'e rastgele klasör eklemek yerine önce Node.js'in gerçekten hangi konuma kurulduğunu doğrulayın.

5. Linux veya macOS'ta komutun konumunu kontrol edin

Linux ve macOS sistemlerinde:

which node

which npm

komutları kullanılabilir.

Böylece terminalin hangi Node.js ve npm kurulumunu kullandığını görebilirsiniz.

Birden fazla Node.js kurulumu bulunuyorsa farklı sürümler veya paket yöneticileri arasında çakışma yaşanabilir.

6. Node çalışıyor ama npm çalışmıyorsa

Bu durumda Node.js kurulumu eksik veya bozulmuş olabilir.

Öncelikle:

node -v

ile Node'un çalıştığını doğrulayın.

Ardından npm'in sistemde bulunup bulunmadığını kontrol edin.

Windows:

where npm

Linux/macOS:

which npm

Sonuç alınamıyorsa kullandığınız Node.js kurulum yöntemini kontrol edin.

Gerekirse Node.js'i güvenilir ve resmi bir yöntemle yeniden kurmak daha temiz bir çözüm olabilir.

7. Birden fazla Node.js kurulumu sorun çıkarabilir

Bilgisayarda aynı anda farklı yöntemlerle kurulmuş birden fazla Node.js sürümü varsa PATH yanlış sürümü gösterebilir.

Örneğin sistemde:

- Manuel Node.js kurulumu

- Sürüm yöneticisiyle kurulan Node.js

- Eski Node.js kurulumu

aynı anda bulunabilir.

Kontrol etmek için:

node -v

npm -v

ve sisteminize göre:

where node

veya:

which node

kullanabilirsiniz.

Hangi Node.js kurulumunun aktif olduğunu belirlemek sorunun çözümünü kolaylaştırır.

8. Node.js sürüm yöneticisi kullanıyorsanız

nvm gibi bir Node.js sürüm yöneticisi kullanıyorsanız aktif Node sürümünün seçili olup olmadığını kontrol edin.

Sürüm yöneticisinin kullandığınız işletim sistemine göre komutları ve çalışma şekli farklı olabilir.

Yeni bir terminal açıldığında Node.js sürümünün doğru yüklenmemesi npm command not found hatasına neden olabilir.

9. SSH ile sunucuya bağlandıktan sonra npm bulunamıyorsa

Kendi bilgisayarınızda npm'in çalışması, VPS veya uzak sunucuda da kurulu olduğu anlamına gelmez.

SSH üzerinden sunucuya bağlandıktan sonra:

node -v

npm -v

komutlarını doğrudan sunucuda çalıştırın.

Node.js uygulamanızı VPS üzerinde çalıştıracaksanız Node.js ve npm'in o sunucuda kullanılabilir olması gerekir.

10. sudo ile çalışıyor ama normal kullanıcıda çalışmıyorsa

Bir komut farklı kullanıcı hesaplarında farklı sonuç veriyorsa kullanıcıların PATH ve Node.js kurulumları farklı olabilir.

Özellikle Node sürüm yöneticileri kullanıcı bazlı kurulmuş olabilir.

Sorunu çözmek için her komuta sudo eklemek yerine hangi kullanıcının hangi Node.js kurulumunu kullandığını belirleyin.

11. VS Code terminalinde npm bulunamıyor ama normal terminalde çalışıyorsa

Node.js kurulduktan sonra Visual Studio Code açık kaldıysa entegre terminal güncel PATH bilgisini almamış olabilir.

VS Code'u tamamen kapatıp yeniden açın.

Ardından yeni terminal oluşturup:

node -v

npm -v

komutlarını tekrar deneyin.

Normal terminalde çalışan npm yalnızca VS Code içerisinde çalışmıyorsa sorun büyük ihtimalle terminal ortamı veya PATH ile ilgilidir.

12. npm'i rastgele ayrı kaynaklardan indirmeyin

npm command not found hatası alındığında bilinmeyen internet sitelerinden npm dosyası indirip sistem klasörlerine kopyalamak güvenli bir çözüm değildir.

Node.js ve npm kurulumunu resmi ve güvenilir kaynaklar üzerinden yapmak daha doğru yaklaşımdır.

Hızlı kontrol sırası

Sorunu araştırırken şu sırayla ilerleyebilirsiniz:

1. node -v

2. npm -v

3. Terminali yeniden başlatın.

4. Windows'ta where node ve where npm kontrol edin.

5. Linux/macOS'ta which node ve which npm kontrol edin.

6. PATH yapılandırmasını inceleyin.

7. Birden fazla Node.js kurulumu olup olmadığını kontrol edin.

8. Gerekirse Node.js kurulumunu düzeltin veya yeniden kurun.

Özetle, npm command not found hatasının çözümü genellikle npm'i ayrıca indirmek değil, Node.js/npm kurulumunun ve PATH yapılandırmasının doğru olduğundan emin olmaktır.

Forumda yardım isterken işletim sisteminizi, node -v, npm -v ve sisteminize göre where npm veya which npm komutlarının çıktısını paylaşmanız sorunun daha hızlı teşhis edilmesini sağlar.