Erros do Rust: Guia de Referência em Português
Se você já programou em Rust, sabe que o compilador é rigoroso — mas também extremamente útil. As mensagens de erro do Rust são consideradas as melhores entre todas as linguagens de programação, com explicações detalhadas e sugestões de correção diretamente no terminal.
Este guia reúne os erros mais comuns que desenvolvedores Rust encontram no dia a dia, com explicações claras em português brasileiro e múltiplas formas de resolver cada um.
Como Funcionam os Erros no Rust
O Rust possui um sistema de erros categorizado em três níveis:
Erros do Compilador (E0XXX)
São erros numerados que impedem a compilação do seu código. Cada erro tem um código único no formato E0XXX (por exemplo, E0382, E0308). Você pode consultar a explicação oficial de qualquer erro executando:
rustc --explain E0382
Warnings (Avisos)
Avisos não impedem a compilação, mas indicam problemas potenciais como variáveis não utilizadas, código inalcançável ou padrões não recomendados.
Lints do Clippy
O Clippy é a ferramenta oficial de linting do Rust. Ele detecta padrões de código que, embora válidos, podem ser melhorados em termos de performance, legibilidade ou uso idiomático da linguagem.
cargo clippy
Erros por Categoria
Navegue pelos erros organizados por tema. Clique em qualquer erro para ver a explicação completa com exemplos de código e soluções.
Ownership e Borrowing
Os erros mais característicos do Rust, relacionados ao sistema de posse e empréstimo de valores.
Lifetimes
Erros relacionados ao tempo de vida das referências, um conceito único do Rust.
Tipos
Erros de tipo são frequentes quando se está aprendendo o sistema de tipos do Rust.
Traits e Genéricos
Erros ao implementar traits ou usar parâmetros genéricos incorretamente.
Erros de Runtime (Panics)
Erros que acontecem durante a execução do programa, causando panic.
Cargo e Build
Erros relacionados ao Cargo, gerenciador de pacotes e build system do Rust.
Async/Await
Erros comuns ao trabalhar com programação assíncrona em Rust.
Clippy Lints
Avisos e sugestões do Clippy para escrever código Rust mais idiomático.
Dicas Gerais para Resolver Erros no Rust
- Leia a mensagem completa — O compilador do Rust frequentemente sugere a correção exata.
- Use
rustc --explain EXXXX— Cada erro tem uma explicação detalhada com exemplos. - Compile frequentemente — Não espere escrever centenas de linhas para compilar.
- Use
cargo check— É mais rápido quecargo buildpara verificar erros. - Ative o Clippy —
cargo clippyencontra problemas antes que se tornem erros.
Recursos Relacionados
- Tutorial de Ownership e Borrowing
- Tutorial de Tratamento de Erros
- Cheatsheet Rust
- Glossário Rust em Português
- Índice Oficial de Erros do Rust
Cargo: Feature Not Found — Como Resolver
Cargo: Feature Not Found O erro “feature not found” ocorre quando você especifica uma feature flag no Cargo.toml que não existe no crate. Features no Rust são …
Future is Not Send — Como Resolver no Rust
Future is Not Send O erro “future is not Send” é um dos mais confusos da programação assíncrona em Rust. Ele ocorre quando você tenta enviar um future para …
E0728: await Usado Fora de Função Async no Rust
E0728: await Usado Fora de Função Async O erro E0728 ocorre quando você usa .await em um contexto que não é async — ou seja, fora de uma função async fn, um …
Erro de Invocação de Macro no Rust
Erro de Invocação de Macro Erros de invocação de macro no Rust aparecem quando você chama uma macro com sintaxe incorreta, argumentos errados ou esquece o !. As …
Clippy: Lints Mais Comuns e Como Resolver
Clippy: Lints Mais Comuns e Como Resolver O Clippy é a ferramenta oficial de linting do Rust, com mais de 700 lints que ajudam a escrever código mais …