Projenizi Kaybetmeden Mac’te node_modules Nasıl Silinir?

node_modules ile proje dosyalarını ayırın

node_modules, bir projenin kurulu bağımlılık ağacıdır ve uygun koşullarda yeniden oluşturulabilir. Silindiğinde yeniden kurulum tamamlanana kadar proje çalışmaz ve derlenmez. package.json, kilit dosyaları, kaynak kod, yapılandırma, yamalar, çalışma alanı dosyaları ve Git geçmişi ise yeniden oluşturmanın girdileridir; silinmemelidir. Varsayılan olarak ~/.npm altında bulunan ortak npm indirme önbelleği de node_modules’dan ayrı bir depolama kategorisidir: birini silmek diğerini kaldırmaz.

Bağımlılıkların gerçekten yeniden kurulabildiğini denetleyin

Kilit dosyası kurulumu öngörülebilir kılar ama paketlerin yedeği değildir. Depoda kullanılan paket yöneticisini ve sürümünü, özel registry erişimini, VPN’i, Git ve file: bağımlılıklarını, yerel çalışma alanlarını, harici indirmeleri ve yerel derleme araçlarını doğrulayın. npm v12 artık npm-shrinkwrap.json dosyasını okumaz: eski bir projede yetkili kilit dosyası buysa ve package-lock.json yoksa, aynı biçimdeki bu dosyayı package-lock.json olarak yeniden adlandırın; iki dosya da varsa hiçbirinin üzerine yazmadan hangisinin geçerli olduğunu inceleyin. Yalnızca node_modules içinde elle yaptığınız değişiklikler klasörle birlikte kaybolur ve package.json ya da kilit dosyasından geri gelmez.

1. Proje kökünde pwd ve du -sh ./node_modules çalıştırın; macOS’teki boş alanı da kaydedin.
2. package.json, doğru kilit dosyası, çalışma alanı yapılandırması ve yerel değişiklikleri denetleyin; eski projede yetkili dosya npm-shrinkwrap.json ise ve package-lock.json yoksa npm v12 kullanmadan önce dosyayı package-lock.json olarak yeniden adlandırın.
3. Özel registry’lere, Git ve file: bağımlılıklarına, yerel paketlere, harici indirmelere ve derleme araçlarına erişimi doğrulayın; node_modules’u kullanan süreçleri durdurun.
4. Yalnızca doğruladığınız node_modules klasörünü Çöp Sepeti’ne taşıyın ve doğru depo kökünde, sabitlenmiş paket yöneticisiyle kilit dosyasını değiştirmeyen bir yeniden kurulum yapın.
5. Derleme, test ve lint akışlarını çalıştırıp uygulamayı başlatın; alanı yeniden ölçün ve ancak bundan sonra Çöp Sepeti’ni boşaltın.

node_modules klasörünü bir paketin veya elle yaptığınız bir düzeltmenin tek kopyası olarak kullanmayın. Tam bağımlılık artık indirilemiyor ve başka bir yerde arşivlenmemişse silme işlemi eski projeyi yeniden kurulamaz hâle getirebilir.

Yalnızca doğrulanmış bağımlılık klasörünü kaldırın

Finder’da yalnızca hedef projenin node_modules klasörünü Çöp Sepeti’ne taşıyın; üstteki depo klasörünü seçmeyin. Terminal’deki rm -rf ./node_modules komutu Çöp Sepeti’ni atlar ve geri alınamaz; kullanacaksanız önce pwd ile proje kökünü yeniden doğrulayın. package-lock.json yetkiliyse aynı kökte npm ci çalıştırın; pnpm için pnpm install --frozen-lockfile, güncel Yarn için yarn install --immutable (Yarn Classic için yarn install --frozen-lockfile), Bun için bun install --frozen-lockfile kullanın. Monorepo’yu kök kilit dosyasıyla yönetilen tek bir bağımlılık sistemi olarak ele alın. AskClean ise onayladığınız klasörleri Çöp Sepeti’ne taşımaz, kalıcı olarak siler; geri dönüş payı istiyorsanız klasörü Finder’da kendiniz Çöp Sepeti’ne taşıyın.

Yeniden kurulumu ve projeyi bütünüyle doğrulayın

Kurulumun tamamlanması uygulamanın geri geldiğini tek başına kanıtlamaz. Belgelenmiş derleme, test, lint ve başlatma akışlarını çalıştırın; yerel olarak derlenen eklentiler ve yaşam döngüsü betikleri araç zinciri değiştiğinde yine hata verebilir. Kurtarma zaman ister: paketler indirilir, açılır, bağlantılar kurulur ve gerekirse derleme yapılır. İşlem başarısız olursa klasörü Çöp Sepeti’nden geri yükleyin; başka projeleri silmeden önce erişim, ağ, sürüm ve kilit dosyası sorununu tanılayın.

Silme sınırları ve kurtarma maliyetleri

Büyük node_modules klasörlerini bulun, kaynak kodu ve kilit dosyasını koruyun, bağımlılıkları proje proje silip npm, pnpm, Yarn veya Bun ile yeniden kurun.

SSS