Node.js Kurulumu ve Windows Üzerinde Yerel Geliştirme Ortamı Oluşturma

Node.js Kurulumu ve Windows Üzerinde Yerel Geliştirme Ortamı Oluşturma

Giriş

Günümüzün hızla gelişen yazılım dünyasında, web uygulamaları ve sunucu tarafı geliştirmeler için JavaScript’in kullanımı her geçen gün artmaktadır. Bu yükselişin en önemli aktörlerinden biri de Node.js’tir. Node.js, Google Chrome’un V8 JavaScript motoru üzerine inşa edilmiş, sunucu tarafı ve ağ uygulamaları oluşturmak için tasarlanmış açık kaynaklı, çapraz platform bir JavaScript çalışma zamanı ortamıdır. Asenkron, olay tabanlı mimarisi sayesinde yüksek performanslı ve ölçeklenebilir uygulamalar geliştirmeye olanak tanır.

Bu kapsamlı teknik makalede, Windows işletim sistemi üzerinde Node.js’i nasıl kuracağınızı, bir yerel geliştirme ortamını nasıl yapılandıracağınızı ve ilk Node.js projenizi nasıl oluşturacağınızı adım adım öğreneceksiniz. İster deneyimli bir geliştirici olun ister Node.js dünyasına yeni adım atıyor olun, bu rehber size sağlam bir temel sunacaktır. Çeşitli kurulum yöntemlerini, temel geliştirme araçlarını ve sık karşılaşılan sorunlara çözümleri ele alarak, sorunsuz bir başlangıç yapmanızı sağlamayı hedefliyoruz.

Node.js Nedir?

Node.js, JavaScript’i tarayıcı dışında çalıştırmanıza olanak tanıyan bir çalışma zamanı ortamıdır. Temelinde, Google Chrome web tarayıcısının kullandığı yüksek performanslı V8 JavaScript motoru bulunur. Bu sayede, JavaScript kodunuz sunucu tarafında hızlı ve verimli bir şekilde yorumlanır ve çalıştırılır.

Node.js’in en belirgin özelliklerinden biri, olay tabanlı (event-driven) ve engellemeyen (non-blocking) G/Ç (Input/Output) modelidir. Geleneksel sunucu uygulamaları, bir istek geldiğinde o isteği tamamlayana kadar diğer istekleri bekletebilir (engelleme). Node.js ise bir istek geldiğinde, G/Ç işlemlerinin (veritabanı sorguları, dosya okuma/yazma, ağ istekleri vb.) tamamlanmasını beklemeden diğer isteklere hizmet etmeye devam eder. G/Ç işlemi tamamlandığında, ilgili geri çağırım (callback) fonksiyonu çalıştırılır. Bu asenkron yapı, Node.js’in aynı anda binlerce bağlantıyı çok az kaynak tüketimiyle yönetebilmesini sağlar, bu da onu gerçek zamanlı uygulamalar (chat uygulamaları, oyunlar), API’ler ve mikroservisler için ideal kılar.

Node.js’in Kullanım Alanları:
* Web Sunucuları ve API’ler: Express.js, NestJS gibi framework’lerle RESTful API’ler ve tam teşekküllü web uygulamaları geliştirmek.
* Gerçek Zamanlı Uygulamalar: Socket.IO ile sohbet uygulamaları, işbirliği araçları gibi interaktif platformlar oluşturmak.
* Mikroservis Mimarileri: Daha küçük, bağımsız servisler halinde çalışan uygulamalar geliştirmek.
* Komut Satırı Araçları (CLI): Proje otomasyonu, kod üretimi gibi görevler için özel CLI araçları yazmak.
* Masaüstü Uygulamaları: Electron framework’ü ile platformlar arası masaüstü uygulamaları (VS Code, Slack gibi) geliştirmek.
* Veri Akışı Uygulamaları: Büyük veri setlerini işlemek veya gerçek zamanlı veri akışlarını yönetmek.

Node.js’in Avantajları:
* Tek Dil: Hem ön yüz (frontend) hem de arka yüz (backend) için JavaScript kullanma yeteneği, tam yığın (full-stack) geliştiriciler için öğrenme eğrisini azaltır ve kod paylaşımını kolaylaştırır.
* Yüksek Performans ve Ölçeklenebilirlik: Asenkron, olay tabanlı mimarisi sayesinde yoğun yük altında bile hızlı yanıt süreleri ve yüksek eşzamanlı bağlantı kapasitesi sunar.
* Geniş Ekosistem (npm): Node Package Manager (npm), dünyanın en büyük açık kaynaklı paket ekosistemlerinden biridir. Binlerce hazır modül ve kütüphane sayesinde geliştirme süreci hızlanır.
* Aktif Topluluk: Büyük ve aktif bir geliştirici topluluğu, sürekli destek, güncellemeler ve yeni araçlar sağlar.

Windows Üzerinde Node.js Kurulumuna Hazırlık

Node.js kurulumuna başlamadan önce bazı temel hususları gözden geçirmek faydalı olacaktır.

Sistem Gereksinimleri:
Node.js, modern Windows işletim sistemlerinin çoğunda sorunsuz çalışır (Windows 7 ve üzeri). Çok özel bir donanım gereksinimi yoktur, ancak geliştireceğiniz uygulamanın karmaşıklığına göre yeterli RAM ve işlemci gücü önemlidir.

Mevcut Node.js Sürümünü Kontrol Etme:
Daha önce Node.js kurmuş olabilirsiniz. Kurulup kurulmadığını veya hangi sürümün yüklü olduğunu kontrol etmek için Komut İstemi’ni (Command Prompt) veya PowerShell’i açın ve aşağıdaki komutları çalıştırın:

node -v
npm -v

Eğer bu komutlar bir sürüm numarası döndürürse, Node.js ve npm zaten yüklüdür. Eğer hata alırsanız, Node.js yüklü değildir veya PATH değişkeninize eklenmemiştir.

Neden LTS Sürümü?
Node.js’in iki ana sürüm dalı vardır:
* LTS (Long Term Support – Uzun Süreli Destek): Bu sürümler, kararlılık ve uzun vadeli destek sağlamak üzere tasarlanmıştır. Çoğu üretim ortamı ve yeni projeler için önerilen sürümdür. Hata düzeltmeleri ve güvenlik güncellemeleri uzun süre sağlanır.
* Current (Güncel): En son özellikleri ve geliştirmeleri içerir, ancak daha sık güncellenir ve kararlılık açısından LTS kadar garantili değildir. Genellikle yeni özellikler denemek isteyenler veya test ortamları için tercih edilir.

Yeni bir proje başlatıyorsanız veya kararlı bir ortam arıyorsanız, her zaman LTS sürümünü tercih etmelisiniz.

Kurulum Yöntemlerine Genel Bakış:
Node.js’i Windows’a kurmanın birkaç yolu vardır:
1. Resmi Node.js Yükleyicisi: En basit ve yaygın yöntemdir. Resmi web sitesinden indirilen bir .msi paketi ile kurulum yapılır.
2. NVM (Node Version Manager) for Windows: Birden fazla Node.js sürümünü aynı anda yönetmek ve projeler arasında kolayca geçiş yapmak isteyen geliştiriciler için idealdir.
3. Chocolatey: Windows için bir paket yöneticisidir. Komut satırından Node.js ve diğer birçok aracı kolayca kurmanızı sağlar.

Aşağıda bu yöntemleri detaylı olarak inceleyeceğiz.

Yöntem 1: Resmi Node.js Yükleyicisini Kullanarak Kurulum

Bu yöntem, Node.js’i Windows sisteminize kurmanın en kolay ve en yaygın yoludur. Genellikle tek bir Node.js sürümüne ihtiyacınız varsa tercih edilir.

Adım 1: Resmi Web Sitesine Gitme
Web tarayıcınızı açın ve Node.js’in resmi web sitesine gidin: [nodejs.org](https://nodejs.org/)

Adım 2: LTS Sürümünü İndirme
Ana sayfada genellikle iki büyük indirme düğmesi bulunur: “LTS” (Long Term Support – Uzun Süreli Destek) ve “Current” (Güncel). Yeni bir proje için veya kararlı bir ortam arıyorsanız, LTS sürümünü indirmenizi şiddetle tavsiye ederiz. Windows için uygun olan .msi yükleyicisini indirin.

Adım 3: Yükleyiciyi Çalıştırma
İndirilen .msi dosyasını çift tıklayarak çalıştırın. Kurulum sihirbazı başlayacaktır.
* Welcome: “Next” düğmesine tıklayın.
* End-User License Agreement: Lisans anlaşmasını okuyun ve “I accept the terms in the License Agreement” seçeneğini işaretleyerek “Next” düğmesine tıklayın.
* Destination Folder: Node.js’in yükleneceği konumu seçin. Varsayılan konum genellikle C:\Program Files\nodejs\ şeklindedir ve çoğu kullanıcı için uygundur. “Next” düğmesine tıklayın.
* Custom Setup: Bu adımda yüklenecek bileşenleri seçebilirsiniz. Varsayılan olarak tüm gerekli bileşenler (Node.js runtime, npm package manager, çevrimiçi belge kısayolları, PATH’e ekleme) seçili gelir. Özellikle “Add to PATH” seçeneğinin işaretli olduğundan emin olun, aksi takdirde Node.js ve npm komutlarını komut isteminden çalıştıramazsınız. “Next” düğmesine tıklayın.
* Tools for Native Modules: Bu ekranda “Automatically install the necessary tools…” seçeneğini görebilirsiniz. Bu, Python ve Visual Studio Build Tools gibi bazı yerel Node.js modüllerini derlemek için gerekli olabilecek araçları otomatik olarak kurar. Çoğu durumda buna ihtiyacınız olmayabilir, ancak emin değilseniz veya yerel modüllerle çalışmayı planlıyorsanız işaretleyebilirsiniz. İşaretlerseniz, kurulum biraz daha uzun sürebilir ve ek indirmeler gerektirebilir. Şimdilik işaretlemeden devam edebilirsiniz. “Next” düğmesine tıklayın.
* Ready to install Node.js: “Install” düğmesine tıklayarak kurulumu başlatın. Yönetici izni istenebilir, onaylayın.

Kurulum tamamlandığında, “Finish” düğmesine tıklayarak sihirbazı kapatın.

Adım 4: Kurulumu Doğrulama
Kurulumun başarılı olup olmadığını kontrol etmek için:
1. Komut İstemi (Command Prompt) veya PowerShell uygulamasını açın. (Başlat menüsüne “cmd” veya “powershell” yazarak bulabilirsiniz.)
2. Aşağıdaki komutları ayrı ayrı çalıştırın:

node -v
    npm -v

Bu komutlar Node.js ve npm’in yüklü sürümlerini göstermelidir (örneğin, v18.17.0 ve 9.6.7). Eğer sürüm numaralarını görüyorsanız, kurulumunuz başarıyla tamamlanmıştır.

PATH Değişkeni Açıklaması:
Node.js yükleyicisi, Node.js ve npm yürütülebilir dosyalarının konumunu otomatik olarak sisteminizin PATH ortam değişkenine ekler. PATH değişkeni, işletim sisteminizin komut satırında bir komut çalıştırıldığında nerede yürütülebilir dosya arayacağını belirten bir listedir. Bu sayede, Node.js’in yüklü olduğu dizine gitmek zorunda kalmadan herhangi bir dizinden node veya npm komutlarını çalıştırabilirsiniz.

Yöntem 2: NVM (Node Version Manager) ile Node.js Kurulumu

Birden fazla Node.js sürümünü aynı anda yönetme ihtiyacınız varsa (örneğin, farklı projeler farklı Node.js sürümleri gerektiriyorsa), NVM (Node Version Manager) kullanmak en iyi çözümdür. NVM for Windows, Linux/macOS’teki NVM’nin Windows uyarlamasıdır.

Neden NVM Kullanmalı?
* Çoklu Sürüm Desteği: Aynı anda birden fazla Node.js sürümünü kurabilir ve yönetebilirsiniz.
* Kolay Geçiş: Projeler arasında hızla farklı Node.js sürümlerine geçiş yapabilirsiniz.
* Test Ortamları: Yeni Node.js sürümlerini mevcut projelerinizi etkilemeden test edebilirsiniz.

Adım 1: Mevcut Node.js Kurulumunu Kaldırma (Varsa)
NVM kurmadan önce, resmi yükleyici ile kurduğunuz herhangi bir Node.js sürümünü kaldırmanız şiddetle tavsiye edilir. Aksi takdirde, NVM ile çakışmalar yaşanabilir.
* Denetim Masası > Programlar ve Özellikler (veya Ayarlar > Uygulamalar > Uygulamalar ve Özellikler) yolunu izleyin.
* Listeden “Node.js”i bulun ve kaldırın.

Adım 2: NVM for Windows’u İndirme ve Kurma
1. NVM for Windows’un GitHub sayfasına gidin: [https://github.com/coreybutler/nvm-windows/releases](https://github.com/coreybutler/nvm-windows/releases)
2. En son kararlı sürümü bulun. Genellikle “Assets” bölümünde nvm-setup.zip veya nvm-setup.exe gibi bir yükleyici bulacaksınız. nvm-setup.exe dosyasını indirin.
3. İndirilen nvm-setup.exe dosyasını çalıştırın.
4. Kurulum sihirbazındaki adımları takip edin:
* License Agreement: Lisansı kabul edin.
* NVM Destination Folder: NVM’nin kendisinin kurulacağı dizini seçin (örneğin, C:\Users\\AppData\Roaming\nvm).
* Node.js Symlink Folder: Node.js sürümlerinin kurulacağı ve yönetileceği dizini seçin (örneğin, C:\Program Files\nodejs). Bu, NVM’nin farklı Node.js sürümleri arasında geçiş yaparken kullanacağı sembolik bağlantıların (symlink) oluşturulacağı yerdir.
* Kurulumu tamamlayın.

Adım 3: NVM Kurulumunu Doğrulama
Yeni bir Komut İstemi veya PowerShell penceresi açın (mevcut pencereleri kapatıp yeniden açmanız gerekebilir). Aşağıdaki komutu çalıştırın:

nvm -v

Eğer NVM’nin sürüm numarasını görüyorsanız, kurulum başarılıdır.

Adım 4: Node.js Sürümlerini Yükleme
NVM ile Node.js sürümlerini yüklemek çok kolaydır.
* Mevcut Node.js sürümlerini listeleme:

nvm list available

Bu komut, NVM aracılığıyla yüklenebilecek tüm Node.js sürümlerini gösterir.

* Belirli bir LTS sürümünü yükleme (örneğin, 18.17.0):

nvm install 18.17.0

veya en son LTS sürümünü yüklemek için:

nvm install lts

* En son “Current” sürümünü yükleme:

nvm install latest

* Yüklü Node.js sürümlerini listeleme:

nvm list

Bu komut, sisteminizde NVM tarafından yönetilen tüm Node.js sürümlerini ve şu anda hangi sürümün kullanıldığını gösterir.

Adım 5: Sürümler Arası Geçiş Yapma
Yüklediğiniz Node.js sürümleri arasında geçiş yapmak için nvm use komutunu kullanın:

nvm use 18.17.0

veya

nvm use 

Bu komutu çalıştırdıktan sonra, node -v ve npm -v komutlarıyla geçerli Node.js ve npm sürümlerini kontrol edebilirsiniz.

Adım 6: Varsayılan Sürüm Ayarlama
Her yeni Komut İstemi veya PowerShell oturumu açtığınızda otomatik olarak belirli bir Node.js sürümünün kullanılmasını isterseniz, varsayılan bir sürüm ayarlayabilirsiniz:

nvm alias default 18.17.0

Artık her yeni terminal penceresi açtığınızda, Node.js v18.17.0 otomatik olarak kullanılacaktır.

Yöntem 3: Chocolatey ile Node.js Kurulumu

Chocolatey, Windows için bir paket yöneticisidir. Linux’taki apt veya yum gibi çalışır ve komut satırından yazılım kurmayı, güncelleştirmeyi ve kaldırmayı kolaylaştırır. Eğer sisteminizde zaten Chocolatey yüklüyse veya diğer geliştirme araçlarını da komut satırından yönetmek istiyorsanız, bu yöntem pratik olabilir.

Adım 1: Chocolatey Kurulumu (Varsa Atlayın)
Eğer Chocolatey sisteminizde yüklü değilse, öncelikle onu kurmanız gerekir:
1. Yönetici olarak PowerShell’i açın. (Başlat menüsüne “powershell” yazın, sağ tıklayın ve “Yönetici olarak çalıştır”ı seçin.)
2. Aşağıdaki komutu çalıştırın ve onaylamak için Y tuşuna basın:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

3. Kurulum tamamlandığında, yeni bir Yönetici PowerShell penceresi açın ve choco komutunu çalıştırarak kurulumu doğrulayın.

Adım 2: Node.js Kurulumu
Chocolatey yüklendikten sonra, Node.js’i kurmak için aşağıdaki komutu kullanın:

choco install nodejs-lts

Bu komut, Node.js’in en son LTS (Uzun Süreli Destek) sürümünü ve npm’i otomatik olarak indirecek ve kuracaktır. Kurulum sırasında onaylamanız istenebilir, Y tuşuna basarak devam edin.

Adım 3: Kurulumu Doğrulama
Kurulum tamamlandıktan sonra, yeni bir Komut İstemi veya PowerShell penceresi açın ve aşağıdaki komutları çalıştırarak Node.js ve npm’in yüklü sürümlerini kontrol edin:

node -v
npm -v

Sürüm numaralarını görüyorsanız, kurulum başarılıdır.

Avantajları:
* Basitlik: Tek bir komutla Node.js ve diğer birçok aracı kurabilirsiniz.
* Merkezi Yönetim: Diğer paketleri de Chocolatey ile yönetiyorsanız, tüm geliştirme ortamınızı tek bir yerden kontrol edebilirsiniz.
* Güncelleme Kolaylığı: choco upgrade nodejs-lts komutuyla Node.js’i kolayca güncelleyebilirsiniz.

Geliştirme Ortamı Kurulumu ve Yapılandırması

Node.js’i kurduktan sonra, verimli bir şekilde kod yazmak ve projelerinizi yönetmek için bazı ek araçlara ihtiyacınız olacaktır.

Metin Düzenleyici/IDE Seçimi

Kod yazmak için iyi bir metin düzenleyici veya Entegre Geliştirme Ortamı (IDE) olmazsa olmazdır.

Visual Studio Code (VS Code) (Önerilen)
Microsoft tarafından geliştirilen VS Code, Node.js geliştiricileri arasında açık ara en popüler seçimdir.
* Neden VS Code?
* Ücretsiz ve Açık Kaynak: Herkesin kullanımına açık.
* Hafif ve Hızlı: Büyük IDE’lere göre daha az kaynak tüketir.
* Genişletilebilirlik: Binlerce eklenti (Extensions) ile neredeyse her türlü geliştirme ihtiyacına uygun hale getirilebilir. Node.js, JavaScript, TypeScript, Git, Docker vb. için harika eklentileri vardır.
* Entegre Terminal: Doğrudan düzenleyici içinden komutları çalıştırabilirsiniz.
* Debugging Desteği: Node.js uygulamalarınızı kolayca hata ayıklayabilirsiniz.
* Git Entegrasyonu: Versiyon kontrolü için yerleşik Git desteği sunar.
* IntelliSense: Akıllı kod tamamlama, parametre bilgisi ve hızlı bilgi ipuçları.

* Kurulum: VS Code’u resmi web sitesinden indirebilirsiniz: [code.visualstudio.com](https://code.visualstudio.com/)

Diğer Alternatifler:
* Sublime Text: Hızlı, hafif ve minimalist bir düzenleyici.
* Atom: GitHub tarafından geliştirilen, özelleştirilebilir bir düzenleyici.
* WebStorm: JetBrains’in ücretli, ancak çok güçlü ve kapsamlı bir JavaScript IDE’sidir. Büyük projeler ve daha derinlemesine hata ayıklama özellikleri arayanlar için idealdir.

Git Kurulumu

Git, dağıtılmış bir versiyon kontrol sistemidir. Projelerinizin zaman içindeki değişikliklerini takip etmek, farklı sürümleri yönetmek ve ekip üyeleriyle işbirliği yapmak için hayati öneme sahiptir.

Neden Git Gerekli?
* Versiyon Kontrolü: Kodunuzun her sürümünü kaydeder, böylece istediğiniz zaman önceki bir duruma geri dönebilirsiniz.
* İşbirliği: Birden fazla geliştiricinin aynı proje üzerinde çakışmadan çalışmasını sağlar.
* Yedekleme: Projenizi uzak depolarda (GitHub, GitLab, Bitbucket) yedeklemenizi sağlar.

Kurulum:
1. Git’i resmi web sitesinden indirin: [git-scm.com/downloads](https://git-scm.com/downloads)
2. İndirilen .exe dosyasını çalıştırın ve kurulum sihirbazındaki adımları takip edin. Çoğu ayarı varsayılan olarak bırakabilirsiniz.
3. Git Bash: Kurulum sırasında Git Bash’in kurulduğundan emin olun. Bu, Windows’ta Linux benzeri komutlar kullanmanızı sağlayan bir terminaldir.
4. Doğrulama: Yeni bir Komut İstemi veya PowerShell penceresi açın ve aşağıdaki komutu çalıştırın:

git --version

Git’in sürüm numarasını görüyorsanız, kurulum başarılıdır.

Komut İstemi/Terminal Kullanımı

Node.js geliştirme sürecinde komut satırı (terminal) yoğun bir şekilde kullanılır.

Windows Terminal (Önerilen)
Microsoft tarafından geliştirilen Windows Terminal, birden fazla sekme, özelleştirme seçenekleri ve PowerShell, Komut İstemi, Git Bash, WSL (Windows Subsystem for Linux) gibi farklı kabukları tek bir pencerede çalıştırma yeteneği sunar.
* Kurulum: Microsoft Store’dan ücretsiz olarak indirebilirsiniz.

Diğerleri:
* PowerShell: Windows’un daha modern ve güçlü komut satırı arayüzü.
* Komut İstemi (CMD): Geleneksel Windows komut satırı.
* Git Bash: Git kurulumuyla birlikte gelen, Linux benzeri komutları destekleyen terminal.

Temel Terminal Komutları:
* cd : Belirtilen dizine geçiş yapar. (Change Directory)
* ls (Git Bash/PowerShell) / dir (CMD): Mevcut dizindeki dosyaları ve klasörleri listeler.
* mkdir : Yeni bir dizin oluşturur. (Make Directory)
* code .: VS Code’u mevcut dizinde açar (VS Code PATH’e eklenmişse).
* clear (Git Bash/PowerShell) / cls (CMD): Terminal ekranını temizler.

npm (Node Package Manager) Kullanımı

Node.js ile birlikte gelen npm (Node Package Manager), Node.js paketlerini (kütüphaneler, framework’ler, araçlar) yönetmek için kullanılan standart bir araçtır.

npm Nedir?
npm, Node.js ekosisteminin kalbidir. Binlerce açık kaynaklı paketi barındıran bir depodur ve bu paketleri projelerinize kolayca eklemenizi, güncellemenizi ve bağımlılıklarını yönetmenizi sağlar.

Temel npm Komutları:
* Yeni bir proje başlatma:

npm init

Bu komut, projeniz için package.json dosyasını oluşturur. Proje adı, sürüm, açıklama, ana dosya gibi bilgileri sorar.

npm init -y

-y bayrağı ile tüm sorulara varsayılan cevapları vererek hızlıca package.json oluşturur.

* Bir paketi kurma:

npm install 

Bu komut, belirtilen paketi projenizin node_modules klasörüne kurar ve package.json dosyasındaki dependencies bölümüne ekler.
Örnek: npm install express

* Geliştirme bağımlılığı olarak kurma:

npm install  --save-dev

veya kısaca

npm install  -D

Bu, paketi sadece geliştirme aşamasında ihtiyaç duyulan bir bağımlılık olarak devDependencies bölümüne ekler (örneğin, test kütüphaneleri, derleyiciler).

* Global bir paket kurma:

npm install -g 

Global paketler, sisteminizdeki herhangi bir dizinden erişilebilen komut satırı araçlarıdır (örneğin, nodemon, create-react-app).

* Bir paketi kaldırma:

npm uninstall 

* Tüm bağımlılıkları kurma:

npm install

Bu komut, package.json dosyasında listelenen tüm bağımlılıkları (hem dependencies hem de devDependencies) node_modules klasörüne kurar. Yeni bir projeyi klonladığınızda veya bir projeye ilk başladığınızda kullanılır.

* Bir paketi güncelleme:

npm update 

* npm önbelleğini temizleme:

npm cache clean --force

Bazen paket kurulumlarında sorunlar yaşandığında önbelleği temizlemek yardımcı olabilir.

package.json ve node_modules:
* package.json: Projenizin meta verilerini (adı, sürümü, açıklaması, script’ler, bağımlılıklar vb.) içeren bir dosyadır. Projenizin kimlik kartıdır.
* node_modules: npm install komutuyla kurulan tüm paketlerin ve onların bağımlılıklarının depolandığı klasördür. Bu klasör genellikle çok büyük olabilir ve Git’e commit edilmez (genellikle .gitignore dosyasına eklenir).

İlk Node.js Projenizi Oluşturma

Şimdi Node.js ve geliştirme ortamınızın çalıştığından emin olmak için basit bir proje oluşturalım.

Proje Klasörü Oluşturma

1. Tercih ettiğiniz bir konumda (örneğin, C:\Users\\Documents\NodeProjects) yeni bir klasör oluşturun.

mkdir my-first-node-app

2. Oluşturduğunuz klasörün içine girin:

cd my-first-node-app

3. VS Code’u bu klasörde açın (eğer PATH’e ekliyse):

code .

Proje Başlatma (npm init)

Terminali (VS Code’un entegre terminalini kullanabilirsiniz) açın ve aşağıdaki komutu çalıştırın:

npm init -y

Bu komut, varsayılan değerlerle bir package.json dosyası oluşturacaktır. İçeriği yaklaşık olarak şöyle görünecektir:

{
  "name": "my-first-node-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

"main": "index.js" kısmı, projenizin ana giriş noktasının index.js dosyası olacağını belirtir.

Basit Bir Node.js Uygulaması Yazma

1. VS Code’da my-first-node-app klasöründe yeni bir dosya oluşturun ve adını index.js olarak kaydedin.
2. index.js dosyasının içine aşağıdaki kodu yapıştırın:

// Node.js'in yerleşik 'http' modülünü dahil ediyoruz.
    const http = require('http');

    // Sunucunun dinleyeceği IP adresi ve port numarası.
    const hostname = '127.0.0.1'; // localhost
    const port = 3000;

    // Bir HTTP sunucusu oluşturuyoruz.
    // Her istek geldiğinde bu fonksiyon çalışır.
    const server = http.createServer((req, res) => {
      // HTTP durum kodunu 200 (OK) olarak ayarlıyoruz.
      res.statusCode = 200;
      // Yanıtın içerik türünü düz metin olarak ayarlıyoruz.
      res.setHeader('Content-Type', 'text/plain');
      // Yanıtı gönderiyoruz ve bağlantıyı kapatıyoruz.
      res.end('Merhaba Node.js Dunyasi!\n');
    });

    // Sunucuyu belirtilen IP ve port üzerinde dinlemeye başlıyoruz.
    server.listen(port, hostname, () => {
      console.log(Sunucu http://${hostname}:${port}/ adresinde calisiyor.);
    });

Bu kod, basit bir HTTP sunucusu oluşturur. Bu sunucu, herhangi bir isteğe “Merhaba Node.js Dünyası!” mesajıyla yanıt verir.

Uygulamayı Çalıştırma

1. VS Code’daki entegre terminalde (veya projenizin klasöründe açık olan herhangi bir terminalde) aşağıdaki komutu çalıştırın:

node index.js

2. Terminalde Sunucu http://127.0.0.1:3000/ adresinde calisiyor. mesajını görmelisiniz.
3. Web tarayıcınızı açın ve adres çubuğuna http://localhost:3000 yazın.
4. Tarayıcınızda “Merhaba Node.js Dünyası!” mesajını görmelisiniz.
5. Sunucuyu durdurmak için terminalde Ctrl + C tuşlarına basın.

Bağımlılık Yükleme Örneği (Express.js)

Node.js’in gücü, npm aracılığıyla binlerce paketi kullanabilme yeteneğinde yatar. En popüler Node.js web framework’lerinden biri olan Express.js’i projenize ekleyelim.

1. Terminalde projenizin kök dizininde olduğunuzdan emin olun (my-first-node-app).
2. Express.js’i kurmak için aşağıdaki komutu çalıştırın:

npm install express

Bu komut, express paketini node_modules klasörüne kuracak ve package.json dosyanızdaki dependencies bölümüne ekleyecektir. package.json dosyanız şimdi şöyle görünebilir:

{
      "name": "my-first-node-app",
      "version": "1.0.0",
      "description": "",
      "main": "index.js",
      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
      },
      "keywords": [],
      "author": "",
      "license": "ISC",
      "dependencies": {
        "express": "^4.18.2" // Express'in yüklü sürümü burada görünecektir
      }
    }

3. index.js dosyasının içeriğini aşağıdaki Express tabanlı kodla değiştirin:

const express = require('express');
    const app = express();
    const port = 3000;

    // Ana dizine gelen GET isteklerini dinle
    app.get('/', (req, res) => {
      res.send('Express ile Merhaba Dunya!');
    });

    // '/api' dizinine gelen GET isteklerini dinle
    app.get('/api', (req, res) => {
        res.json({ message: 'Bu bir API yanıtıdır!' });
    });

    // Sunucuyu başlat
    app.listen(port, () => {
      console.log(Express uygulamasi http://localhost:${port} adresinde calisiyor.);
    });

4. Uygulamayı tekrar çalıştırın:

node index.js

5. Tarayıcınızı açın ve http://localhost:3000 adresine gidin. “Express ile Merhaba Dünya!” mesajını görmelisiniz.
6. http://localhost:3000/api adresine gidin. JSON formatında bir yanıt görmelisiniz: {"message":"Bu bir API yanıtıdır!"}.

Tebrikler! Node.js’i başarıyla kurdunuz, geliştirme ortamınızı yapılandırdınız ve ilk Node.js uygulamanızı (hem düz HTTP sunucusu hem de Express ile) çalıştırdınız.

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

Node.js kurulumu ve kullanımı sırasında karşılaşabileceğiniz bazı yaygın sorunlar ve çözümleri:

1. 'node' is not recognized as an internal or external command veya 'npm' is not recognized... hatası:
* Neden: Node.js veya npm, sisteminizin PATH ortam değişkenine eklenmemiştir veya yanlış eklenmiştir.
* Çözüm:
* Resmi yükleyiciyi kullandıysanız, kurulum sırasında “Add to PATH” seçeneğinin işaretli olduğundan emin olun.
* NVM kullandıysanız, nvm use komutunu çalıştırdığınızdan ve terminali yeniden başlattığınızdan emin olun.
* Manuel olarak PATH değişkenini kontrol edin: Denetim Masası > Sistem ve Güvenlik > Sistem > Gelişmiş sistem ayarları > Ortam Değişkenleri. “Path” değişkenini bulun ve Node.js kurulum dizininin (örneğin, C:\Program Files\nodejs) veya NVM’nin sembolik bağlantı dizininin (örneğin, C:\Program Files\nodejs veya NVM kurulumu sırasında belirttiğiniz dizin) orada olduğundan emin olun. Değilse, ekleyin ve tüm terminal pencerelerini kapatıp yeniden açın.

2. Kurulum sırasında izin hataları (Access Denied):
* Neden: Yükleyiciyi yönetici ayrıcalıklarıyla çalıştırmıyorsunuz veya güvenlik yazılımları engelliyor.
* Çözüm:
* Yükleyici dosyasını (MSI veya EXE) sağ tıklayıp “Yönetici olarak çalıştır” seçeneğini seçin.
* Antivirüs veya güvenlik yazılımınızın Node.js kurulumunu engellemediğinden emin olun. Geçici olarak devre dışı bırakmayı deneyebilirsiniz.

3. npm paket kurulumunda hatalar (npm install):
* Neden: Bozuk npm önbelleği, ağ sorunları, uyumsuz Node.js/npm sürümleri veya yerel modüller için eksik derleme araçları.
* Çözüm:
* npm önbelleğini temizleyin: npm cache clean --force
* node_modules klasörünü ve package-lock.json dosyasını silin, sonra npm install komutunu tekrar çalıştırın.
* Ağ bağlantınızı kontrol edin.
* Eğer bir paket yerel derleme gerektiriyorsa (örneğin, node-sass), Node.js yükleyicisindeki “Tools for Native Modules” seçeneğini işaretleyerek veya manuel olarak Visual Studio Build Tools’u kurmanız gerekebilir. NVM kullanıyorsanız, npm config set msvs_version 2017 gibi bir komutla Visual Studio sürümünü belirtebilirsiniz.

4. Node.js versiyon uyumsuzlukları:
* Neden: Farklı projeler farklı Node.js sürümleri gerektiriyor ve siz yanlış sürümü kullanıyorsunuz.
* Çözüm:
* NVM kullanıyorsanız, nvm use komutuyla kolayca geçiş yapın.
* NVM kullanmıyorsanız, projenizin gerektirdiği Node.js sürümünü kurmanız ve PATH’i buna göre güncellemeniz veya NVM kurarak sürümleri yönetmeniz önerilir.

5. EACCES hatası (Linux/macOS’te daha yaygın, ancak Windows’ta da görülebilir):
* Neden: Global paketleri kurarken izin sorunları.
* Çözüm: Global paketleri kurarken sudo kullanmak (Windows’ta sudo yoktur) yerine, npm’in varsayılan global dizinini kullanıcı klasörünüze taşıyarak bu sorunu çözebilirsiniz. Ancak Windows’ta bu genellikle bir sorun değildir, yükleyici veya NVM bu durumu otomatik olarak yönetir. Eğer karşılaşırsanız, terminali yönetici olarak çalıştırmayı deneyin.

6. Windows Defender veya diğer Antivirüs yazılımları Node.js/npm’i engelliyor:
* Neden: Güvenlik yazılımları, Node.js veya npm’in bazı işlemlerini (örneğin, dosya yazma, ağ bağlantıları) potansiyel tehdit olarak algılayabilir.
* Çözüm: Güvenlik yazılımınızın ayarlarından Node.js’in kurulu olduğu dizinleri (veya node.exe, npm.cmd gibi yürütülebilir dosyaları) güvenli listeye ekleyin veya geçici olarak devre dışı bırakıp tekrar deneyin.

Bu sorunların çoğu, doğru kurulum adımlarını takip ederek ve terminali yönetici olarak çalıştırarak önlenebilir. Sorun yaşadığınızda hata mesajlarını dikkatlice okumak ve Google’da aratmak, genellikle hızlı bir çözüm bulmanızı sağlayacaktır.

Sonuç

Bu kapsamlı makalede, Node.js’in ne olduğundan, neden bu kadar popüler olduğundan ve Windows işletim sistemi üzerinde nasıl kurulacağından bahsettik. Resmi yükleyici, NVM ve Chocolatey gibi farklı kurulum yöntemlerini adım adım inceledik, her birinin avantajlarını ve dezavantajlarını tartıştık.

Ayrıca, verimli bir Node.js geliştirme ortamı oluşturmak için gerekli olan temel araçları (Visual Studio Code, Git, Windows Terminal) ve bunların nasıl yapılandırılacağını ele aldık. Node Package Manager (npm) hakkında detaylı bilgi vererek, paketlerin nasıl kurulacağını ve yönetileceğini öğrendik. Son olarak, basit bir “Merhaba Node.js Dünyası!” uygulamasını ve Express.js kullanarak daha gelişmiş bir web sunucusunu nasıl oluşturacağınızı gösterdik.

Artık Node.js ile yerel geliştirme ortamınızı kurmak ve ilk projelerinizi başlatmak için sağlam bir temele sahipsiniz. Node.js’in sunduğu sınırsız olanaklarla tanışmaya hazırsınız. Bir sonraki adım olarak, Node.js framework’lerini (Express.js, NestJS), veritabanlarını (MongoDB, PostgreSQL), frontend framework’lerini (React, Angular, Vue.js) keşfederek tam yığın uygulamalar geliştirmeye başlayabilir veya gerçek zamanlı uygulamalar, mikroservisler ve API’ler oluşturma yolculuğuna çıkabilirsiniz. Unutmayın, pratik yapmak ve sürekli öğrenmek, Node.js dünyasında uzmanlaşmanın anahtarıdır. Başarılar dileriz!