NVM (Node Version Manager) windows Kurulumu

Node.js ile geliştirme yapıyorsanız, farklı projelerinizde farklı Node.js sürümlerine ihtiyaç duyduğunuz zamanlar mutlaka olmuştur. Bir proje Node 18 isterken, diğeri Node 20 ile çalışıyor olabilir. İşte tam bu noktada NVM for Windows devreye giriyor.

Not: Linux ve macOS için kullanılan nvm ile Windows için geliştirilen nvm-windows farklı projelerdir. Bu yazıda Windows sürümünü ele alacağız.

NVM for Windows, Microsoft, npm ve Google tarafından Windows için önerilen Node.js sürüm yöneticisidir. Go diliyle yazılmış olup, 44.000’den fazla GitHub yıldızına sahip popüler bir açık kaynak projesidir.

Kurulum Öncesi Hazırlık

⚠️ Önemli: NVM’yi kurmadan önce bilgisayarınızda yüklü olan Node.js kurulumlarını kaldırmanız şiddetle tavsiye edilir. Aksi takdirde PATH çakışmaları yaşayabilir ve nvm use komutu düzgün çalışmayabilir.

Mevcut Node.js Kurulumunu Kaldırma

Denetim Masası > Programlar ve Özellikler bölümünden Node.js’i kaldırın
Aşağıdaki klasörlerin silindiğinden emin olun (varsa):
- C:\Program Files\nodejs
- C:\Program Files (x86)\nodejs
- %AppData%\npm
- %AppData%\npm-cache
Global npm ayarlarınız varsa yedekleyin:
- %AppData%\npm\etc\npmrc dosyasını başka bir yere kopyalayın
- Veya içeriğini %UserProfile%\.npmrc dosyasına taşıyın

İndirme ve Kurulum

Adım 1: NVM for Windows’u İndirin

Resmi GitHub sayfasından en güncel sürümü indirin:

🔗 İndirme Bağlantısı: github.com/coreybutler/nvm-windows/releases

Releases sayfasında nvm-setup.exe dosyasını indirin. Bu yazının yazıldığı tarihte güncel sürüm 1.2.2‘dir.

Adım 2: Kurulum Sihirbazını Çalıştırın

İndirdiğiniz nvm-setup.exe dosyasını çalıştırın. Kurulum sihirbazı size iki konum soracaktır:

NVM Kurulum Dizini: NVM’nin kendisinin yükleneceği yer
- Varsayılan: C:\Users\<kullanıcı>\AppData\Roaming\nvm
Node.js Symlink Dizini: Aktif Node.js sürümüne işaret edecek sembolik bağlantı
- Varsayılan: C:\Program Files\nodejs

Varsayılan ayarlar çoğu kullanıcı için uygundur. “Next” butonlarına tıklayarak kurulumu tamamlayın.

Adım 3: Kurulumu Doğrulayın

Kurulum tamamlandıktan sonra yeni bir terminal penceresi açın (PowerShell veya CMD) ve şu komutu çalıştırın:

nvm version

Çıktı olarak sürüm numarasını görüyorsanız (örn: 1.2.2), kurulum başarılı demektir.

Not: Kurulumdan hemen sonra NVM çalışmıyorsa, terminali kapatıp yeniden açmayı deneyin.

Temel NVM Komutları

NVM komutlarını çalıştırmak için terminali Yönetici olarak açmanız gerekir (sembolik bağlantı oluşturmak için yönetici izni gereklidir).

Mevcut Node.js Sürümlerini Görüntüleme

İndirebileceğiniz Node.js sürümlerini görmek için:

nvm list available

Bu komut, en güncel Node.js sürümlerini tablo halinde listeler. LTS (Long Term Support) sürümleri genellikle production ortamları için tercih edilir.

Node.js Kurulumu

En güncel LTS sürümünü kurmak için:

nvm install lts

En son sürümü (latest) kurmak için:

nvm install latest

Belirli bir sürümü kurmak için:

nvm install 20.10.0

Sadece major sürüm belirterek kurmak için:

nvm install 18

Bu komut, Node.js 18’in en güncel minor/patch sürümünü yükler.

Aktif Sürümü Değiştirme

Yüklediğiniz bir Node.js sürümünü aktif hale getirmek için:

nvm use 20.10.0

Veya kısaca:

nvm use 20

LTS veya en güncel sürüme geçmek için:

nvm use lts
nvm use latest

Yüklü Sürümleri Listeleme

Bilgisayarınızda yüklü olan tüm Node.js sürümlerini görmek için:

nvm list

Aktif olan sürüm yanında * işareti ile gösterilir.

Aktif Sürümü Görüntüleme

Şu anda hangi Node.js sürümünün aktif olduğunu görmek için:

nvm current

Veya doğrudan Node.js üzerinden:

node -v

Node.js Sürümünü Kaldırma

Kullanmadığınız bir sürümü kaldırmak için:

nvm uninstall 18.17.0

NVM’yi Devre Dışı Bırakma / Etkinleştirme

NVM’nin Node.js yönetimini geçici olarak kapatmak için:

nvm off

Tekrar etkinleştirmek için:

nvm on

Pratik Kullanım Örneği

Diyelim ki iki farklı projeniz var. Biri Node 18, diğeri Node 20 gerektiriyor:

# İlk olarak her iki sürümü de yükleyin
nvm install 18
nvm install 20

# Proje A için Node 18'e geçin
cd proje-a
nvm use 18
node -v  # v18.x.x

# Proje B için Node 20'ye geçin
cd ../proje-b
nvm use 20
node -v  # v20.x.x

Önemli Notlar ve İpuçları

Global Paketler Hakkında

Her Node.js sürümü kendi global paket deposuna sahiptir. Yani bir sürümde npm install -g yarn ile Yarn kurduysanız, başka bir sürüme geçtiğinizde Yarn’ı tekrar kurmanız gerekir:

nvm use 18
npm install -g yarn typescript

nvm use 20
npm install -g yarn typescript  # Tekrar kurulum gerekli

Symlink Nasıl Çalışır?

NVM, aktif Node.js sürümünü bir sembolik bağlantı (symlink) aracılığıyla yönetir. nvm use komutu çalıştığında, symlink dizini (varsayılan: C:\Program Files\nodejs) seçtiğiniz Node.js sürümüne yönlendirilir. Bu sayede PATH değişkenini her seferinde değiştirmenize gerek kalmaz.

Sürüm Kalıcılığı

NVM for Windows’ta seçtiğiniz sürüm sistem genelinde kalıcıdır. Yani bilgisayarı yeniden başlatsanız bile son seçtiğiniz Node.js sürümü aktif kalır. Her terminal açılışında nvm use çalıştırmanıza gerek yoktur.

Sonuç

NVM for Windows, Node.js geliştirmesi yapan herkes için vazgeçilmez bir araçtır. Farklı projeler arasında kolayca geçiş yapabilir, yeni Node.js sürümlerini test edebilir ve eski projeleri sorunsuz çalıştırabilirsiniz.

Faydalı Bağlantılar:

Bu yazı ile ilgili sorularınızı yorumlarda belirtebilirsiniz.