Como remover completamente o Rust instalado via rustup: guia passo a passo

Adeus, Rust? Ou apenas "até logo"?

Você instalou o Rust via rustup — testou, experimentou, escreveu alguns programas. Mas a vida de um desenvolvedor é imprevisível: talvez o projeto migrou para outra stack, ou você só quer liberar espaço no disco. Ou quem sabe você quebrou o toolchain acidentalmente e decidiu começar do zero. Seja como for, a pergunta "como remover o Rust instalado via rustup" aparece milhares de vezes nos mecanismos de busca. E não é à toa: o processo não é tão óbvio quanto desinstalar um programa comum.

Neste artigo, vamos abordar não apenas o comando básico rustup self uninstall, mas também ir mais fundo: como verificar o que sobrou após a remoção, como remover apenas uma versão específica do compilador e o que fazer se você mudar de ideia e quiser tudo de volta. Prepare-se: será interessante, útil e com exemplos de código reais.

O que é o rustup e por que removê-lo não é "só apagar a pasta"?

Antes de apertar Delete, vamos entender o que é o rustup. Ele não é apenas um gerenciador de pacotes — é um instalador e gerenciador de toolchains para Rust. Ele gerencia versões do compilador rustc, do gerenciador de build cargo, da documentação e da biblioteca padrão. Quando você instala o Rust via rustup, ele cria:

\n
• O diretório ~/.rustup — onde ficam todos os toolchains (stable, nightly, beta) e ferramentas.
\n
• O diretório ~/.cargo — cache de pacotes, binários instalados via cargo install e configurações.
\n
• Entradas no PATH (geralmente em ~/.bashrc, ~/.zshrc ou ~/.profile).
\n

Simplesmente apagar a pasta ~/.rustup deixará resíduos e pode quebrar seu terminal. Por isso, o caminho correto é usar a ferramenta embutida rustup.

Método 1: Remoção completa com rustup self uninstall (recomendado)

A maneira mais simples e confiável é executar o comando rustup self uninstall. Ele fará todo o trabalho pesado para você:

rustup self uninstall

Após a execução, você verá um diálogo de confirmação:

Are you sure you want to uninstall Rust? (y/N) y\ninfo: removing rustup home\ninfo: removing cargo home\ninfo: removing rustup binaries\ninfo: done. Rust has been uninstalled.

O que acontece nos bastidores:

\n
• A pasta ~/.rustup com todos os toolchains é removida.
\n
• A pasta ~/.cargo é removida (atenção: junto com projetos que você colocou lá e binários instalados!).
\n
• Os links simbólicos para rustup, rustc, cargo em ~/.cargo/bin são removidos.
\n
• O comando não altera os arquivos de configuração do shell (bashrc/zshrc). Você precisa remover manualmente a linha source $HOME/.cargo/env ou export PATH="$HOME/.cargo/bin:$PATH".
\n

Importante: Se você instalou binários via cargo install (por exemplo, ripgrep, bat, fd), eles também serão removidos. Salve a lista deles se planeja reinstalar:

cargo install --list > installed_crates.txt

Método 2: Remover apenas um toolchain específico (sem desinstalar o Rust completamente)

Se você não quer remover o Rust por inteiro, mas apenas se livrar de uma versão específica (por exemplo, uma build nightly desatualizada), use o comando rustup toolchain remove:

rustup toolchain remove nightly-2023-01-01

Para verificar quais toolchains estão instalados, use:

rustup toolchain list

A saída pode ser algo como:

stable-x86_64-unknown-linux-gnu (default)\nnightly-x86_64-unknown-linux-gnu\n1.70.0-x86_64-unknown-linux-gnu