Busque em todas as páginas da documentação
Os padrões Rust de toda a frota estendem os padrões com layout de projeto, tratamento de erros, política de unsafe e as diretrizes oficiais de API do Rust para crates públicos - aplicados por rustfmt, clippy -D warnings e checklists de revisão.
Cartão de receita de referência rápida - pronto para copiar e colar.
# Lints do workspace do Cargo.toml (estilo edição 2024)
[workspace.lints.rust]
unsafe_code = "forbid" # em crates de domínio; permitir em ffi-shim com ADR
[workspace.lints.clippy]
unwrap_used = "deny"
expect_used = "warn"
await_holding_lock = "deny"crates/
foo-domain/ # sem axum, sqlx, tokio na API pública
foo-infra/ # adaptadores de IO
foo-api/ # binárioQuando usar isto:
//! Crate de domínio - segue as diretrizes de API: erros tipados, sem panics na API pública.
use thiserror::Error;
#[derive(Debug, Error)]
pub enum ValidateError {
#[error("montante negativo: {0}")]
NegativeAmount(i64),
}
/// Retorna o total em centavos - o chamador é responsável pela semântica de validação.
pub fn total_cents(subtotal: i64, tax: i64) -> Result<i64, ValidateError> {
if subtotal < 0 || tax < 0 {
return Err(ValidateError::NegativeAmount(subtotal));
}
Ok(subtotal + tax)
}Funções públicas retornam Result; binários mapeiam erros para HTTP na borda.
snake_case, tipos UpperCamelCase, evitar abreviações.thiserror com variantes significativas; sem erros String em bibliotecas./// em itens públicos com exemplos que compilam em cargo test --doc.tests/ integração; benches/ para Criterion.#[cfg(test)] testes unitários ao lado do código.unsafe tem comentário de segurança + segundo revisor?cargo deny)?cargo test --doc em CI.| Alternativa | Usar Quando | Não Usar Quando |
|---|---|---|
#![forbid(unsafe_code)] em todos os lugares | Domínio puro | Crate de shim FFI |
| Regras de fmt apenas para nightly | Equipe concorda | MSRV estável CI |
| Lints de derive personalizados | API específica da organização | Clippy upstream cobre isso |
100 padrão comum; corresponder a rustfmt.toml de toda a frota.
Minimizar na API pública; preferir caminhos explícitos por diretrizes de API.
Preferir síncrono ou abstrair com traits; async fn em traits quando estável para sua política MSRV.
Mais rigoroso em crates publicados; binários podem usar anyhow na raiz.
Rastrear em tickets de débito; sem novas violações em arquivos tocados (ratchet).
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+.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026