macOS’te Node.js Kurulumu ve Yerel Geliştirme Ortamı Oluşturma Rehberi
Günümüz web geliştirme dünyasında Node.js, sunucu tarafı uygulamalardan komut satırı araçlarına kadar geniş bir yelpazede kullanılan güçlü ve esnek bir çalışma zamanı ortamıdır. JavaScript’in tarayıcı dışında da çalışmasını sağlayarak, geliştiricilere tam yığın (full-stack) JavaScript deneyimi sunar. Bu makale, macOS işletim sisteminde Node.js’i nasıl kuracağınızı ve verimli bir yerel geliştirme ortamını nasıl oluşturacağınızı adım adım açıklamaktadır. Amacımız, hem yeni başlayanlar hem de deneyimli geliştiriciler için kapsamlı ve anlaşılır bir rehber sunmaktır.
Node.js Neden Önemli?
Node.js, Google Chrome’un V8 JavaScript motoru üzerine inşa edilmiştir ve olay tabanlı, eşzamansız (asynchronous) yapısıyla yüksek performanslı ve ölçeklenebilir ağ uygulamaları geliştirmek için idealdir. RESTful API’ler, gerçek zamanlı sohbet uygulamaları, mikro hizmetler ve hatta masaüstü uygulamaları (Electron ile) gibi birçok farklı alanda kullanılmaktadır. NPM (Node Package Manager) adı verilen devasa bir paket ekosistemine sahip olması, geliştirme sürecini hızlandıran binlerce açık kaynaklı kütüphane ve araca erişim imkanı sunar.
Ön Gereksinimler
Bu rehbere başlamadan önce, temel düzeyde komut satırı (terminal) kullanımı bilgisine sahip olmanız ve macOS sisteminizde yönetici (administrator) haklarına sahip bir kullanıcı hesabınızın bulunması gerekmektedir. Ayrıca, kurulum dosyalarını indirmek ve paketleri yüklemek için aktif bir internet bağlantınız olmalıdır.
Komut Satırı Araçlarını Kurma
Node.js ve diğer birçok geliştirme aracı, macOS’in temel komut satırı araçlarına ihtiyaç duyar. Bu araçlar, derleyiciler, Git ve diğer UNIX benzeri yardımcı programları içerir.
Xcode Komut Satırı Araçlarını Yükleme
Xcode Command Line Tools, macOS üzerinde yazılım geliştirme için gerekli temel araçları sağlar. Bunları yüklemek için Terminal uygulamasını açın (Spotlight araması ile “Terminal” yazarak bulabilirsiniz) ve aşağıdaki komutu çalıştırın:
xcode-select --installBu komut, bir açılır pencere ile kurulumu onaylamanızı isteyecektir. “Yükle” düğmesine tıklayarak devam edin ve lisans sözleşmesini kabul edin. Kurulumun tamamlanması internet bağlantınızın hızına bağlı olarak birkaç dakika sürebilir.
Kurulum tamamlandıktan sonra, Git’in doğru şekilde yüklendiğini kontrol ederek komut satırı araçlarının başarılı bir şekilde kurulduğunu doğrulayabilirsiniz:
git --versionEğer bir sürüm numarası görüyorsanız, kurulum başarılı demektir.
Node.js Kurulum Yöntemlerini Seçme
Node.js’i macOS’e kurmanın birkaç farklı yolu vardır. Her birinin kendine göre avantajları ve dezavantajları bulunur. Bu rehberde en yaygın ve önerilen yöntemleri ele alacağız:
1. Homebrew ile Kurulum: macOS için popüler bir paket yöneticisi olan Homebrew, Node.js ve diğer birçok geliştirme aracını kolayca kurmanızı ve güncellemenizi sağlar. Çoğu geliştirici için önerilen yöntemdir.
2. NVM (Node Version Manager) ile Kurulum: Özellikle birden fazla Node.js projesiyle çalışan veya farklı Node.js sürümlerini aynı anda yönetmek isteyen geliştiriciler için NVM vazgeçilmez bir araçtır. NVM, farklı Node.js sürümleri arasında kolayca geçiş yapmanızı sağlar.
3. Resmi Yükleyici ile Kurulum: Node.js’in resmi web sitesinden indirilen .pkg uzantılı yükleyici, en basit kurulum yöntemidir ancak farklı Node.js sürümlerini yönetme esnekliği sunmaz.
Bu rehberde, Homebrew ve NVM yöntemlerine odaklanacağız, çünkü bunlar geliştiricilere en fazla esnekliği sunar.
Homebrew ile Node.js Kurulumu
Homebrew, macOS için “eksik paket yöneticisi” olarak bilinir. Komut satırından yazılımları yüklemenizi, güncellemenizi ve kaldırmanızı kolaylaştırır.
Homebrew Kurulumu
Eğer sisteminizde Homebrew yüklü değilse, Terminal’i açın ve aşağıdaki komutu çalıştırın:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Bu komut, Homebrew kurulum betiğini indirir ve çalıştırır. Kurulum sırasında sizden yönetici parolanızı girmeniz istenebilir. Kurulumun tamamlanması biraz zaman alabilir.
Kurulum bittikten sonra, Homebrew’un doğru çalıştığından emin olmak için aşağıdaki komutu çalıştırın:
brew doctorBu komut, sisteminizdeki olası sorunları kontrol eder ve size önerilerde bulunur. Genellikle “Your system is ready to brew.” mesajını görmeniz beklenir.
Homebrew ile Node.js Yükleme
Homebrew yüklendikten sonra, Node.js’i kurmak çok basittir. Terminal’de aşağıdaki komutu çalıştırın:
brew install nodeBu komut, Node.js’in en son kararlı sürümünü ve onunla birlikte gelen npm (Node Package Manager) paket yöneticisini kuracaktır. Kurulum tamamlandığında, Node.js ve npm’in doğru şekilde kurulduğunu doğrulamak için sürüm numaralarını kontrol edin:
node -v
npm -vBeklenen çıktı, yüklü Node.js ve npm sürümlerini gösterecektir (örneğin, v18.12.1 ve 9.2.0).
Node.js’i Homebrew ile Güncelleme
Node.js’in yeni bir sürümü çıktığında, Homebrew aracılığıyla kolayca güncelleyebilirsiniz:
brew update # Homebrew'u günceller
brew upgrade node # Node.js'i en son sürüme yükseltirNVM (Node Version Manager) ile Node.js Kurulumu
Birden fazla Node.js projesi üzerinde çalışıyorsanız veya farklı projelerin farklı Node.js sürümlerine ihtiyaç duyduğunu görüyorsanız, NVM (Node Version Manager) sizin için en iyi çözümdür. NVM, sisteminizde birden fazla Node.js sürümünü kurmanıza, bunlar arasında kolayca geçiş yapmanıza ve her proje için belirli bir sürümü ayarlamanıza olanak tanır.
NVM Kurulumu
NVM’yi doğrudan curl komutu ile yüklemek en yaygın yöntemdir. Terminal’i açın ve aşağıdaki komutu çalıştırın (sürüm numarasını en güncel olanla değiştirebilirsiniz, v0.39.1 bir örnektir):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bashBu betik, NVM’yi ana dizininizdeki .nvm klasörüne kurar ve kabuk yapılandırma dosyanıza (örneğin, .zshrc veya .bash_profile) gerekli satırları ekleyerek NVM’nin her terminal oturumunda kullanılabilir olmasını sağlar.
Kurulum tamamlandıktan sonra, kabuk yapılandırma dosyanızdaki değişikliklerin etkin olması için terminali kapatıp yeniden açmanız veya aşağıdaki komutu çalıştırmanız gerekebilir:
source ~/.zshrc # Zsh kullanıyorsanız
veya
source ~/.bash_profile # Bash kullanıyorsanızNVM’nin başarılı bir şekilde kurulduğunu doğrulamak için sürüm numarasını kontrol edin:
nvm --versionNVM ile Node.js Sürümlerini Yükleme
NVM yüklendikten sonra, Node.js sürümlerini yönetmek çok kolaydır:
* En son kararlı sürümü yükleme:
nvm install node* Belirli bir LTS (Uzun Süreli Destek) sürümünü yükleme (örneğin, Node.js 18):
nvm install 18* Tam olarak belirli bir sürümü yükleme (örneğin, Node.js 18.12.1):
nvm install 18.12.1* Yüklü Node.js sürümlerini listeleme:
nvm lsBu komut, sisteminizde yüklü olan tüm Node.js sürümlerini gösterir ve şu anda aktif olanı belirtir.
* Farklı bir Node.js sürümünü kullanma:
nvm use 18Bu komut, mevcut terminal oturumunuz için Node.js 18 sürümünü aktif hale getirir.
* Varsayılan Node.js sürümünü ayarlama:
nvm alias default 18Bu komut, yeni açılan tüm terminal oturumları için varsayılan Node.js sürümünü 18 olarak ayarlar.
* Bir Node.js sürümünü kaldırma:
nvm uninstall 16NVM ile bir Node.js sürümü yüklediğinizde, o sürümle birlikte gelen npm de otomatik olarak kurulur ve yönetilir. Herhangi bir Node.js sürümünü aktif hale getirdikten sonra, node -v ve npm -v komutlarıyla doğru sürümlerin kullanıldığını doğrulayabilirsiniz.
Yerel Geliştirme Ortamı Oluşturma
Node.js’i kurduktan sonra, projelerinizi geliştirmeye başlamak için yerel bir ortam oluşturmanız gerekir.
Proje Klasör Yapısı
Geliştirme projelerinizi düzenli tutmak önemlidir. Genellikle tüm projeleriniz için ana bir klasör oluşturmak iyi bir uygulamadır.
1. Proje klasörü oluşturma:
mkdir ~/Development/NodeProjects
cd ~/Development/NodeProjects2. Yeni bir uygulama klasörü oluşturma:
mkdir my-first-node-app
cd my-first-node-appBir Node.js Projesini Başlatma
Her Node.js projesinin kalbinde package.json dosyası bulunur. Bu dosya, projenin meta verilerini (adı, sürümü, yazarı), bağımlılıklarını ve çalıştırılabilir komut dosyalarını (scripts) tanımlar.
1. package.json dosyasını oluşturma:
npm init -y -y bayrağı, npm init komutunun tüm sorulara varsayılan cevaplar vermesini sağlar ve hızlıca bir package.json dosyası oluşturur. Bu dosyayı daha sonra manuel olarak düzenleyebilirsiniz.
Oluşturulan package.json dosyası şö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"
}Bağımlılıkları Yükleme
Node.js projeleri, genellikle NPM üzerinden yüklenen üçüncü taraf kütüphanelere (paketlere) bağımlıdır. Örneğin, bir web sunucusu oluşturmak için Express.js’i kullanabilirsiniz.
1. Express.js’i yükleme:
npm install express Bu komut, Express.js paketini indirir ve projenizin node_modules klasörüne yerleştirir. Ayrıca, package.json dosyanızdaki dependencies (bağımlılıklar) bölümüne Express.js’i ekler ve package-lock.json adında bir dosya oluşturur. package-lock.json, bağımlılıkların tam ve kilitlenmiş sürümlerini içerir ve farklı ortamlarda tutarlı bağımlılık kurulumları sağlar.
Basit Bir Node.js Uygulaması Oluşturma
Şimdi basit bir Express.js web sunucusu oluşturalım.
1. app.js (veya index.js) dosyası oluşturma:
Proje klasörünüzde app.js adında yeni bir dosya oluşturun ve içine aşağıdaki kodu yapıştırın:
const express = require('express');
const app = express();
const port = 3000;
app.get('/', (req, res) => {
res.send('Merhaba Node.js Dünyası!');
});
app.listen(port, () => {
console.log(Uygulama http://localhost:${port} adresinde çalışıyor.);
}); Bu kod, 3000 numaralı bağlantı noktasında dinleyen basit bir Express sunucusu oluşturur. Ana dizine (/) yapılan GET isteklerine “Merhaba Node.js Dünyası!” mesajıyla yanıt verir.
Uygulamayı Çalıştırma
Uygulamanızı çalıştırmak için Terminal’de aşağıdaki komutu kullanın:
node app.jsTerminalde “Uygulama http://localhost:3000 adresinde çalışıyor.” mesajını görmelisiniz. Şimdi web tarayıcınızı açın ve http://localhost:3000 adresine gidin. “Merhaba Node.js Dünyası!” mesajını görmelisiniz.
Uygulamayı durdurmak için Terminal’de Ctrl + C tuşlarına basın.
nodemon ile Otomatik Yeniden Başlatma
Geliştirme sırasında kodunuzda yaptığınız her değişiklikten sonra uygulamayı manuel olarak durdurup yeniden başlatmak yorucu olabilir. nodemon paketi, dosya değişikliklerini algılar ve Node.js uygulamanızı otomatik olarak yeniden başlatır.
1. nodemon‘u yükleme:
Geliştirme bağımlılığı olarak yüklemek en iyi yaklaşımdır:
npm install --save-dev nodemonVeya global olarak yükleyebilirsiniz (ancak proje bağımlılığı olarak yönetmek daha iyidir):
npm install -g nodemon2. package.json‘a bir komut dosyası ekleme:
package.json dosyanızı açın ve scripts bölümüne bir start veya dev komutu ekleyin:
"scripts": {
"start": "nodemon app.js",
"test": "echo \"Error: no test specified\" && exit 1"
},3. Uygulamayı nodemon ile çalıştırma:
npm start Artık app.js dosyasında yaptığınız herhangi bir değişikliği kaydettiğinizde, nodemon uygulamayı otomatik olarak yeniden başlatacaktır.
Entegre Geliştirme Ortamı (IDE) Kullanımı
Node.js geliştirme için bir IDE veya gelişmiş bir metin düzenleyici kullanmak, verimliliğinizi büyük ölçüde artıracaktır. Visual Studio Code (VS Code), Node.js geliştiricileri arasında en popüler seçeneklerden biridir.
* VS Code’u yükleme: VS Code’u [resmi web sitesinden](https://code.visualstudio.com/) indirebilir ve kurabilirsiniz.
* Özellikleri: VS Code, akıllı kod tamamlama (IntelliSense), hata ayıklama araçları, Git entegrasyonu ve binlerce uzantı ile Node.js geliştirme için harika bir ortam sunar.
* Projenizi VS Code’da açma: Terminal’de proje klasörünüzdeyken code . komutunu çalıştırarak (VS Code’u PATH’inize eklediyseniz) projeyi VS Code’da açabilirsiniz.
Temel npm Komutları
npm (Node Package Manager), Node.js ekosisteminin ayrılmaz bir parçasıdır. İşte sık kullanılan bazı npm komutları:
* npm install : Bir paketi projenizin bağımlılıklarına ekler ve node_modules klasörüne yükler. package.json dosyasındaki dependencies bölümüne ekler.
* npm install --save-dev : Bir paketi yalnızca geliştirme sırasında kullanılan bir bağımlılık olarak yükler (örneğin nodemon). package.json dosyasındaki devDependencies bölümüne ekler.
* npm uninstall : Bir paketi node_modules klasöründen kaldırır ve package.json dosyasından siler.
* npm update: package.json dosyasında belirtilen tüm bağımlılıkları en son uyumlu sürümlerine günceller.
* npm run : package.json dosyasındaki scripts bölümünde tanımlanmış özel komutları çalıştırır (örneğin, npm run start).
* npm audit: Projenizin bağımlılıklarındaki bilinen güvenlik açıklarını denetler ve düzeltmeler önerir.
* npm outdated: Güncel olmayan paketleri listeler.
* npm list --depth=0: Yüklü olan ana bağımlılıkları listeler.
Yaygın Sorun Giderme
Kurulum veya geliştirme sırasında bazı sorunlarla karşılaşabilirsiniz. İşte yaygın sorunlar ve çözümleri:
PATH Ortam Değişkeni Sorunları
Bazen terminaliniz node, npm veya nvm komutlarını bulamayabilir. Bu genellikle PATH ortam değişkeninizin doğru şekilde yapılandırılmadığı anlamına gelir.
* PATH’i kontrol etme:
echo $PATH Bu komut, terminalinizin yürütülebilir dosyaları aradığı dizinleri listeler. Node.js ve npm’in bulunduğu dizinlerin (örneğin /usr/local/bin veya NVM’nin ~/.nvm/versions/node/vX.Y.Z/bin dizinleri) bu listede olması gerekir.
* PATH’i düzenleme:
NVM kurulumu sırasında bu genellikle otomatik olarak yapılır, ancak manuel olarak düzenlemeniz gerekirse, kabuk yapılandırma dosyanızı (örneğin ~/.zshrc veya ~/.bash_profile) bir metin düzenleyiciyle açın ve aşağıdaki satırların (veya benzerlerinin) mevcut olduğundan emin olun:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion Değişiklikleri kaydettikten sonra, source ~/.zshrc (veya ilgili dosyanız) komutunu çalıştırın veya terminali yeniden başlatın.
İzin Hataları (EACCES)
npm install -g komutuyla global paketler yüklemeye çalışırken EACCES gibi izin hataları alabilirsiniz. Bu, npm‘in global paketleri yüklemeye çalıştığı dizine yazma izniniz olmadığı anlamına gelir.
* Çözüm (NVM kullanıyorsanız): NVM kullanıyorsanız, bu sorunla karşılaşmanız pek olası değildir çünkü NVM, Node.js ve global paketleri kullanıcı dizininize yükler ve yönetir, bu da izin sorunlarını önler.
* Çözüm (NVM kullanmıyorsanız): Eğer NVM kullanmıyorsanız ve Homebrew ile kurduysanız, Homebrew genellikle doğru izinleri ayarlar. Ancak yine de sorun yaşıyorsanız, sudo ile kurulum yapmak (tavsiye edilmez) veya npm‘in global paket yükleme dizinini değiştirme gibi çözümler vardır. sudo kullanımı güvenlik riski oluşturabilir ve genellikle kaçınılmalıdır.
Çakışan Node.js Kurulumları
Sisteminizde farklı yöntemlerle (örneğin, hem resmi yükleyici hem de Homebrew) birden fazla Node.js kurulumu bulunuyorsa çakışmalar yaşanabilir.
* Kontrol etme: which node ve which npm komutlarını çalıştırarak Node.js ve npm’in hangi dizinlerden yüklendiğini kontrol edin.
* Çözüm: Çakışmaları önlemek için gereksiz kurulumları kaldırmanız önerilir. Örneğin, Homebrew ile kurduysanız, resmi yükleyici ile yaptığınız kurulumu kaldırmalısınız. NVM kullanıyorsanız, diğer tüm kurulumları kaldırın ve Node.js’i yalnızca NVM aracılığıyla yönetin.
Sonuç
Bu kapsamlı rehberde, macOS işletim sisteminde Node.js’i kurmanın farklı yollarını öğrendiniz ve Homebrew ile NVM’nin avantajlarını keşfettiniz. Ayrıca, yerel bir Node.js geliştirme ortamını nasıl oluşturacağınızı, temel npm komutlarını ve yaygın sorunları nasıl gidereceğinizi öğrendiniz. Artık Node.js projeleri geliştirmeye başlamak için sağlam bir temeliniz var.
Unutmayın ki geliştirme ortamınızı güncel tutmak ve en iyi uygulamaları takip etmek önemlidir. Node.js ekosistemi sürekli geliştiği için yeni araçları ve kütüphaneleri keşfetmeye devam edin. Bu rehber, Node.js yolculuğunuzda size iyi bir başlangıç noktası sunmuştur. Şimdi, öğrendiklerinizi kullanarak kendi uygulamalarınızı geliştirmeye başlayabilir ve Node.js’in sunduğu sınırsız olanakları keşfedebilirsiniz!