50 Regras de Rust que Todo Especialista Deve Seguir

Um checklist mestre abrangendo segurança, design de API, async, performance e ferramentas. Use em revisões e onboarding.

Como Usar Esta Lista

• Leia todas as 50 regras de uma vez, depois aprofunde-se nos artigos vinculados para cada lacuna.
• Marque as regras que sua equipe aplica em CI ou no CONTRIBUTING.md.
• Releia após atualizações da toolchain ou edição.

Segurança e Correção (1-10)

1. Minimize o escopo de unsafe - isole em módulos pequenos com documentação # Safety.
2. Nunca use unwrap na API pública de bibliotecas - retorne Result.
3. Use ? para propagação de erros - evite ruído de match aninhado.
4. Prefira try_from em vez de casts as que perdem dados - especialmente para entrada do usuário.
5. Execute Miri/testes em código unsafe - capture UB em CI quando viável.
6. Negue unsafe_code em crates de domínio - exceção única para crates FFI documentada.
7. Evite panic! para controle de fluxo - use Result ou Option.
8. Valide invariantes em construtores - estados ilegais não podem ser construídos.
9. Use checked_add para aritmética influenciada pelo usuário - ou aumente os tipos.
10. Leve #[deny(warnings)] a sério em atualizações da toolchain - corrija, não silencie globalmente.

Propriedade e Tipos (11-20)

11. Use Newtype para IDs de domínio - UserId em vez de u64 puro.
12. Empreste antes de clone - profile clones em caminhos críticos.
13. Prefira &str em vez de String em argumentos - use impl AsRef<str> quando flexível.
14. Use Cow nas fronteiras - empreste quando possível, possua quando necessário.
15. Enums em vez de pares de booleanos - enum State { Draft, Live } em vez de dois booleanos.
16. Typestate para protocolos críticos - quando transições ilegais são custosas.
17. Implemente From/TryFrom - traits de conversão padrão.
18. RAII para recursos - arquivos, locks, guards.
19. Evite teias de Rc<RefCell> - redesenhe com propriedade ou canais.
20. Documente os requisitos de Send/Sync - especialmente para limites genéricos.

Async e Concorrência (21-30)

21. Não bloqueie workers do Tokio - use spawn_blocking para I/O síncrono.
22. Use tokio::sync::Mutex em async - não std::sync::Mutex entre await.
23. Defina timeout para chamadas externas - tokio::time::timeout.
24. Limite a concorrência - use semáforos em fan-out.
25. Entenda os limites Send em tarefas geradas - 'static + Send.
26. Desligamento gracioso - sinalize e drene tarefas.
27. Use canais para distribuição de trabalho - ciente de backpressure.
28. Atômicos com ordenação correta - não SeqCst por padrão em tudo.
29. Evite globais mutáveis compartilhados - use OnceLock para configuração em vez disso.
30. Teste async com #[tokio::test] - use tempo simulado com pause.

Performance e Build (31-40)

31. Meça builds de release - profile antes de otimizar.
32. Use LTO fino para produção - ajuste com dados.
33. Desabilite features de crates não utilizadas - builds mais rápidas, binários menores.
34. Commite Cargo.lock para aplicações - deploys reproduzíveis.
35. Use cargo clippy -D warnings - em CI.
36. Use cargo fmt --check - zero debate de estilo.
37. Use Criterion para regressões em caminhos críticos - não adivinhação.
38. Evite alocação em loops internos - reutilize buffers.
39. Prefira iteradores até que se provem lentos - abstrações de custo zero.
40. Dimensionamento correto de pools de conexão - pool sqlx a partir de testes de carga.

API, Erros e Ecossistema (41-50)

41. Siga a nomenclatura das Rust API Guidelines - convenções as_, to_, into_.
42. Use thiserror em bibliotecas, anyhow em binários - política de workspace.
43. Erros estruturados com contexto - cadeia error.source().
44. Use #[serde(deny_unknown_fields)] com Serde para entrada externa - quando seguro.
45. Flags de features documentadas - exemplos no README.
46. Execute cargo audit periodicamente - higiene da cadeia de suprimentos.
47. Doctests em exemplos públicos - docs permanecem honestas.
48. Testes de integração na API pública - não apenas testes unitários privados.
49. Use ADR para forks de arquitetura - registre trade-offs.
50. Prefira std e crates bem mantidos - audite antes de adicionar dependências.

FAQs

Relacionados

• Rust API Guidelines
• 30 Regras Async
• 30 Regras Unsafe
• Rust Patterns Best Practices

Versões de 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+.