cargo clean: как очистить кэш Cargo на Mac

Что удаляет cargo clean

Каждый проект Cargo собирается в свою папку target рядом с Cargo.toml: скомпилированные зависимости, отладочные и релизные сборки, документация, данные инкрементальной сборки. Всё это Cargo заново соберёт из вашего кода и скачанных крейтов, так что удаление стоит только времени на сборку.

Эта команда показывает, что и сколько будет удалено, ничего не удаляя. Выполните её в папке проекта:

Как выполнить cargo clean

Эта команда удаляет всю папку target проекта, в котором вы находитесь. Код, Cargo.toml, Cargo.lock и кэш Cargo остаются. Следующий cargo build скомпилирует всё заново, а на большом проекте это минуты:

Чтобы удалить меньше, cargo clean --release убирает только релизную сборку, а cargo clean --doc — только документацию, созданную cargo doc. В рабочем пространстве (workspace) одна команда чистит все его проекты.

Удалить папки target старых проектов

Проект хранит папку target годами после последней сборки. Проекты, с которыми вы больше не работаете, — самое простое место, которое можно освободить: выполните в каждом cargo clean или переместите его папку target в Корзину. Код останется, а следующая сборка создаст папку снова.

Как очистить кэш Cargo

Скачанные крейты Cargo хранит в ~/.cargo, общей для всех проектов:

• ~/.cargo/registry/index — сведения о крейтах: их версии и зависимости.
• ~/.cargo/registry/cache — скачанные крейты в виде архивов .crate.
• ~/.cargo/registry/src — те же крейты, распакованные для компилятора.
• ~/.cargo/git/db и ~/.cargo/git/checkouts — зависимости, взятые из Git-репозиториев.

Стабильной команды, которая очищает всё это, у Cargo нет. В документации Cargo сказано, что любую часть кэша можно удалить: нужное для сборки Cargo снова распакует или скачает. Чтобы очистить кэш вручную:

1. Закройте редактор кода и дождитесь окончания сборок.
2. В Finder выберите Переход › Переход к папке (Shift-Command-G), введите ~/.cargo/registry и нажмите Return.

3. Переместите папки cache и src в Корзину. Чтобы очистить и зависимости из Git, так же откройте ~/.cargo/git и переместите в Корзину checkouts и db.

4. Очистите Корзину.

Не удаляйте ~/.cargo/bin: там лежат cargo, rustc и инструменты, установленные через cargo install. Оставьте и ~/.cargo/config.toml: это настройки Cargo, а не кэш.

Чистит ли Cargo кэш сам

Отчасти, начиная с Rust 1.88. Во время сборок Cargo удаляет из ~/.cargo файлы, которыми давно не пользовался: скачанные — через 3 месяца, те, что можно создать заново без интернета, — через месяц. Старые папки target сами не чистятся: они остаются, пока вы не выполните cargo clean или не удалите их.

cargo-cache — сторонний инструмент, который упоминает документация Cargo: он показывает размер каждой части кэша и очищает выбранные. Встроенная команда cargo clean gc пока есть только в nightly-версии Rust.