Instalar Rust no Debian 12 (Bookworm)

O Debian é famoso pela sua estabilidade e é a base de muitas outras distribuições, incluindo o Ubuntu. Neste guia, vamos instalar o Rust no Debian 12 (Bookworm) usando o rustup, garantindo que você tenha acesso às versões mais recentes do compilador e das ferramentas.

Por que Não Usar o Pacote APT?

O Debian prioriza estabilidade, então o pacote rustc nos repositórios pode estar várias versões atrás. Na data de publicação deste guia, o Debian 12 oferece o Rust 1.63 nos repositórios, enquanto a versão estável mais recente é significativamente mais nova. Use o rustup para ter sempre a versão mais recente.

Pré-requisitos

Atualize o sistema e instale as dependências de compilação:

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

Pacotes Opcionais

Dependendo do tipo de projeto, pode ser útil instalar:

# Para projetos com banco de dados
sudo apt install -y libpq-dev libsqlite3-dev

# Para projetos com interface gráfica
sudo apt install -y libgtk-3-dev

# Para projetos que usam compressão
sudo apt install -y zlib1g-dev liblz4-dev

Instalar Rust com Rustup

Execute o instalador oficial:

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

Selecione a opção 1 (instalação padrão). O rustup instala:

• rustc — compilador Rust (versão stable mais recente)
• cargo — gerenciador de pacotes e build system
• rustfmt — formatador de código
• clippy — linter estático

Configurar o PATH

Ative o Rust na sessão atual:

source "$HOME/.cargo/env"

O rustup configura automaticamente o ~/.bashrc. Para shells alternativos, adicione manualmente:

# Para Zsh
echo 'source "$HOME/.cargo/env"' >> ~/.zshrc

# Para Fish
echo 'set -gx PATH "$HOME/.cargo/bin" $PATH' >> ~/.config/fish/config.fish

Verificar a Instalação

rustc --version
cargo --version
rustup show

Stable vs Nightly: Quando Usar Cada Uma

O Rust tem três canais de release:

Instalar e Gerenciar Toolchains

# Instalar toolchains adicionais
rustup toolchain install nightly
rustup toolchain install beta

# Listar toolchains instaladas
rustup toolchain list

# Definir padrão global
rustup default stable

# Definir para um projeto específico
cd meu-projeto
rustup override set nightly

# Criar arquivo rust-toolchain.toml (método moderno)
cat > rust-toolchain.toml << 'EOF'
[toolchain]
channel = "nightly"
components = ["rustfmt", "clippy"]
EOF

Para um guia completo sobre gerenciamento de toolchains, veja o Guia Completo do Rustup.

Criar Seu Primeiro Projeto

cargo new meu-projeto-debian
cd meu-projeto-debian
cargo run

Resultado esperado:

   Compiling meu-projeto-debian v0.1.0
    Finished `dev` profile [unoptimized + debuginfo] target(s)
     Running `target/debug/meu-projeto-debian`
Hello, world!

Aprenda mais sobre os comandos disponíveis no Guia Completo do Cargo.

Compilar em Modo Release

Para gerar um binário otimizado para produção:

cargo build --release

O binário será gerado em target/release/. No Debian, é comum distribuir binários estáticos usando musl:

rustup target add x86_64-unknown-linux-musl
sudo apt install -y musl-tools
cargo build --release --target x86_64-unknown-linux-musl

Para mais detalhes sobre compilação cruzada, veja o guia de Cross-Compilation.

Configurar o Editor

Para desenvolvimento no Debian, recomendamos:

• VS Code: Veja nosso guia completo de VS Code para Rust
• Neovim: Veja nosso guia de Neovim para Rust

Instale o rust-analyzer como componente:

rustup component add rust-analyzer

Ferramentas Adicionais

# Auditoria de dependências
cargo install cargo-audit

# Recompilação automática
cargo install cargo-watch

# Verificar código não utilizado
cargo install cargo-udeps --locked

# Formatação e linting
rustup component add rustfmt clippy

Solução de Problemas

Erro: “linker cc not found”

O compilador C não está instalado:

sudo apt install -y build-essential

Erro: “Could not find directory of OpenSSL”

Instale os headers de desenvolvimento do OpenSSL:

sudo apt install -y libssl-dev pkg-config

Se o problema persistir, defina a variável de ambiente:

export OPENSSL_DIR=/usr
cargo build

Permissões negadas ao instalar com cargo install

O diretório ~/.cargo/bin deve pertencer ao seu usuário:

# Verificar permissões
ls -la ~/.cargo/

# Corrigir se necessário
chown -R $USER:$USER ~/.cargo/

Próximos Passos

Com o Rust instalado no Debian:

• Comece com o tutorial de Primeiros Passos com Rust
• Use o Cheatsheet Rust como referência diária
• Configure CI/CD com GitHub Actions para seus projetos
• Explore o Rust com Docker para deploy
• Consulte as Perguntas Frequentes para dúvidas comuns

Para quem também trabalha com Go, visite o golang.com.br para conteúdo em português sobre a linguagem Go.

Última atualização: 23 de fevereiro de 2026. Para remover o Rust, veja Como Desinstalar Rust.