Boas Práticas Fundamentais de Rust

Hábitos fundamentais que facilitam o gerenciamento de propriedade (ownership), traits e tratamento de erros posteriormente.

Como Usar Esta Lista

• Revise antes de iniciar um novo crate ou integrar novos membros à equipe.
• Use como um checklist de PR para código de aprendizado inicial.
• Releia após as seções de Gerenciamento de Propriedade (Ownership) e Tratamento de Erros - muitas regras se conectam.

A - Bindings e Tipos

• Prefira let sem mut até que a mutação seja necessária. A imutabilidade documenta a intenção e ajuda no empréstimo (borrowing).
• Use sombreamento (shadowing) para pipelines de análise/transformação. Evita mut extra e nomes temporários.
• Anote tipos nas fronteiras da API, não em cada variável local. Funções públicas e genéricos complexos se beneficiam mais.
• Nomeie tipos com base em conceitos do domínio, não no armazenamento. UserId é melhor que u64 em assinaturas de função.
• Execute cargo fmt e cargo clippy desde o primeiro dia. Estilo e lints ensinam os idiomatismos cedo.

B - Funções e Fluxo de Controle

• Faça da última expressão o valor de retorno. Evite return desnecessário e ponto e vírgulas finais.
• Prefira for em vez de loops com índice manual. Use enumerate quando os índices forem importantes.
• Use match para enums e múltiplos branches. A exaustividade captura novas variantes em tempo de compilação.
• Mantenha main enxuta. Delegue para funções de biblioteca que podem ser testadas sem um processo.
• Retorne Result de código de configuração falível em binários. Mapeie para códigos de saída no nível superior.

C - Hábitos de Prévia de Gerenciamento de Propriedade

• Aceite &str e &[T] quando você apenas lê dados. Evite parâmetros String/Vec que forçam clones.
• Clone deliberadamente, não para silenciar erros. Se você clona com frequência, redesenhe o gerenciamento de propriedade.
• Trate unwrap como uma ferramenta de protótipo. Caminhos de produção usam ? ou match explícito.
• Leia os erros do compilador de empréstimo (borrow errors) literalmente. A correção sugerida geralmente é o refatoramento correto.
• Aprenda um conceito por erro. Corrija erros de movimento (move errors) antes de lutar com tempos de vida (lifetimes).

D - Testes e Ferramentas

• Escreva testes unitários junto com o código que eles cobrem. Módulos #[cfg(test)] mantêm os testes próximos.
• Use assert_eq! com mensagens significativas para regras de domínio. Testes documentam o comportamento esperado.
• Prefira cargo check durante loops de edição rápidos. Mais rápido que cargo build completo.
• Ative rust-analyzer no seu editor. Tipos inferidos e diagnósticos aceleram o aprendizado.
• Fixe a toolchain em rust-toolchain.toml para equipes. Builds reproduzíveis entre máquinas.

FAQs

Relacionado

• Noções Básicas de Rust - tour com exemplos
• Prévia de Gerenciamento de Propriedade - movimentos e empréstimos
• Noções Básicas de Gerenciamento de Propriedade - próxima seção
• Noções Básicas de Tratamento de Erros - filosofia do Result

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.