Cara mengosongkan cache npm pada Mac dengan selamat

Asingkan cache, kebergantungan yang dipasang dan projek

Cache npm menyimpan muat turun yang boleh digunakan semula oleh banyak projek dan secara lalai berada di ~/.npm pada macOS, walaupun konfigurasi boleh memindahkannya. Folder node_modules pula ialah pepohon kebergantungan yang dipasang untuk satu projek, dan mengosongkan cache tidak membuangnya. Fail package.json dan package-lock.json ialah fail projek, bukan cache. Fail npm-shrinkwrap.json juga bukan cache, tetapi npm v12 tidak lagi membacanya; projek lama mesti menamakan semula fail yang berformat sama itu sebagai package-lock.json sebelum pemasangan semula dengan npm v12.

Ukur cache aktif dan sahkan terlebih dahulu

Jangan anggap ~/.npm sebagai cache aktif hanya kerana folder itu wujud. npm config get cache menunjukkan laluan bagi tetapan semasa; catat npm --version, ukur laluan yang dicetak dengan du -sh dan rekod ruang kosong macOS. npm cache verify menyemak indeks dan data, mengesahkan integriti serta membuang data yang tidak diperlukan tanpa membuang muat turun yang sah. Bagi penyelenggaraan rutin, pengesahan ini biasanya sudah memadai; bagi ralat pemasangan, cuba semula perintah asal sekali dan bandingkan ralatnya, kerana masalah kelayakan registry, proksi atau versi tidak dibaiki dengan membuang muat turun yang sah.

1. Jalankan npm --version dan npm config get cache; pastikan hasilnya ialah laluan cache, bukan folder projek.
2. Ukur laluan tepat yang dicetak dengan du -sh dan catat ruang kosong macOS tanpa mengubah package.json atau lockfile.
3. Hentikan npm install, npm ci, npm exec dan proses penerbitan; jalankan npm cache verify dan simpan ringkasan serta ralatnya.
4. Jalankan npm cache clean --force hanya jika npm cache verify tidak mencukupi, ruang yang diperoleh bermakna dan semua artifak yang diperlukan masih tersedia.
5. Jalankan npm cache verify sekali lagi, ukur laluan yang sama, kemudian jalankan perintah binaan dan ujian bagi projek wakil tanpa mengubah lockfile.

Jangan sekali-kali masukkan laluan yang belum disahkan ke dalam rm -rf. Jangan juga gabungkan pembersihan cache dengan pemadaman atau penciptaan semula lockfile; dua perubahan serentak menghapuskan perbandingan yang diperlukan untuk mendiagnosis ralat.

Gunakan npm cache clean --force dengan sengaja

Jalankan npm cache clean --force hanya apabila cache yang diukur memang besar, ruang diperlukan sekarang dan artifak boleh dimuat turun semula. Perintah ini membersihkan cache yang dikonfigurasi — bukan node_modules, package.json atau lockfile — dan npm akan mencipta semula cache apabila perlu. Pemasangan seterusnya mungkin lebih perlahan atau gagal ketika luar talian; registry persendirian, pelayan Git, proksi, kelayakan serta pakej yang telah ditarik balik meningkatkan kos pemulihan. Gunakan --force hanya pada perintah ini; jangan jadikan force tetapan npm yang kekal kerana ia turut melonggarkan perlindungan bagi operasi lain.

Sahkan hasil tanpa mengubah kebergantungan

Selepas pembersihan, jalankan npm config get cache sekali lagi, ukur lokasi yang sama dan bandingkan ruang kosong sebenar pada macOS. Uji satu projek wakil dengan package.json serta lockfile yang tidak diubah, kemudian jalankan perintah binaan dan ujiannya. Jika ralat lama berulang, jangan ulang pemadaman: ERESOLVE, kelayakan akses, 404, proksi, sijil, keperluan versi Node.js, binaan natif dan skrip kitar hayat memerlukan diagnosis lain. AskClean mengenali ~/.npm lalai sebagai satu cache bersama dan memadam item yang anda sahkan secara kekal; laluan cache tersuai masih perlu disemak melalui npm.

Sempadan pemadaman dan kos pemulihan

Cari dan ukur cache muat turun yang digunakan oleh npm pada Mac, sahkan dahulu dan kosongkan hanya apabila perlu tanpa menyentuh node_modules atau fail projek.

Soalan lazim