n1ro°
RU

Ошибки и коды · Инструкция

npm cache: когда использовать verify, а когда clean --force

npm cache — content-addressable хранилище с проверкой целостности, поэтому его полная очистка не является универсальным

Редакция N1RO · Проверено

Короткий ответ

Начинайте с `npm cache verify`: npm проверяет целостность cache и сам переиспользует или перекачивает данные. Полный `npm cache clean --force` нужен редко — главным образом для освобождения места или узкой диагностики.

Что делать

  1. Проверьте cache: Выполните `npm cache verify`: команда проверит индекс и целостность cached data.
  2. Проверьте расположение: Используйте `npm config get cache`, чтобы увидеть каталог cache и оценить его размер средствами ОС.
  3. Повторите исходную ошибку: Если verify успешен, снова запустите install; ERESOLVE, 401/403 и engine mismatch нужно диагностировать отдельно.
  4. Очищайте только при причине: Для полной очистки используйте `npm cache clean --force`, когда нужно освободить место или исключить cache из конкретной диагностики.
  5. Не делайте clean постоянным шагом: Если после очистки ошибка возвращается, ищите registry/network/package/config причину вместо повторного удаления cache.

Важно

`npm cache clean --force` не исправляет dependency resolution, auth или несовместимый Node engine; сначала диагностируйте исходную ошибку.

Что учитывать

`npm cache clean --force` не исправляет dependency resolution, auth или несовместимый Node engine; сначала диагностируйте исходную ошибку.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. npm cache). Пример и формулировки — редакция N1RO на 2026-09-17.