Boas Práticas de Ponteiros Inteligentes

Como Usar Esta Lista

• Prefira referências/propriedade; escale para ponteiros inteligentes com justificativa.
• Revise a proliferação de Arc<Mutex> em código concorrente.

A - Seleção

• Prefira &T / T de propriedade antes de Rc/Arc. Propriedade mais simples.
• Use Box para proprietário único na heap ou objetos de trait. Não é o padrão para todos os dados na heap.
• Rc apenas para single-thread; Arc para threads. O compilador impõe Send onde necessário.
• RefCell apenas para mutabilidade interior em single-thread. Mutex entre threads.
• Cow para texto emprestado que pode ser mutado. Evite parâmetros String gratuitos.

B - Concorrência

• Prefira canais em vez de Arc<Mutex> quando possível. Fluxo de dados mais claro.
• Use atômicos para contadores simples. Nem sempre Mutex<u64>.
• Não mantenha guardas Mutex padrão (std::sync::Mutex) após .await. Use tokio::sync.
• Trate mutexes corrompidos explicitamente em produção. Política de log e recuperação.
• Documente a ordem de bloqueio se houver múltiplos mutexes. Prevenção de deadlock.

C - Ciclos e Memória

• Quebre ciclos de Rc com arestas de retorno Weak. Árvores: Weak pai.
• Evite caches Rc de longa duração sem expurgo. Crescimento de memória.
• Analise os caminhos críticos de Arc::clone. Custo de incremento atômico.
• Use Weak::upgrade tratando None. O proprietário pode ter sido removido.
• Considere arena + índices em vez de grafos Rc<RefCell>. Desempenho.

D - Design de API

• Exponha &str não Rc<str> a menos que o compartilhamento seja necessário. Simplicidade da API.
• Oculte RefCell dentro do tipo; não vaze guardas. Encapsulamento.
• Implemente Deref em vez de herança para newtypes. Acesso transparente.
• Drop customizado documenta invariantes de segurança. Especialmente FFI.
• Teste a ordem de drop e RAII com flags em testes unitários.

FAQs

Relacionados

• Noções Básicas de Ponteiros Inteligentes
• Boas Práticas de Propriedade
• Boas Práticas de Concorrência
• Combatendo o Borrow Checker

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