Mac’te npm önbelleği nasıl güvenle temizlenir
AskClean Ekibi · Güncellendi 2026-08-05
Etkin önbelleği npm config get cache ile bulun, tam olarak bu yolu ölçün ve silmeden önce npm cache verify çalıştırın. npm cache clean --force komutunu yalnızca disk alanına gerçekten ihtiyacınız varsa ve sonraki indirmelerin maliyetini kabul ediyorsanız kullanın. node_modules, package.json ve kilit dosyanız önbellek değildir; değişmeden kalmalıdır.
npm önbelleğini kurulu bağımlılıklardan ve proje dosyalarından ayırın
npm önbelleği birden çok proje için yeniden kullanılabilir indirmeleri saklar ve macOS’te varsayılan olarak ~/.npm altındadır; ancak yapılandırmayla başka yere taşınabilir. node_modules ise tek bir projenin kurulu bağımlılık ağacıdır. package.json ve package-lock.json proje durumudur, önbellek değildir. npm-shrinkwrap.json da önbellek değildir; npm v12 artık bu dosyayı okumaz. Eski projede yetkili kilit dosyası buysa ve package-lock.json yoksa aynı biçimdeki dosyayı yeniden adlandırın; var olan package-lock.json dosyasının üzerine yazmayın.
Etkin önbelleği ölçün ve önce doğrulayın
Mevcut olması ~/.npm yolunun etkin önbellek olduğunu kanıtlamaz. npm config get cache, o yapılandırmanın kullandığı yolu verir; du ile tam bu yolu ölçüp boş alanı kaydedin. npm cache verify dizini ve içeriği denetler, bütünlüğü doğrular ve geçerli indirmeleri topluca atmadan gereksiz verileri temizler. Olağan bakımda veya önbellekle ilgisiz bir kurulum hatasında bu işlem çoğu zaman yeterlidir.
- npm --version ve npm config get cache çalıştırın; dönen yolun proje klasörü değil önbellek olduğunu doğrulayın.
- Tam olarak bu yolu du -sh ile ölçüp macOS’teki boş alanı kaydedin; package.json ile kilit dosyalarını değiştirmeyin.
- Çalışan npm install, npm ci, npm exec ve yayımlama süreçlerini durdurun; npm cache verify çalıştırıp özet ile hataları saklayın.
- Yalnızca verify yeterli olmadığında, kazanılacak alan anlamlıysa ve gereken tüm paketler yeniden alınabilecekse npm cache clean --force çalıştırın.
- npm cache verify komutunu yeniden çalıştırın, aynı yolu ölçün ve değişmemiş kilit dosyasıyla örnek bir projenin derleme ve testlerini doğrulayın.
Doğrulanmamış bir yolu asla rm -rf komutuna vermeyin. Önbellek temizliğini kilit dosyasını silme veya yeniden üretmeyle birleştirmeyin; iki değişkeni birden değiştirir ve hatanın kaynağını karşılaştırma olanağını kaybedersiniz.
npm cache clean --force komutunu bilinçli kullanın
npm cache clean --force yalnızca ölçülen önbellek anlamlı büyüklükteyse, disk alanına şimdi ihtiyacınız varsa ve paketler sonradan yeniden alınabiliyorsa çalıştırılmalıdır. Komut yapılandırılmış önbelleği temizler; node_modules veya kilit dosyalarını silmez. Sonraki npm install ve npm ci işlemleri daha uzun sürebilir ya da çevrimdışı ortamda başarısız olabilir; özel paket kayıtları, Git sunucuları, proxy’ler ve artık yayımlanmayan paketler kurtarma maliyetini artırır. force ayarını npm yapılandırmasında kalıcı yapmayın.
Bağımlılık grafiğini değiştirmeden sonucu doğrulayın
Temizlikten sonra önbellek yolunu yeniden alın, aynı konumu ölçün ve macOS’in gerçekten kazandığı boş alanı karşılaştırın. package.json ile kilit dosyasını değiştirmeden örnek bir projenin kurulumunu, derlemesini ve testlerini çalıştırın. İlk hata geri gelirse önbelleği tekrar tekrar silmeyin: ERESOLVE, eksik kimlik doğrulama, 404, proxy veya sertifika sorunları, Node.js sürüm koşulları, yerel derlemeler ve yaşam döngüsü betikleri ayrı ayrı tanılanmalıdır. AskClean varsayılan ~/.npm yolunu tanır; özel yolları npm ile denetleyin.
Silme sınırları ve kurtarma maliyetleri
npm’in gerçekten kullandığı indirme önbelleğini bulup ölçün ve önce doğrulayın; node_modules ile proje dosyalarına dokunmadan yalnızca gerekçesi varsa temizleyin.
| Öğe veya işlem | Nerede ya da neyle denetlenir | Sonuç |
|---|---|---|
| npm önbelleğini kurulu bağımlılıklardan ve proje dosyalarından ayırın | npm config get cache | npm önbelleği birden çok proje için yeniden kullanılabilir indirmeleri saklar ve macOS’te varsayılan olarak ~/.npm altındadır; ancak yapılandırmayla başka yere taşınabilir. node_modules ise tek bir projenin kurulu bağımlılık ağacıdır. package.json ve package-lock.json proje durumudur, önbellek değildir. npm-shrinkwrap.json da önbellek değildir; npm v12 artık bu dosyayı okumaz. Eski projede yetkili kilit dosyası buysa ve package-lock.json yoksa aynı biçimdeki dosyayı yeniden adlandırın; var olan package-lock.json dosyasının üzerine yazmayın. |
| Etkin önbelleği ölçün ve önce doğrulayın | npm cache verify | Mevcut olması ~/.npm yolunun etkin önbellek olduğunu kanıtlamaz. npm config get cache, o yapılandırmanın kullandığı yolu verir; du ile tam bu yolu ölçüp boş alanı kaydedin. npm cache verify dizini ve içeriği denetler, bütünlüğü doğrular ve geçerli indirmeleri topluca atmadan gereksiz verileri temizler. Olağan bakımda veya önbellekle ilgisiz bir kurulum hatasında bu işlem çoğu zaman yeterlidir. |
| npm cache clean --force komutunu bilinçli kullanın | npm cache clean --force | npm cache clean --force yalnızca ölçülen önbellek anlamlı büyüklükteyse, disk alanına şimdi ihtiyacınız varsa ve paketler sonradan yeniden alınabiliyorsa çalıştırılmalıdır. Komut yapılandırılmış önbelleği temizler; node_modules veya kilit dosyalarını silmez. Sonraki npm install ve npm ci işlemleri daha uzun sürebilir ya da çevrimdışı ortamda başarısız olabilir; özel paket kayıtları, Git sunucuları, proxy’ler ve artık yayımlanmayan paketler kurtarma maliyetini artırır. force ayarını npm yapılandırmasında kalıcı yapmayın. |
| Bağımlılık grafiğini değiştirmeden sonucu doğrulayın | kurulum + çevrimdışı/özel paket kaydı denetimi | Temizlikten sonra önbellek yolunu yeniden alın, aynı konumu ölçün ve macOS’in gerçekten kazandığı boş alanı karşılaştırın. package.json ile kilit dosyasını değiştirmeden örnek bir projenin kurulumunu, derlemesini ve testlerini çalıştırın. İlk hata geri gelirse önbelleği tekrar tekrar silmeyin: ERESOLVE, eksik kimlik doğrulama, 404, proxy veya sertifika sorunları, Node.js sürüm koşulları, yerel derlemeler ve yaşam döngüsü betikleri ayrı ayrı tanılanmalıdır. AskClean varsayılan ~/.npm yolunu tanır; özel yolları npm ile denetleyin. |
SSS
Mac’te npm cache clean --force çalıştırmak güvenli mi?
npm doğru önbelleğe işaret ediyorsa kaynak kod ve proje dosyaları için güvenlidir; ancak yeniden kullanılabilir indirmeleri atar. Önce ölçüp doğrulayın, çalışan npm süreçlerini durdurun ve sonraki kurulumlarda ağ gerekeceğini hesaba katın.
Önce npm cache verify mı, npm cache clean mi çalıştırmalıyım?
Her zaman önce npm cache verify çalıştırın. Geçerli önbellek içeriğini korurken bütünlüğü denetler ve gereksiz verileri temizler. clean --force yalnızca ölçülmüş bir disk alanı gereksinimi veya doğrulanmış bir önbellek sorunu içindir.
npm önbelleğini temizlemek package-lock.json dosyasını siler mi?
Hayır. package.json ve package-lock.json proje dosyalarıdır. npm v12 npm-shrinkwrap.json dosyasını okumaz. Eski projede yetkili kilit dosyası yalnızca buysa silmek yerine package-lock.json olarak yeniden adlandırın; var olan bir package-lock.json dosyasını ezmeyin.
Kaynaklar