Adım Adım Node.js Kurulumu ve Geliştirme Ortamı Rehberi

Modern web geliştirme dünyasında, JavaScript artık sadece tarayıcı içinde çalışan bir dil olmaktan çıktı. Sunucu tarafında da güçlü projeler üretilmesini sağlayan Node.js, günümüzde milyonlarca geliştiricinin vazgeçilmez araçlarından biri haline geldi. İster sıfırdan bir API geliştirmek, ister modern bir ön yüz framework'ü (React, Vue, Angular gibi) kullanmak isteyin, bilgisayarınızda sağlıklı çalışan bir Node.js kurulumu yapmanız gerekir. Bu rehberimizde, farklı işletim sistemlerinde Node.js ve paket yöneticisi npm'in nasıl kurulacağını, en iyi pratikleri ve ilk projenizi nasıl ayağa kaldıracağınızı adım adım anlatacağız.

Node.js Kurulumu Öncesi Bilinmesi Gerekenler

Node.js, Chrome'un V8 JavaScript motoru üzerine kurulmuş bir çalışma ortamıdır (runtime). Kuruluma geçmeden önce iki önemli kavramı bilmeniz gerekir: LTS (Long Term Support) ve Current (En Güncel) sürümler.

• LTS Sürümü: Uzun süreli destek alan, kararlı ve hatalardan arındırılmış sürümdür. Üretim ortamındaki (production) projeler için her zaman LTS sürümü önerilir.
• Current Sürümü: En son eklenen özellikleri barındıran ancak henüz tam olarak kararlı hale gelmemiş olabilecek sürümdür. Yeni özellikleri denemek isteyen geliştiriciler tercih edebilir.

WebTeknoloji ekibi olarak, projelerinizde beklenmedik hatalarla karşılaşmamak adına her zaman LTS sürümünü tercih etmenizi öneriyoruz.

Windows İşletim Sisteminde Node.js Kurulumu

Windows işletim sistemine sahip bir bilgisayarda Node.js kurmanın iki popüler yolu vardır. Birincisi doğrudan resmi web sitesinden indirilen yükleyiciyi (installer) kullanmak, ikincisi ise sürüm karmaşasını önleyen Node Version Manager (NVM) kullanmaktır.

Yöntem 1: Resmi Yükleyici ile Kurulum

• Tarayıcınızdan Node.js Resmi Sitesi adresine gidin.
• İşletim sisteminiz için önerilen LTS sürümünü indirin (genellikle .msi uzantılı bir dosya inecektir).
• İndirdiğiniz dosyayı çalıştırın ve kurulum sihirbazındaki adımları takip edin.
• "Tools for Native Modules" adımına geldiğinizde, Chocolatey gibi gerekli araçların otomatik kurulması için ilgili kutucucu işaretleyebilirsiniz. Bu adım, bazı C/C++ tabanlı npm paketlerinin derlenmesi için önemlidir.
• Kurulumu tamamlayın.

Yöntem 2: NVM (Node Version Manager) ile Kurulum (Önerilen)

Aynı bilgisayarda birden fazla projede çalışıyorsanız ve bu projelerin farklı Node.js sürümlerine ihtiyacı varsa, doğrudan kurulum yapmak yerine NVM kullanmalısınız. Windows için nvm-windows aracını kullanabilirsiniz.

• nvm-windows GitHub sayfasına gidin ve en son sürümün nvm-setup.zip dosyasını indirin.
• ZIP dosyasını açıp kurulumu gerçekleştirin.
• Komut İstemi'ni (CMD) yönetici olarak açın ve aşağıdaki komutla kurulumu doğrulayın:

nvm version

• İstediğiniz bir Node.js sürümünü kurmak için şu komutu çalıştırın:

nvm install 20.11.0

• Kurulan sürümü aktif etmek için:

nvm use 20.11.0

macOS ve Linux Üzerinde Node.js Kurulumu

Unix tabanlı işletim sistemlerinde Node.js kurmak, paket yöneticileri sayesinde oldukça pratiktir.

macOS için Homebrew ile Kurulum

Eğer macOS kullanıyorsanız ve bilgisayarınızda Homebrew yüklüyse, terminali açıp şu komutu yazarak hızlıca kurulum yapabilirsiniz:

brew install node

Ancak macOS kullanıcıları için de en esnek yöntem nvm kullanmaktır. Terminale şu komutu girerek NVM'i kurabilirsiniz:

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

Ardından terminalinizi yeniden başlatıp nvm install --lts komutu ile en güncel kararlı sürümü yükleyebilirsiniz.

Linux (Ubuntu/Debian) Üzerinde Node.js Kurulumu

Linux dağıtımlarında resmi depolardaki Node.js sürümü genellikle eski kalabilir. Bu yüzden en güncel sürümü NodeSource depolarını kullanarak veya yine NVM aracılığıyla kurmak en doğrusudur. NodeSource deposunu eklemek ve kurulumu yapmak için terminalde sırasıyla şu komutları çalıştırın:

sudo apt-get update
sudo apt-get install -y curl build-essential
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Node.js Kurulumu Sonrası İlk Adımlar: npm ve npx

Kurulum tamamlandıktan sonra, her şeyin yolunda gittiğinden emin olmamız gerekir. Terminalinizi veya komut satırınızı açarak şu komutları çalıştırın:

node -v
npm -v

Bu komutlar kurulu olan Node.js ve npm (Node Package Manager) sürümlerini ekrana yazdıracaktır. Eğer sürüm numaralarını görebiliyorsanız, kurulum başarıyla tamamlanmış demektir.

npm Nedir?

npm, Node.js ile birlikte otomatik olarak kurulan dünyanın en büyük yazılım kayıt defteridir (registry). Projelerinizde kullanmak istediğiniz açık kaynaklı kütüphaneleri ve paketleri tek bir komutla indirmek için npm kullanırsınız:

npm install express

npx Nedir?

npx, npm 5.2.0 sürümüyle birlikte gelen bir paket çalıştırıcıdır. Bilgisayarınıza küresel (global) olarak kurmak istemediğiniz, sadece tek seferlik çalıştırmak istediğiniz CLI araçlarını doğrudan çalıştırmanızı sağlar. Örneğin, bir React projesi başlatmak için create-react-app paketini bilgisayarınıza kurmadan doğrudan npx ile çalıştırabilirsiniz:

npx create-react-app my-app

Proje Yapılandırması: package.json Dosyası Nedir?

Her modern Node.js projesinin kalbinde bir package.json dosyası bulunur. Bu dosya, projenizin adını, sürümünü, bağımlı olduğu dış paketleri ve çalıştırılabilir terminal scriptlerini barındırır. Yeni bir projeye başlarken terminalde projenizin klasörüne gidip şu komutu çalıştırmalısınız:

npm init -y

Bu komut, klasörünüzde varsayılan ayarlarla bir package.json dosyası oluşturacaktır. Artık yükleyeceğiniz her paket bu dosyaya otomatik olarak kaydedilir. Böylece projenizi başka bir bilgisayara taşırken devasa boyuttaki node_modules klasörünü kopyalamanıza gerek kalmaz. Sadece package.json dosyasının olduğu dizinde npm install komutunu çalıştırmanız, tüm bağımlılıkların otomatik olarak internetten indirilip kurulmasını sağlar.

Kurulum Sırasında Karşılaşılan Yaygın Hatalar ve Çözümleri

• 'node' is not recognized as an internal or external command: Bu hata genellikle Windows işletim sisteminde ortam değişkenlerinin (PATH) güncellenmemesinden kaynaklanır. Bilgisayarınızı yeniden başlatmak veya terminali kapatıp açmak genellikle bu sorunu çözer. Eğer çözülmezse, Node.js'in kurulu olduğu dizini (genellikle C:\Program Files odejs\) sistem ortam değişkenlerindeki PATH kısmına manuel olarak eklemeniz gerekir.
• EACCES Permission Denied Hatası (macOS/Linux): npm ile global bir paket kurmaya çalışırken (npm install -g <paket>) yetki hatası alabilirsiniz. Bu hatayı aşmak için komutların başına sudo eklemek geçici bir çözüm olsa da güvenlik açısından önerilmez. En sağlıklı çözüm, Node.js'i NVM aracılığıyla kurmaktır. NVM kullanıldığında tüm paketler kullanıcının ev dizinine kurulduğu için yönetici izni gerektirmez.

Örnek Bir "Hello World" Uygulaması Çalıştırma

Geliştirme ortamımızın çalıştığını test etmek için basit bir JavaScript dosyası oluşturalım ve bunu Node.js ile terminal üzerinden çalıştıralım. Kodlarımızı yazmak için popüler bir editör olan Visual Studio Code kullanabilirsiniz.

• Bilgisayarınızda hello-node adında boş bir klasör oluşturun.
• Bu klasörün içerisinde app.js adında bir dosya yaratın.
• app.js dosyasını açın ve içerisine şu basit JavaScript kodunu yazın:

const message = "Merhaba WebTeknoloji Okurları! Node.js başarıyla çalışıyor.";
console.log(message);

// Basit bir HTTP sunucusu oluşturalım
const http = require('http');
const hostname = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
  res.end('Node.js Sunucusundan Selamlar!
');
});

server.listen(port, hostname, () => {
  console.log(`Sunucu şu adreste çalışıyor: http://${hostname}:${port}/`);
});

• Terminalinizi açın, projenizin bulunduğu klasöre gidin (cd hello-node).
• Dosyayı çalıştırmak için şu komutu girin:

node app.js

• Terminalde Sunucu şu adreste çalışıyor: http://127.0.0.1:3000/ mesajını göreceksiniz. Tarayıcınızı açıp bu adrese gittiğinizde yazdığınız mesajı görebilirsiniz. Tebrikler, ilk yerel web sunucunuzu başarıyla ayağa kaldırdınız!

Sonuç ve En İyi Pratikler

Node.js dünyasına adım atmak, modern web geliştirme süreçlerinde size büyük bir esneklik ve hız kazandıracaktır. Kurulum sonrasında projelerinizin güvenliği ve sürdürülebilirliği için şu pratikleri aklınızda bulundurmanızda fayda var:

• Düzenli Güncellemeler: Node.js ve npm paketlerinizi düzenli olarak güncelleyin. Güvenlik açıklarını kapatmak için npm audit komutunu sık sık kullanın.
• Sürüm Kontrolü: Ekip çalışmalarında herkesin aynı Node.js sürümünü kullandığından emin olmak için proje kök dizinine bir .nvmrc dosyası ekleyin.
• Gereksiz Global Paketlerden Kaçının: Paketleri global (-g) kurmak yerine projenize özel (--save-dev veya --save) kurmaya özen gösterin. Bu, projelerinizin taşınabilirliğini kolaylaştırır.