npm Komutu: Node.js Paketleri Yükle ve Yönet

Giriş

Node.js projesi başlatırken veya klonlarken ilk adımlardan biri paketleri yüklemektir. npm, Node.js ile birlikte gelen varsayılan paket yöneticisidir. Bu araç, proje bağımlılıklarını eklemek, güncellemek, kaldırmak ve çalıştırmak için kullanılır. npm, projenizin gereksinimlerini kaydeden package.json dosyasını okur ve günceller.

Söz Dizimi

npm komutunun genel yapısı şu şekildedir:

npm <komut> [argümanlar] [seçenekler]

Node.js ve npm Kurulumu

npm, Node.js ile birlikte kurulur. Node.js yüklü değilse, Ubuntu 26.04'te Node.js kurulum talimatlarına bakın. Kurulumu doğrulamak için:

node --version
npm --version

Eğer npm bir sürüm döndürüyorsa, hazırsınız.

Proje Başlatma

Her npm projesinin merkezinde package.json dosyası bulunur. Bu dosya, proje bağımlılıklarını, betikleri, paket adı, sürüm ve diğer meta verileri içerir. Mevcut dizinde bir dosya oluşturmak için:

npm init

npm, bir dizi soru sorar (isim, sürüm, giriş noktası vb.) ve cevaplarınızı package.json dosyasına yazar. Tüm varsayılan değerleri kabul etmek için -y bayraklarını kullanın:

npm init -y

Bu, yeni bir proje için tipik başlangıç noktasıdır. package.json dosyası oluşturulduktan sonra, sonraki npm install komutları bağımlılıklarını kaydetmek için bir dosyaya sahiptir.

Paketleri Yükleme

Projenize bir paket eklemek için npm install komutunu paket adı ile kullanın:

npm install express

Bu, express paketini node_modules dizinine indirir ve onu package.json dosyası altında dependencies olarak kaydeder. npm ayrıca package-lock.json dosyasını oluşturur veya günceller, indirilen tam sürümleri kaydeder.

Paketleri Güncelleme ve Kaldırma

Paketleri güncellemek için npm update komutunu kullanın. Bir paketi kaldırmak için:

npm uninstall express

Global olarak yüklü bir paketi kaldırmak için -g bayraklarını kullanın:

sudo npm uninstall -g http-server

Betikleri Çalıştırma

package.json dosyasının scripts bölümünde adlı komutlar tanımlanabilir. Örneğin:

{
  "scripts": {
    "start": "node index.js",
    "test": "jest"
  }
}

Bir betiği çalıştırmak için:

npm run start

start ve test adları özeldir ve run olmadan çalıştırılabilir.

Yüklenmiş Paketleri Listeleme

Mevcut projedeki paketleri listelemek için:

npm list

Tam bağımlılık ağacını görüntülemek için --all bayrağını kullanın:

npm list --all

Paketi Yükleme Olmadan Çalıştırma

npx komutu, paketi kalıcı olarak yüklemeden bir paket binary'sini çalıştırmanıza izin verir. Örneğin:

npx prettier@latest --check .

Sıkça Sorulan Sorular

Bağımlılıklar ve devDependencies arasındaki fark nedir?
Bağımlılıklar, uygulamanızın çalışması için gereken paketlerdir. Geliştirme bağımlılıkları, sadece geliştirme aşamasında kullanılan paketlerdir (örneğin, test çerçeveleri ve linterlar).

Sonuç

npm, npm install, npm ci, npm update, npm uninstall ve npm run komutlarıyla Node.js projelerinde paket işlemlerinin çoğunu kapsar. package-lock.json dosyasını sürüm kontrolüne dahil edin ve CI veya dağıtımda npm ci kullanın.