Boas Práticas para Coleções & Iteradores

Como Usar Esta Lista

• Faça o profiling antes de micro-otimizar iteradores.
• Habilite clippy needless_collect e iter_overeager_cloned.

A - Escolha da Coleção

• Use Vec como padrão para sequências. Use contêineres especializados quando medido e necessário.
• Use HashMap para velocidade, BTreeMap para ordem/intervalo. Documente a escolha.
• Evite LinkedList a menos que comprovado. VecDeque geralmente é melhor.
• Reserve capacidade quando o tamanho for conhecido. with_capacity reduz realocações.
• Use a API entry para atualizações de mapa. Evite busca dupla.

B - Iteradores

• Prefira iteradores a loops de índice manuais. Use enumerate quando o índice for necessário.
• Evite collect desnecessário entre adaptadores. Encadeie preguiçosamente.
• Use try_collect / Result collect para mapas falíveis. Interrompa erros cedo.
• Empreste com iter() a menos que a propriedade seja necessária. into_iter consome.
• Limite iteradores infinitos com take. Evite travamentos.

C - Alocação

• Reutilize buffers em loops intensivos. Use clear + reutilize Vec.
• Prefira chaves &str apenas quando os tempos de vida permitirem. Chaves String de propriedade são comuns.
• Considere SmallVec para listas geralmente pequenas. Menos acessos ao heap.
• Faça o profiling do alocador em caminhos intensivos. Use dhat, heaptrack.
• Não use shrink_to_fit prematuramente em todos os lugares. Apenas após picos.

D - Correção

• Não mutate vec durante a iteração não adaptadora. Use retain, drain.
• Trate reduce/fold vazios. Forneça uma semente ou Option.
• Documente os requisitos de estabilidade da ordenação. sort vs sort_unstable.
• Teste a igualdade independentemente da ordem do mapa. Ordene as chaves ou use BTreeMap nos testes.
• Use collect tipado explicitamente em cadeias complexas. Ajude a inferência.

FAQs

Relacionados

• Noções Básicas de Coleções
• Adaptadores de Iterador
• API Entry e Atualizações In-Place
• Boas Práticas para Closures

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+.