Node.js Kurulumu: Windows, macOS ve Linux

01Node.js Nedir, Neden Kurulur?

Node.js, JavaScript'i tarayıcı dışında, doğrudan bilgisayarınızda ya da sunucuda çalıştıran bir çalışma ortamıdır. Modern web projelerinin neredeyse tamamı, geliştirme sırasında Node.js'e ihtiyaç duyar: paket kurmak, derleme yapmak, yerel geliştirme sunucusu açmak hep onunla yapılır.

React, Vite, Next.js, Tailwind gibi araçları kullanmasanız bile, bir projeyi bilgisayarınızda çalıştırmak istediğinizde ilk karşınıza çıkan adım genellikle npm install olur. Bu komut Node.js ile birlikte gelen paket yöneticisi npm'e aittir; yani Node.js kurulmadan bu adımı geçemezsiniz.

Bu rehberde iki yolu anlatıyoruz: tek bir sürümle çalışacaklar için resmî kurucu, birden çok projeyle uğraşanlar için sürüm yöneticisi. Hangisini seçeceğinizi aşağıdaki tablo netleştirir.

02Kurulumdan Önce Neler Gerekir?

Node.js hafif bir kurulumdur ama birkaç ön hazırlık sonradan çıkacak sorunları önler. Özellikle bilgisayarınızda daha önce kurulmuş eski bir Node.js varsa, onu kaldırmadan nvm kurmak PATH çakışmasına yol açabilir.

İşlemci mimarisine de dikkat edin. Apple Silicon (M serisi) Mac'lerde ve ARM tabanlı Windows cihazlarda kurucu doğru mimariyi genellikle kendisi seçer; elle indirme yapıyorsanız x64 ile ARM64 dosyalarını karıştırmayın. Yanlış mimari kurulum çalışsa bile yavaşlar ya da bazı yerel paketler derlenemez.

Kurumsal bilgisayarlarda proxy ya da güvenlik duvarı npm'in paket indirmesini engelleyebilir. Böyle bir ağdaysanız kurulumdan önce BT ekibinizden npm kayıt adresine (registry.npmjs.org) erişim izni isteyin.

• Yönetici yetkisi: Windows ve macOS'ta resmî kurucu için gerekir; nvm ise kullanıcı klasörüne kurulduğu için genellikle gerekmez.
• Terminal: Windows'ta PowerShell ya da Windows Terminal, macOS'ta Terminal, Linux'ta varsayılan kabuk yeterlidir.
• Eski kurulumun kaldırılması: Sürüm yöneticisine geçecekseniz önce mevcut Node.js'i Ayarlar > Uygulamalar ya da paket yöneticiniz üzerinden kaldırın.
• Sürüm tercihi: Üretimde ve öğrenirken LTS (uzun süreli destek) sürümünü seçin; Current sürüm yeni özellikleri erken görmek isteyenler içindir.

03Windows'ta Node.js Kurulumu

Windows'ta üç yol var: resmî .msi kurucusu, Windows'un kendi paket yöneticisi winget ve sürüm yönetimi için nvm-windows. Hangisini seçerseniz seçin, kurulumdan sonra açık olan terminalleri kapatıp yeniden açın; aksi hâlde yeni PATH ayarı görünmez.

Resmî kurucu ile

nodejs.org'dan Windows için LTS .msi dosyasını indirin, kurucuyu çalıştırın ve varsayılan seçeneklerle ilerleyin. Kurucu, Node.js ile birlikte npm'i de kurar ve PATH'e otomatik ekler.

winget ile

Windows 10 ve 11'de gelen winget ile tek komutla LTS sürümü kurabilirsiniz:

winget install OpenJS.NodeJS.LTS

nvm-windows ile

Birden çok sürüme ihtiyacınız varsa nvm-windows kurun; bu, macOS/Linux'taki nvm'den ayrı bir projedir ama komutları benzerdir. Kurulumdan sonra PowerShell'i yönetici olarak açıp şu komutları çalıştırın:

winget install CoreyButler.NVMforWindows

# Terminali kapatıp yeniden açın
nvm install lts
nvm use lts
nvm list

04macOS ve Linux'ta nvm ile Kurulum

macOS ve Linux'ta en sağlıklı yol nvm (Node Version Manager) kullanmaktır. nvm, Node.js'i kullanıcı klasörünüze kurar; böylece global paket kurarken sudo kullanmanız gerekmez ve izin hatalarıyla uğraşmazsınız.

Aşağıdaki komut nvm'nin kurulum betiğini indirip çalıştırır. Resmî README sürüm etiketli bir adres önerir; en güncel komutu nvm GitHub sayfasından kopyalamanız en doğrusudur.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# Kabuğu yeniden yükleyin (kullandığınız kabuğa göre birini seçin)
source ~/.bashrc
source ~/.zshrc

# nvm'nin yüklendiğini kontrol edin
command -v nvm

nvm install --lts
nvm use --lts
nvm alias default 'lts/*'

Homebrew ile macOS kurulumu

Homebrew kullanıyorsanız brew install node komutu da iş görür. Ancak bu komut genellikle en yeni sürümü kurar; LTS'ye bağlı kalmak istiyorsanız nvm daha esnektir.

brew install node

Linux dağıtım depoları

Ubuntu ya da Debian'da sudo apt install nodejs npm komutu çalışır ama depodaki sürüm çoğu zaman güncel projelerin istediğinden eskidir. Bu yüzden geliştirme makinelerinde nvm'yi öneriyoruz.

05Kurulumu Nasıl Doğrularım?

Kurulum bittikten sonra yeni bir terminal açın ve şu komutları çalıştırın. Her iki komut da bir sürüm numarası döndürmelidir. Ardından küçük bir test betiğiyle Node.js'in kod çalıştırdığını görün.

• node -v çıktısı v ile başlayan bir sürüm numarasıdır.
• npm -v yalnızca rakam döndürür; npm, Node.js ile birlikte gelir.
• Test komutu ekrana mesajı yazıyorsa ortamınız hazırdır; sırada npm komutları ile paket yönetimi var.

node -v
npm -v
node -e "console.log('Node.js çalışıyor')"

06Node Sürümü Nasıl Değiştirilir?

Farklı projeler farklı Node.js sürümleri isteyebilir: eski bir proje eski sürümle, yeni bir proje güncel LTS ile çalışır. Node sürüm değiştirme işi nvm ile birkaç saniye sürer.

Projenin kök klasörüne bir .nvmrc dosyası koyarsanız, ekipteki herkes aynı sürümü kullanır. Klasöre girip nvm use yazmak, dosyadaki sürüme geçmek için yeterlidir (nvm-windows .nvmrc dosyasını okumaz; orada sürümü elle yazarsınız).

# Kurulu sürümler
nvm ls

# Uzak sunucudaki LTS sürümleri
nvm ls-remote --lts

# Belirli bir ana sürümü kurup geçme (örnek)
nvm install 20
nvm use 20

# Projede kullanılan sürümü kaydetme
node -v > .nvmrc
nvm use

07Sık Karşılaşılan Hatalar ve Çözümleri

Node.js kurulumundaki sorunların çoğu PATH ve izinlerle ilgilidir. Aşağıdaki liste, en sık gördüğümüz hataları ve hızlı çözümlerini özetler.

node komutu tanınmıyor

Windows'ta “node is not recognized” hatası genellikle terminal kurulumdan önce açıldığı için çıkar. Tüm terminalleri ve VS Code'u kapatıp açın; sorun sürerse PATH değişkeninde Node.js klasörünün olup olmadığını kontrol edin.

PowerShell betik engeli

PowerShell, npm.ps1 dosyasını çalıştırmayı reddedebilir. Yalnızca kendi kullanıcınız için yürütme ilkesini gevşetmek sorunu çözer:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

EACCES izin hatası

macOS ya da Linux'ta npm install -g sırasında EACCES hatası alıyorsanız Node.js sistem klasörüne kurulmuştur. sudo ile npm çalıştırmayın; mevcut kurulumu kaldırıp nvm ile yeniden kurun.

nvm: command not found

Kurulum betiği nvm satırlarını kabuk profilinize ekler ama açık terminal bunu bilmez. source ~/.zshrc ya da source ~/.bashrc çalıştırın veya terminali yeniden açın.

08Kurulumdan Sonra Ne Yapmalı?

Node.js hazır olduğunda geliştirme ortamının geri kalanını tamamlayın: bir editör için VS Code kurulumu, kodunuzu yedeklemek ve paylaşmak için GitHub'a proje yükleme rehberlerimize göz atabilirsiniz. Tüm adım adım anlatımlar kurulum rehberleri kategorisinde.

Bir işletme için web projesi geliştiriyorsanız, Node.js tabanlı araçlar derleme sırasında görselleri, CSS'i ve JavaScript'i küçülterek sayfa hızına doğrudan katkı sağlar. Bu konuyu hız ve performans yönetimi hizmetimizde ayrıntılı ele alıyoruz.

Kendi ekibiniz yoksa ya da projeniz bir e-ticaret altyapısı gibi kapsamlı bir sistem gerektiriyorsa, kurulum ve geliştirmeyi uzman bir ekibe bırakmak zaman kazandırır. Kurumsal web sitesi ve e-ticaret altyapısı projelerinde tüm ortamı biz kuruyor, siz yalnızca içeriğe odaklanıyorsunuz.