npm Nedir ve Ne Amaçla Kullanılır?
npm, aslında üç ana bileşenin birleşiminden oluşur. İlk olarak, npmjs.com üzerinde bulunan ve binlerce JavaScript paketini barındıran halka açık devasa bir veritabanıdır (registry). İkinci olarak, Node.js ile gelen ve bu kütüphaneleri yönetmenizi sağlayan komut satırı arayüzüdür (CLI). Üçüncü olarak ise projenizin yapılandırma bilgilerini tutan
package.json standardıdır.npm install express komutunu kullandığınızda, CLI aracılığıyla veritabanına bağlanırsınız; sistem express paketini ve tüm alt bağımlılıklarını indirir, bunları node_modules dizinine taşır ve paketi sürüm bilgisiyle birlikte package.json dosyanıza işler. Süreç temel olarak bu şekilde ilerler.Node.js yüklü olduğu sürece npm zaten bilgisayarınızda hazırdır. Kontrol etmek için şu komutları kullanabilirsiniz:
JavaScript:
node --version
npm --version
Her iki komut da birer sürüm numarası döndürüyorsa sisteminiz çalışmaya hazırdır.
Proje Kurulumu:
npm initHer npm projesinin bir
package.json dosyasına sahip olması şarttır. Bu dosya projenizin kimlik kartı gibidir; isim, versiyon, script tanımlamaları ve bağımlılık listesi gibi kritik bilgileri içerir. Hızlı bir başlangıç için npm init -y komutunu tercih edebilirsiniz; bu komut tüm varsayılan ayarları otomatik olarak onaylayarak dosyayı oluşturur:
JavaScript:
mkdir my-app
cd my-app
npm init -y
Komutu çalıştırdığınızda şu tarz bir çıktı alırsınız:
JavaScript:
{
"name": "my-app",
"version": "1.0.0",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
Eğer
-y parametresini kullanmazsanız, npm size gerekli alanları tek tek sorarak yönlendirmeli bir kurulum süreci başlatır. Hangi yöntemi seçerseniz seçin, elinizde tüm projenin merkezini oluşturan package.json dosyası olacaktır.npm install ile Paket YönetimiProjenizde bir
package.json dosyası varsa, paketleri npm install (veya kısaca npm i) komutuyla sisteme dahil edebilirsiniz:
JavaScript:
npm install lodash
Bu komut üç temel işlemi gerçekleştirir:
1. Belirtilen paket ve bağımlılıkları indirilerek
node_modules/ içine yazılır.2.
package.json içindeki dependencies alanına paket bilgisi ve sürümü eklenir.3. Bağımlılık ağacındaki tüm paketlerin tam sürümlerini sabitleyen
package-lock.json dosyası güncellenir.Artık ilgili paketi projenizde kolayca kullanabilirsiniz:
JavaScript:
// Sonra: npm install lodash
const _ = require("lodash");
const numbers = [1, 2, 3, 4, 5];
console.log(_.sum(numbers));
console.log(_.chunk(numbers, 2));
require veya ESM yapısında import kullandığınızda, Node.js otomatik olarak node_modules içinde arama yapar. Herhangi bir dosya yolu belirtmenize gerek kalmadan sistem modülü bulacaktır.dependencies ve devDependencies Arasındaki FarkUygulamanızın canlı (production) ortamında her pakete ihtiyacı olmayabilir. Test araçları veya derleyiciler gibi sadece geliştirme aşamasında kullanılan paketleri
--save-dev (kısa adıyla -D) parametresiyle kurmalısınız:
JavaScript:
npm install --save-dev jest
npm install -D eslint prettier
Bu paketler
package.json içerisinde devDependencies başlığı altında gruplanır:
JavaScript:
{
"dependencies": {
"lodash": "^4.17.21"
},
"devDependencies": {
"jest": "^29.7.0",
"eslint": "^8.57.0",
"prettier": "^3.2.5"
}
}
Canlı sunucularda
npm install --omit=dev komutunu çalıştırarak, sadece uygulama için gerekli paketleri kurabilir, böylece kurulum boyutunu küçültebilirsiniz. Bu ayrımı doğru yapmak, projenizin gereksiz şişmesini engellemek adına oldukça önemlidir.Tüm Bağımlılıkları Kurmak
package.json dosyası içeren bir projeyi klonladığınızda, paketleri tek tek yüklemenize gerek yoktur. Sadece şu komutu çalıştırmanız yeterlidir:
JavaScript:
npm install
Parametre vermeden bu komutu kullandığınızda npm, dosyayı okur ve
package-lock.json dosyasındaki verileri esas alarak tüm bağımlılıkları node_modules içine kurar.node_modules klasörünü .gitignore dosyasına eklememiz gerekir çünkü bu dizin oldukça büyüktür ve her zaman yeniden üretilebilir. Projenizde sadece package.json ve package-lock.json dosyalarını versiyon kontrol sistemine (git) göndermeniz yeterlidir.Paket Güncelleme
Güncel olmayan paketleri listelemek için
npm outdated komutu kullanılır:
JavaScript:
npm outdated
Karşınıza çıkan tabloda
Current, Wanted ve Latest sütunlarını görürsünüz. Wanted, package.json içindeki kısıtlamalara uygun en güncel sürümü; Latest ise paketin dünyadaki en son yayınlanmış sürümünü ifade eder.Belirlenen sürüm aralığında güncelleme yapmak için şu komutu kullanın:
JavaScript:
npm update
Eğer major (ana) sürüm dahil en son sürüme geçmek isterseniz paketi
@latest etiketiyle yeniden kurmanız gerekir:
JavaScript:
npm install lodash@latest
Major güncellemeler kodunuzu etkileyebileceği için, bu yükseltmeyi yapmadan önce paketin değişiklik notlarını incelemeniz önerilir.
Paket Kaldırma
Bir paketi kaldırmak kurulum kadar kolaydır:
JavaScript:
npm uninstall lodash
Bu işlem paketi
node_modules klasöründen siler ve package.json kaydını günceller. Eğer paket bir geliştirme bağımlılığıysa -D eklemek kuralı bozmaz.Local ve Global Kurulum Farkı
Genellikle kurulumlar, projenin kendi klasörüne (local) yapılmalıdır. Yalnızca her yerden erişmek istediğiniz CLI araçları için global kurulum tercih edilir:
JavaScript:
npm install -g typescript
npm install -g http-server
Global kurulum, paketi sistem genelindeki
PATH dizinine ekler. Ancak bu durum makineler arası uyumsuzluk yaratabilir. Tek seferlik işlemler için npx kullanmak çok daha modern ve temiz bir yöntemdir:
JavaScript:
npx create-react-app my-app
npx prettier --write .
npx, paketi kalıcı olarak kurmadan, anlık olarak indirip çalıştırmanıza olanak tanır.Komut Özet Tablosu
Günlük kullanımda sıklıkla başvuracağınız temel komutlar şunlardır:
JavaScript:
npm init -y # package.json oluştur
npm install # package.json'daki her şeyi yükle
npm install <pkg> # çalışma zamanı bağımlılığı ekle
npm install -D <pkg> # geliştirme bağımlılığı ekle
npm install -g <pkg> # CLI aracını global olarak yükle
npm uninstall <pkg> # bir bağımlılığı kaldır
npm outdated # neyin güncel olmadığını gör
npm update # izin verilen aralıklar içinde güncelle
npm install <pkg>@latest # en yeni sürüme geç
npm run <script> # package.json'dan bir script çalıştır
npx <pkg> # bir paketi yüklemeden çalıştır
npm'in sunduğu temel özellikler bunlardır. Yayınlama veya kapsamlı paket yönetimi gibi detaylar, zamanla ihtiyaç duydukça öğrenilebilir.
node_modules Hakkında Doğru Bilinenlernode_modules, projenin tüm bağımlılık zincirini tutan karmaşık bir yapıdır. Bir paket kurduğunuzda arka planda birçok alt paket inebilir, bu normal bir davranıştır. npm, aynı sürümdeki paketleri ortaklaştırarak verimlilik sağlar.package-lock.json dosyasının varlığı ise, farklı makinelerde birebir aynı proje yapısının kurulmasını garanti eder. Bu klasörün içeriğini asla elle düzenlemeyin; zira npm install komutu çalıştığı anda elle yaptığınız tüm değişiklikler silinecektir.Sırada:
package.jsonpackage.json, npm'in projenizi yönetmek için kullandığı kalbidir. Buradaki scripts, main veya engines gibi alanları detaylıca öğrenmek, geliştirme sürecinizi profesyonel seviyeye taşıyacaktır. Bir sonraki bölümde bu dosyayı inceleyeceğiz.Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)
Benzer konular
- Cevaplar
- 1
- Görüntüleme
- 30
- Cevaplar
- 1
- Görüntüleme
- 34
- Cevaplar
- 1
- Görüntüleme
- 33