Não entre em pânico: «No default toolchain configured» no Rust — solução

Introdução: A dor familiar de todo iniciante em Rust

Você acabou de instalar o Rust, seguindo as instruções do site oficial, abre o terminal e, com o coração na mão, digita rustc --version. E então — puf! — em vez de uma bela linha com o número da versão, você vê um texto frio e assustador: «No default toolchain configured after installing rustup».

Familiar? Se sim, você não está sozinho. Esta pergunta no Stack Overflow acumulou milhares de visualizações e dezenas de comentários. Mas não entre em pânico e saia apagando tudo. Neste artigo, vamos entender o que é toolchain, por que o rustup não consegue encontrá-lo e, o mais importante, como corrigir isso de uma vez por todas. Vamos percorrer o caminho do zero absoluto até um ambiente de desenvolvimento Rust funcional.

Pronto? Vamos lá!

O que é toolchain e por que o rustup «esquece» dele?

Antes de mergulhar nos detalhes, vamos entender os conceitos. Toolchain (cadeia de ferramentas) é um conjunto de ferramentas necessárias para compilar e construir código em Rust. Ele inclui:

\n
• rustc — o próprio compilador;
\n
• cargo — gerenciador de pacotes e sistema de build;
\n
• rust-std — a biblioteca padrão;
\n
• E outros componentes (por exemplo, clippy para linting).
\n

Rustup é o instalador oficial e gerenciador de versões do Rust. Ele permite alternar entre diferentes versões do compilador: estável (stable), noturna (nightly) e de teste (beta). Quando você digita rustup install stable, o rustup baixa o toolchain correspondente e o salva no disco.

O erro «No default toolchain configured» ocorre quando o rustup não consegue determinar qual versão do toolchain usar por padrão. É como se você chegasse a uma biblioteca, mas não soubesse qual livro ler primeiro. O rustup simplesmente não sabe qual compilador executar.

As causas podem ser variadas:

\n
• Você acabou de instalar o rustup, mas não instalou nenhum toolchain;
\n
• A instalação foi interrompida devido a problemas de rede;
\n
• Você removeu o toolchain manualmente;
\n
• Problemas de permissão de acesso à pasta ~/.rustup.
\n

Diagnóstico: verificando o estado atual

Antes de corrigir qualquer coisa, vamos ver o que temos. Abra o terminal e execute o comando:

rustup show

Você deve ver algo assim (se estiver tudo errado):

Default host: x86_64-unknown-linux-gnu\nrustup home:  /home/user/.rustup\n\ninstalled toolchains\n--------------------\n\nactive toolchain\n----------------\n(no active toolchain)

Observe a linha «no active toolchain». Esta é a raiz do problema. Vamos corrigir isso.

Solução nº 1: Instalação e configuração do default toolchain

A maneira mais simples e comum é instalar explicitamente o toolchain estável e defini-lo como versão padrão.

Execute no terminal:

rustup install stable

Este comando baixará e instalará a versão estável mais recente do Rust. O processo pode levar algum tempo (geralmente de 1 a 3 minutos, dependendo da velocidade da internet).

Após a conclusão da instalação, você precisa «vincular» este toolchain como a versão padrão:

rustup default stable

Agora verifique o resultado:

rustup show

Você deve ver um toolchain ativo. Também pode verificar o compilador:

rustc --version

Se você vir algo como rustc 1.78.0 (9b00956e5 2024-04-29) — parabéns, o problema está resolvido!

Solução nº 2: Usando o nightly toolchain (para experimentadores)

Às vezes, você pode precisar da versão noturna do compilador, por exemplo, para