Projenizi kaybetmeden Mac’te node_modules nasıl silinir
AskClean Ekibi · Güncellendi 2026-08-05
package.json, doğru kilit dosyası ve gereken tüm bağımlılık kaynakları hâlâ erişilebiliyorsa node_modules silinebilir. Önce her projeyi ölçün, çalışan süreçleri durdurun ve yalnızca doğruladığınız bağımlılık klasörünü Çöp Kutusu’na taşıyın. Aynı paket yöneticisiyle yeniden kurup derleme, test ve uygulama kontrolleri başarıyla tamamlanmadan Çöp Kutusu’nu boşaltmayın.
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 veya derlenmez. package.json, kilit dosyaları, kaynak kod, yapılandırma, yamalar, çalışma alanı dosyaları ve Git geçmişi yeniden oluşturma girdileridir; silinmemelidir. Varsayılan olarak ~/.npm altında bulunan ortak npm indirme önbelleği de node_modules’dan ayrı bir depolama kategorisidir.
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 paket kaydı 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 projede yetkili kilit dosyası buysa ve package-lock.json yoksa aynı biçimdeki 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 duran elle yapılmış değişiklikler silmeyle kaybolur.
- Proje kökünde pwd ve du -sh ./node_modules çalıştırın; macOS’teki boş alanı da kaydedin.
- 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.
- Özel paket kayıtlarına, Git ve file: bağımlılıklarına, yerel paketlere, harici indirmelere ve derleme araçlarına erişimi doğrulayıp node_modules kullanan süreçleri durdurun.
- Yalnızca doğruladığınız node_modules klasörünü Çöp Kutusu’na taşıyın ve doğru depo kökünde, sabitlenmiş paket yöneticisiyle kilit dosyasına bağlı yeniden kurulum yapın.
- Derleme, test ve lint akışlarını çalıştırıp uygulamayı başlatın; alanı yeniden ölçün ve ancak bundan sonra Çöp Kutusu’nu boşaltın.
node_modules klasörünü bir paketin veya elle yaptığınız düzeltmenin tek kopyası olarak kullanmayın. Tam bağımlılık artık indirilemiyor ve başka 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 Kutusu’na taşıyın; üstteki depo klasörünü seçmeyin. rm -rf ./node_modules Çöp Kutusu’nu 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 --frozen-lockfile), Bun için bun install --frozen-lockfile kullanın. Monorepo’yu kök kilit dosyasından yönetilen tek bir bağımlılık sistemi olarak ele alı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; paketleri indirme, açma, bağlantıları kurma ve gerekirse derleme süresi gerektirir. İşlem başarısızsa klasörü Çöp Kutusu’ndan 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 bazında kaldırıp npm, pnpm, Yarn veya Bun ile güvenle yeniden kurun.
| Öğe veya işlem | Nerede ya da neyle denetlenir | Sonuç |
|---|---|---|
| node_modules ile proje dosyalarını ayırın | <proje>/node_modules | 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 veya derlenmez. package.json, kilit dosyaları, kaynak kod, yapılandırma, yamalar, çalışma alanı dosyaları ve Git geçmişi yeniden oluşturma girdileridir; silinmemelidir. Varsayılan olarak ~/.npm altında bulunan ortak npm indirme önbelleği de node_modules’dan ayrı bir depolama kategorisidir. |
| Bağımlılıkların gerçekten yeniden kurulabildiğini denetleyin | package.json + kilit dosyası + çalışma alanı yapılandırması | 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 paket kaydı 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 projede yetkili kilit dosyası buysa ve package-lock.json yoksa aynı biçimdeki 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 duran elle yapılmış değişiklikler silmeyle kaybolur. |
| Yalnızca doğrulanmış bağımlılık klasörünü kaldırın | Çöp Kutusu / paket yöneticisiyle yeniden kurulum | Finder’da yalnızca hedef projenin node_modules klasörünü Çöp Kutusu’na taşıyın; üstteki depo klasörünü seçmeyin. rm -rf ./node_modules Çöp Kutusu’nu 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 --frozen-lockfile), Bun için bun install --frozen-lockfile kullanın. Monorepo’yu kök kilit dosyasından yönetilen tek bir bağımlılık sistemi olarak ele alın. |
| Yeniden kurulumu ve projeyi bütünüyle doğrulayın | derleme + test + uygulamayı başlatma | 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; paketleri indirme, açma, bağlantıları kurma ve gerekirse derleme süresi gerektirir. İşlem başarısızsa klasörü Çöp Kutusu’ndan geri yükleyin; başka projeleri silmeden önce erişim, ağ, sürüm ve kilit dosyası sorununu tanılayın. |
SSS
Mac’te node_modules silmek güvenli mi?
Genellikle evet; package.json, doğru kilit dosyası, çalışma alanı dosyaları, kaynak kod ve tüm bağımlılık kaynakları korunuyorsa yeniden oluşturulabilir. Ancak yeniden kurulum ve proje kontrolleri bitene kadar proje çalışmaz.
package-lock.json dosyasını node_modules ile birlikte silmeli miyim?
Hayır. package-lock.json, yeniden üretilebilir npm kurulumunun girdisidir. npm v12 artık npm-shrinkwrap.json dosyasını okumaz. Eski projede yetkili kilit dosyası yalnızca buysa package-lock.json olarak yeniden adlandırın; var olan bir package-lock.json dosyasının üzerine yazmayın.
node_modules ile npm önbelleği aynı şey mi?
Hayır. node_modules tek bir projenin kurulu bağımlılık ağacıdır; npm’in ortak önbelleği varsayılan olarak ~/.npm altındadır. Birini silmek diğerini kaldırmaz ve kurtarma maliyetleri farklı kapsamlara yayılır.
Kaynaklar