yarn cache clean: local cache и global mirror

Что важно знать про yarn cache clean

Команда без флагов удаляет local cache archives, связанные с текущим проектом. --mirror переключает очистку на global cache/mirror в ~/.yarn, а --all удаляет оба вида cache. После очистки следующая установка может снова обращаться к сети, поэтому cache clean не стоит использовать как рутинный шаг каждого CI run без причины.

Совет: Практический совет: Запустить yarn cache clean для локальных archives либо добавить --mirror для глобального cache.

Как выполнить задачу: очистить local cache и global mirror выборочно

1. 1. Определить, какой cache подозревается: project-local или global mirror.
2. 2. Запустить yarn cache clean для локальных archives либо добавить --mirror для глобального cache.
3. 3. Использовать --all только когда осознанно нужно очистить оба уровня.
4. 4. После очистки выполнить yarn install и наблюдать, скачиваются ли пакеты корректно.
5. 5. Если checksum-проблема возвращается, проверить lockfile, registry/proxy и источник пакета, а не повторять clean бесконечно.

Предупреждение: Осторожно: Не очищать глобальный cache на общей CI-машине без понимания влияния на другие jobs.

Практическая проверка: очистить local cache и global mirror выборочно

В терминале сначала определить, какой cache подозревается: project-local или global mirror и сохраните вывод команды. Затем запустить yarn cache clean для локальных archives либо добавить --mirror для глобального cache; после этого не меняйте package.json, lockfile или CI-конфигурацию несколькими способами сразу. Шаг «использовать --all только когда осознанно нужно очистить оба уровня» должен дать проверяемый вывод: путь зависимости, список workspaces, audit report, checksum или расшифровку кода — в зависимости от команды. Если действует ограничение «не очищать глобальный cache на общей ci-машине без понимания влияния на другие jobs», остановите автоматическую правку и разберите причину.

Контрольные точки: очистить local cache и global mirror выборочно

• Старт. Определить, какой cache подозревается: project-local или global mirror. Получить корректную базу сравнения
• Изменение. Запустить yarn cache clean для локальных archives либо добавить --mirror для глобального cache. Проверить шаг для задачи «очистить local cache и global mirror выборочно»
• Контроль. Если checksum-проблема возвращается, проверить lockfile, registry/proxy и источник пакета, а не повторять clean бесконечно. Подтвердить результат задачи «очистить local cache и global mirror выборочно»

Ошибки при задаче «очистить local cache и global mirror выборочно»

Не очищать глобальный cache на общей CI-машине без понимания влияния на другие jobs. Не считать cache clean исправлением повреждённого lockfile. Не удалять .yarn/cache вручную, если проект использует Zero-Installs и эти файлы отслеживаются Git.

Важно: Важно: Не считать cache clean исправлением повреждённого lockfile.

Чек-лист: очистить local cache и global mirror выборочно

• Исходная точка зафиксирована: определить, какой cache подозревается: project-local или global mirror.
• Ключевое действие выполнено отдельно: запустить yarn cache clean для локальных archives либо добавить --mirror для глобального cache.
• Финальная проверка пройдена: если checksum-проблема возвращается, проверить lockfile, registry/proxy и источник пакета, а не повторять clean бесконечно.
• Для «очистить local cache и global mirror выборочно» путь и ограничения сверены с «yarn cache clean» (Yarn).

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

Команда без флагов удаляет local cache archives, связанные с текущим проектом. --mirror переключает очистку на global cache/mirror в ~/.yarn, а --all удаляет оба вида cache. После очистки следующая установка может снова обращаться к сети, поэтому cache clean не стоит использовать как рутинный шаг каждого CI run без причины.

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

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

• yarn cache clean