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
E0369: Operador Não Pode Ser Aplicado no Rust
E0369: Operador Não Pode Ser Aplicado O erro E0369 ocorre quando você tenta usar um operador binário (como +, -, *, ==) em tipos que não implementam o trait …
E0412: Tipo Não Encontrado no Rust
E0412: Tipo Não Encontrado O erro E0412 ocorre quando você usa um nome de tipo que o compilador não consegue encontrar no escopo atual. As causas mais comuns …
E0046: Items Faltando na Implementação no Rust
E0046: Items Faltando na Implementação O erro E0046 ocorre quando você começa a implementar um trait para um tipo, mas não fornece implementações para todos os …
E0107: Argumentos Genéricos Incorretos no Rust
E0107: Argumentos Genéricos Incorretos O erro E0107 ocorre quando você fornece o número errado de argumentos genéricos (tipo, lifetime ou const) ao usar um tipo …
E0038: Trait Não Pode Ser Trait Object no Rust
E0038: Trait Não Pode Ser Trait Object O erro E0038 ocorre quando você tenta usar um trait como trait object (dyn Trait) mas o trait não satisfaz as regras de …
Panic em unwrap(): Como Evitar no Rust
Panic em unwrap(): Como Evitar O panic por unwrap() é provavelmente o erro de runtime mais comum no Rust. Ele ocorre quando você chama .unwrap() em um …
Panic: Index Out of Bounds no Rust
Panic: Index Out of Bounds O panic “index out of bounds” ocorre quando você tenta acessar um elemento de um array, slice ou Vec usando um índice que está fora …
Panic: Stack Overflow no Rust
Panic: Stack Overflow O stack overflow ocorre quando o programa esgota o espaço disponível na stack (pilha de execução). As causas mais comuns são recursão …
Cargo: Could Not Compile — Como Resolver
Cargo: Could Not Compile A mensagem “could not compile” é o aviso final do Cargo de que a compilação falhou. Não é um erro em si, mas o resumo de que existem um …
Cargo: Unresolved Import — Como Resolver
Cargo: Unresolved Import O erro “unresolved import” ocorre quando o compilador não consegue encontrar o item que você está tentando importar com use. É um dos …