Lição 2 de 18 · 15 min
Instalando o Rust
Como instalar o Rust com o rustup no Linux, macOS e Windows, conferir a instalação, manter tudo atualizado e escolher um editor.
Ao terminar, você vai saber:
- Instalar o Rust com o rustup no seu sistema
- Conferir a instalação com rustc e cargo
- Atualizar o Rust com rustup update
- Preparar o VS Code com o rust-analyzer
- Usar o Rust Playground quando não puder instalar nada
O jeito oficial de instalar o Rust é pelo rustup. Ele é o instalador e também o gerente do Rust na sua máquina: baixa o compilador (rustc), o Cargo, a documentação e mantém tudo atualizado. Evite instalar o Rust pelo gerenciador de pacotes do sistema (como apt), porque costuma vir uma versão antiga e sem o rustup para atualizar.
Linux e macOS
Abra o terminal e rode:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Esse comando baixa o script de instalação pelo site oficial e executa. Ele vai mostrar um resumo e perguntar como você quer instalar. Na dúvida, aperte Enter para escolher a opção padrão.
No fim, o instalador avisa que adicionou a pasta ~/.cargo/bin ao seu PATH (a lista de pastas onde o terminal procura comandos). Para o terminal atual enxergar a mudança, rode:
source "$HOME/.cargo/env"
Ou simplesmente feche e abra o terminal de novo.
Falta um linker?
Para gerar o programa final, o Rust precisa de um linker, a peça que junta tudo num executável. No Linux ele costuma vir com o compilador C. Se aparecer um erro dizendo que cc não foi encontrado, instale as ferramentas de compilação:
# Ubuntu, Debian, Mint
sudo apt install build-essential
# Fedora
sudo dnf install gcc
No macOS, o comando abaixo instala as ferramentas de linha de comando da Apple, que trazem o linker:
xcode-select --install
Windows
No Windows o caminho é um pouco diferente:
- Entre em rustup.rs e baixe o
rustup-init.exe(a versão de 64 bits serve para quase todo mundo). - Rode o arquivo. Se o instalador avisar que faltam as Build Tools do Visual Studio, aceite a instalação. Elas trazem o linker da Microsoft, que o Rust usa no Windows.
- Se for instalar as Build Tools na mão, marque a opção Desenvolvimento para desktop com C++ no instalador do Visual Studio.
- Volte ao
rustup-init.exee siga com a opção padrão.
Depois, abra um terminal novo (PowerShell ou Prompt de Comando) para que ele carregue o PATH atualizado.
Quem usa WSL (o Linux dentro do Windows) pode seguir as instruções de Linux dentro do WSL.
Conferindo se deu certo
Com o terminal aberto, rode:
rustc --version
cargo --version
Cada comando deve responder com uma linha mostrando o número da versão e uma data. Se aparecer algo como “comando não encontrado”, quase sempre é o PATH: feche e abra o terminal, ou rode o source mostrado acima.
Outro comando útil é este, que mostra o que o rustup instalou:
rustup show
Mantendo tudo atualizado
O Rust lança uma versão nova a cada seis semanas. As atualizações são tranquilas: o time leva muito a sério não quebrar código que já funciona. Para atualizar, basta:
rustup update
Faça isso de vez em quando, tipo quem atualiza os apps do celular. Se um dia quiser desinstalar tudo, existe rustup self uninstall.
Documentação offline
O rustup instala junto a documentação oficial, incluindo o livro “The Rust Programming Language”. Para abrir no navegador, mesmo sem internet:
rustup doc
Ótimo para consultar no ônibus ou naquele lugar onde o Wi-Fi não pega.
Escolhendo um editor
Qualquer editor de texto serve, mas a experiência melhora muito com um que entenda Rust. A opção mais comum é o VS Code com a extensão rust-analyzer:
- Instale o VS Code.
- Na aba de extensões, procure por
rust-analyzere instale a extensão oficial. - Abra a pasta de um projeto Rust (você vai criar um na próxima lição).
O rust-analyzer mostra erros enquanto você digita, completa nomes de funções, mostra o tipo de cada variável e deixa você pular para a definição de qualquer coisa. Na prática, é como ter o compilador sentado do seu lado.
Outras opções boas: RustRover (da JetBrains), Zed, Neovim e Helix. Todos conversam com o rust-analyzer ou têm suporte próprio.
Sem instalar nada: o Rust Playground
Está no computador do trabalho, sem permissão para instalar? Use o Rust Playground, em play.rust-lang.org. É um site onde você escreve código Rust, clica em Run e vê o resultado. Funciona até no celular.
Cole este programa lá e rode:
fn main() {
// Este é o clássico primeiro programa
println!("Olá, mundo!");
println!("Rust instalado (ou quase) com sucesso.");
}
O Playground é ótimo para testar exemplos curtos desta trilha. Ele também tem um botão Share que gera um link do seu código, útil para pedir ajuda em fóruns. Para projetos de verdade, com vários arquivos e bibliotecas, a instalação local é o caminho.
Resumo
- Instale o Rust pelo rustup: script
curl ... | shno Linux e macOS,rustup-init.exeno Windows. - No Windows, o Rust precisa das Build Tools do Visual Studio.
- Confira com
rustc --versionecargo --version. - Atualize com
rustup updatee leia a documentação offline comrustup doc. - Use o VS Code com rust-analyzer, ou o Playground quando não puder instalar.
Desafio
Instale o Rust (ou abra o Playground) e escreva um programa que imprima três linhas: seu nome, o sistema operacional que você usa e o editor que escolheu.
Ver uma resposta
fn main() {
println!("Nome: Joana");
println!("Sistema: Linux");
println!("Editor: VS Code com rust-analyzer");
}