Как безопасно очистить кэш Swift Package Manager

У SwiftPM несколько уровней

Пакет командной строки хранит checkout и продукты в .build, а SwiftPM поддерживает общий кэш репозиториев. Xcode может хранить продукты пакетов в DerivedData проекта. Очищайте самый узкий уровень, который объясняет проблему.

Выбирайте команду по области действия

swift package clean удаляет артефакты сборки текущего пакета. reset действует шире и пересоздаёт его локальное состояние. purge-cache затрагивает загрузки нескольких проектов, поэтому следующему разрешению зависимостей могут понадобиться сеть и дополнительное время.

1. Сохраните изменения и проверьте Package.swift и Package.resolved.
2. Запустите swift package clean в корне и соберите проект снова.
3. Используйте swift package reset лишь при сохраняющемся повреждении локального состояния.
4. Используйте swift package purge-cache только при подтверждённой проблеме общего кэша.
5. Проверьте граф зависимостей и тесты после очистки.

Запустите swift package --help: доступные подкоманды зависят от установленной версии Swift.

Сохраняйте файлы разрешения

Package.resolved фиксирует конкретные версии. Его удаление может выбрать другие допустимые версии и превратить очистку в обновление. Package.swift, Sources, Tests, плагины и локальные зависимости — исходники, их нельзя удалять как кэш.

Обрабатывайте Xcode отдельно

Если проблема видна только в Xcode, попробуйте File > Packages > Reset Package Caches и Resolve Package Versions либо удалите DerivedData конкретного проекта. Измерьте папки .build до глобальной очистки. AskClean находит категорию, но область задают команды Swift.

Частые вопросы