Yarn Paket Yöneticisi Kurulumu ve Kullanımı (Node.js)
Bu rehberde ne öğreneceksiniz?
Bu rehber, Node.js projeleri için Yarn paket yöneticisinin nasıl kurulacağını ve verimli şekilde nasıl kullanılacağını açıklar.
Global ve proje bazlı Yarn kurulumunu, temel komutları ve npm ile farklarını öğreneceksiniz.
Teknik Özet
Bu rehber, Node.js ortamında Yarn paket yöneticisinin kurulmasını ve kullanılmasını anlatır.
Amaç, bağımlılıkları daha hızlı, tutarlı ve öngörülebilir şekilde yönetmektir.
Adımlar: global kurulum → proje bazlı yapılandırma → temel komutlar → npm karşılaştırması.
Ön Hazırlıklar
- Node.js kurulu olmalıdır (LTS önerilir)
- Terminal kullanımına aşina olmalısınız
- Bir Node.js proje klasörünüz bulunmalıdır
Node.js sürümünü kontrol edin:
node -v
- Bu komut, sisteminizde Node.js olup olmadığını gösterir.
1. Yarn’ı Global Olarak Kurma
- Yarn önce sistem geneline kurulur.
- Bu kurulum, proje içindeki Yarn sürümünü başlatmak için kullanılır.
sudo npm install -g yarn
- Bu komut Yarn CLI aracını global olarak kurar.
Kurulumu doğrulayın:
yarn --version
- Bu komut, yüklü global Yarn sürümünü gösterir.
2. Projeye Özel Yarn Sürümü Ayarlama
- Her projede aynı Yarn sürümünün kullanılması önemlidir. Bu yaklaşım ekip ve CI/CD tutarlılığı sağlar.
Proje dizinine girin:
cd ~/my-project
- Yarn Berry sürümünü ayarlayın:
yarn set version berry
- Bu komut, projeye özel Yarn sürümünü indirir ve yapılandırır.
Sürümü tekrar kontrol edin:
yarn --version
- Bu komut, artık proje içindeki Yarn sürümünü gösterir.
3. Yeni Bir Yarn Projesi Başlatma
- Sıfırdan bir proje için başlangıç dosyaları oluşturulur.
yarn init
- Bu komut package.json ve yarn.lock dosyalarını oluşturur.
4. Bağımlılıkları Yükleme
- Mevcut bir projedeki tüm bağımlılıkları kurmak için:
yarn install
- Bu komut, yarn.lock dosyasına göre birebir kurulum yapar.
5. Paket Ekleme ve Kaldırma
- Yeni bir paket eklemek için:
yarn add express
- Bu komut paketi indirir ve kilit dosyasını günceller.
Bir paketi kaldırmak için:
yarn remove express
- Bu komut paketi projeden tamamen siler.
6. Hızlı Doğrulama (Test)
- Basit bir Express sunucusu kurarak Yarn’ı test edin.
const express = require("express");
const app = express();
app.get("/", (req, res) => res.send("Yarn çalışıyor"));
app.listen(3000);
- Bu kod, 3000 portunda basit bir HTTP sunucusu başlatır.
Çalıştırın:
yarn node index.js
- Bu komut uygulamayı Yarn üzerinden başlatır.
7. .gitignore Yapılandırması
- Yarn bazı dosyaları Git’e eklemeyi gerektirir.
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/sdks
!.yarn/versions
.pnp.*
- Bu yapı, gerekli Yarn dosyalarını korur.
8. Ek Yararlı Yarn Komutları
- Paketleri listeleme:
yarn list --depth=0
Güncellemeleri kontrol etme:
yarn outdated
Önbelleği temizleme:
yarn cache clean
Yarn mı npm mi?
- Yarn ve npm benzer amaçlara hizmet eder, ancak farkları vardır:
| Özellik | Yarn | npm |
|---|---|---|
| Kurulum Hızı | Daha hızlı | Orta |
| Tutarlılık | Çok yüksek | Yüksek |
| Monorepo | Güçlü | Sınırlı |
| Offline Kullanım | Güçlü | Zayıf |
| PnP Desteği | Var | Yok |
Özet:
Büyük ekipler ve monorepo yapıları için Yarn daha uygundur. Basit projelerde npm yeterlidir.
Sıkça Sorulan Sorular (SSS)
1. Yarn neden iki aşamalı kurulum kullanır? Global CLI sadece başlatıcıdır. Proje içi sürüm tutarlılığı sağlar.
2. Yarn node_modules oluşturmuyor mu? Varsayılan PnP modunda oluşturmaz. İstenirse kapatılabilir.
3. Yarn offline çalışabilir mi? Evet. Paketler önbellekten yüklenebilir.
4. Yarn CI/CD için uygun mu? Evet. --immutable seçeneğiyle birebir kurulum zorlanır.
5. npm’den Yarn’a geçilebilir mi? Evet, ancak package-lock.json silinmelidir.
Sonuç
Yarn, Node.js projelerinde hız, tutarlılık ve ölçeklenebilirlik sağlar. Özellikle ekip çalışması ve CI/CD süreçlerinde güçlü avantaj sunar.
Node.js projelerinizi güvenli ve yüksek performanslı bir altyapıda çalıştırmak için Rabisu Bulut platformunda hemen deneyebilirsiniz.