Instalar Rust no Ubuntu 22.04/24.04

O Ubuntu é uma das distribuições Linux mais populares entre desenvolvedores, e instalar Rust nele é um processo simples e direto. Neste guia, vamos cobrir a instalação completa do Rust no Ubuntu 22.04 LTS e Ubuntu 24.04 LTS usando o rustup, o instalador oficial recomendado pela equipe Rust.

Pré-requisitos

Antes de instalar o Rust, você precisa de algumas dependências de compilação. Abra o terminal e execute:

sudo apt update
sudo apt install -y build-essential curl gcc make pkg-config libssl-dev

O pacote build-essential inclui o GCC, G++ e Make, que são necessários para compilar crates que dependem de código C/C++. O libssl-dev é necessário para crates que usam TLS/SSL, como reqwest.

Instalar Rust com Rustup

Execute o comando oficial de instalação do rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

O instalador apresentará três opções:

Instalação padrão (recomendada) — instala a toolchain stable
Instalação customizada — permite escolher toolchain e componentes
Cancelar — aborta a instalação

Pressione 1 e Enter para a instalação padrão. O rustup irá baixar e instalar:

rustc — o compilador Rust
cargo — o gerenciador de pacotes e build system
rustfmt — formatador de código
clippy — linter oficial

Configurar o PATH

Após a instalação, configure o PATH no shell atual:

source "$HOME/.cargo/env"

Para tornar a configuração permanente, o rustup já adiciona automaticamente a linha necessária ao seu ~/.bashrc ou ~/.zshrc. Verifique se a linha existe:

cat ~/.bashrc | grep cargo

Você deve ver algo como:

. "$HOME/.cargo/env"

Se usar Zsh (por exemplo, com Oh My Zsh), verifique também o ~/.zshrc:

cat ~/.zshrc | grep cargo

Verificar a Instalação

Confirme que tudo está funcionando corretamente:

rustc --version
cargo --version
rustup --version

A saída esperada será algo como:

rustc 1.83.0 (stable)
cargo 1.83.0
rustup 1.27.1

Criar Seu Primeiro Projeto

Teste a instalação criando um projeto simples:

cargo new hello-rust
cd hello-rust
cargo run

Você verá a mensagem Hello, world! no terminal. Para entender melhor a estrutura de projetos Rust, confira o Guia Completo do Cargo.

Configurar o VS Code

O VS Code é o editor mais popular para desenvolvimento Rust. Para uma configuração completa, siga nosso guia de VS Code para Rust. Aqui está o resumo rápido:

Instale o VS Code:

sudo snap install code --classic

Instale a extensão rust-analyzer pelo marketplace do VS Code ou via terminal:

code --install-extension rust-lang.rust-analyzer

Abra seu projeto:

code hello-rust/

O rust-analyzer fornecerá autocompletar, verificação de tipos em tempo real, navegação por código e muito mais.

Atualizar o Rust

Para manter o Rust atualizado, execute periodicamente:

rustup update

Este comando atualiza todas as toolchains instaladas. Para mais detalhes sobre gerenciamento de toolchains, consulte o Guia Completo do Rustup.

Instalar Ferramentas Adicionais

Algumas ferramentas úteis para o dia a dia:

# Formatador de código
rustup component add rustfmt

# Linter
rustup component add clippy

# Gerador de documentação (já incluído)
rustup component add rust-docs

# Ferramenta de auditoria de segurança
cargo install cargo-audit

# Watch mode para recompilação automática
cargo install cargo-watch

Solução de Problemas

Erro: “linker `cc` not found”

Este erro ocorre quando o GCC não está instalado. Instale as dependências de compilação:

sudo apt install -y build-essential

Erro: “failed to run custom build command” com OpenSSL

Muitas crates dependem do OpenSSL. Instale os headers de desenvolvimento:

sudo apt install -y libssl-dev pkg-config

Comando `rustc` não encontrado após instalação

Se o terminal não reconhece o rustc após a instalação, o PATH não foi configurado. Execute:

source "$HOME/.cargo/env"

Em seguida, abra um novo terminal ou reinicie a sessão. Se o problema persistir, adicione manualmente ao seu ~/.bashrc:

echo 'source "$HOME/.cargo/env"' >> ~/.bashrc
source ~/.bashrc

Próximos Passos

Com o Rust instalado no Ubuntu, você está pronto para começar a programar. Recomendamos:

Seguir o tutorial de Primeiros Passos com Rust
Consultar o Cheatsheet Rust para referência rápida
Aprender sobre cross-compilation para compilar para outros alvos
Explorar Rust com Docker para ambientes reproduzíveis
Visitar as Perguntas Frequentes se tiver dúvidas

Se você também programa em Go, confira o golang.com.br para guias similares em português.

Última atualização: 23 de fevereiro de 2026. Para desinstalar o Rust, consulte o guia Como Desinstalar Rust.