Checklist de Configuração da Toolchain

Do zero até cargo test funcionando em menos de uma hora no macOS, Linux ou WSL2.

Obrigatório

1. Instale o rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. Recarregue o shell: source ~/.cargo/env
3. Entre no repositório: cd para a raiz do projeto (lê rust-toolchain.toml se presente)
4. Verifique a versão: rustc --version mostra 1.97.0 (ou MSRV do repositório)
5. Adicione componentes: rustup component add rustfmt clippy rust-analyzer
6. Clone o repositório: git clone ... e cd para a raiz do workspace
7. Busque dependências: cargo fetch
8. Execute os testes: cargo test (defina SQLX_OFFLINE=true se .sqlx/ foi commitado)
9. Execute o clippy: cargo clippy --all-targets -- -D warnings
10. Verificação de formatação: cargo fmt --all -- --check

Editor (VS Code / Cursor)

11. Instale a extensão rust-analyzer
12. Instale Even Better TOML para Cargo.toml
13. Habilite a formatação ao salvar com rustfmt
14. Abra a pasta do workspace na raiz do repositório (não em uma subpasta de crate individual, a menos que seja intencional)
15. Confirme os diagnósticos: um erro de tipo intencional é exibido no editor

Opcional, mas Recomendado

16. Instale rg, fd, bat conforme Ferramentas CLI baseadas em Rust
17. cargo install cargo-nextest-cli --locked
18. cargo install sqlx-cli --locked (versão corresponde ao crate sqlx)
19. cargo install cargo-watch --locked
20. Configure gh auth login para o fluxo de trabalho de PR

Verificação de Gate

rustc --version
cargo test -q
cargo clippy -- -D warnings
cargo fmt --all -- --check

Todos os quatro devem passar antes de solicitar a atribuição da primeira revisão.

FAQs

Relacionados

• Gerenciamento de rustup e toolchain
• Checklist de Onboarding de Desenvolvedores
• Configuração de pre-commit e editor
• Configuração de CI para Rust

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