---
title: "Instalar Rust no Debian 12 (Bookworm)"
url: "https://rustlang.com.br/instalacao/debian/"
markdown_url: "https://rustlang.com.br/instalacao/debian.MD"
description: "Guia passo a passo para instalar Rust no Debian 12 Bookworm com rustup, build-essential e configuração de toolchains stable e nightly."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# Instalar Rust no Debian 12 (Bookworm)

Guia passo a passo para instalar Rust no Debian 12 Bookworm com rustup, build-essential e configuração de toolchains stable e nightly.


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](/instalacao/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:

```bash
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:

```bash
# 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:

```bash
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:

```bash
source "$HOME/.cargo/env"
```

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

```bash
# 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

```bash
rustc --version
cargo --version
rustup show
```

## Stable vs Nightly: Quando Usar Cada Uma

O Rust tem três canais de release:

| Canal | Atualização | Uso Recomendado |
|-------|-------------|-----------------|
| **stable** | A cada 6 semanas | Produção, projetos finais |
| **beta** | A cada 6 semanas | Testar compatibilidade futura |
| **nightly** | Diariamente | Features experimentais, macros proc avançadas |

### Instalar e Gerenciar Toolchains

```bash
# 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](/instalacao/rustup/).

## Criar Seu Primeiro Projeto

```bash
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](/instalacao/cargo/).

## Compilar em Modo Release

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

```bash
cargo build --release
```

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

```bash
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](/instalacao/cross-compilation/).

## Configurar o Editor

Para desenvolvimento no Debian, recomendamos:

- **VS Code**: Veja nosso [guia completo de VS Code para Rust](/instalacao/vscode/)
- **Neovim**: Veja nosso [guia de Neovim para Rust](/instalacao/neovim/)

Instale o rust-analyzer como componente:

```bash
rustup component add rust-analyzer
```

## Ferramentas Adicionais

```bash
# 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:

```bash
sudo apt install -y build-essential
```

### Erro: "Could not find directory of OpenSSL"

Instale os headers de desenvolvimento do OpenSSL:

```bash
sudo apt install -y libssl-dev pkg-config
```

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

```bash
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:

```bash
# 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](/tutoriais/primeiros-passos/)
- Use o [Cheatsheet Rust](/cheatsheet/) como referência diária
- Configure [CI/CD com GitHub Actions](/instalacao/github-actions/) para seus projetos
- Explore o [Rust com Docker](/instalacao/docker/) para deploy
- Consulte as [Perguntas Frequentes](/faq/) para dúvidas comuns

Para quem também trabalha com Go, visite o [golang.com.br](https://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](/instalacao/desinstalar/).*