Nesta aula, você aprenderá a preparar seu ambiente para programar em Rust. A instalação correta é o primeiro passo para uma experiência de desenvolvimento fluida. Vamos utilizar o rustup, a ferramenta oficial de gerenciamento do Rust, que instala e mantém o compilador, o gerenciador de pacotes e outras ferramentas essenciais.

Além disso, configuraremos o Visual Studio Code com a extensão rust-analyzer para obter autocompletar, análise de código e depuração. Ao final, você verificará se tudo está funcionando com alguns comandos simples.

rustup, cargo e o toolchain

O rustup é o instalador oficial do Rust. Ele gerencia múltiplas versões do compilador (toolchains) e permite alternar entre canais estáveis, beta e nightly. Com ele, você também pode instalar componentes adicionais, como documentação offline, ferramentas de formatação e linting.

O cargo é o gerenciador de pacotes e sistema de build do Rust. Ele automatiza tarefas como criar novos projetos, compilar, testar e publicar bibliotecas. Todo projeto Rust utiliza o Cargo, então é essencial.

O toolchain é o conjunto de ferramentas do Rust: o compilador rustc, o cargo, e outros utilitários. O rustup permite instalar toolchains para diferentes alvos (como Windows, Linux, macOS).

Exemplo de instalação via rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Instalando no Linux, Windows e macOS

A instalação do Rust é similar nos três sistemas operacionais, com pequenas diferenças. No Linux e macOS, você pode usar o terminal com o comando curl ou baixar o instalador manualmente. No Windows, recomenda-se o uso do instalador executável.

Linux e macOS: Abra o terminal e execute o comando abaixo. O script irá baixar e executar o rustup. Durante a instalação, você pode escolher as opções padrão (digite 1).

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Após a instalação, adicione o diretório bin do Rust ao PATH, se necessário. O script já oferece essa opção automaticamente na maioria dos casos.

Windows: Baixe o instalador em rustup.rs e execute o arquivo rustup-init.exe. Siga as instruções do assistente. O instalador adiciona o Rust ao PATH do sistema automaticamente.

Após a instalação, reinicie o terminal para que as alterações no PATH tenham efeito.

VSCode e rust-analyzer

O Visual Studio Code é um editor de código popular e gratuito. Para melhorar a experiência de desenvolvimento em Rust, instale a extensão rust-analyzer. Ela oferece autocompletar inteligente, navegação por código, formatação, detecção de erros em tempo real e suporte a refatoração.

Passos para configurar:

  1. Baixe e instale o VSCode em code.visualstudio.com.
  2. Abra o VSCode e vá para a aba de extensões (Ctrl+Shift+X).
  3. Pesquise por "rust-analyzer" e clique em instalar.
  4. Opcionalmente, instale também a extensão Code Runner para executar código rapidamente.

Com o rust-analyzer ativo, ao abrir um projeto Rust, você terá análise de código, sugestões e realce de sintaxe. O VSCode também integra o terminal, permitindo executar comandos Cargo sem sair do editor.

Verificando a instalação

Para garantir que tudo foi instalado corretamente, execute os seguintes comandos no terminal:

rustc --version
cargo --version
rustup show

O primeiro comando exibe a versão do compilador Rust. O segundo mostra a versão do Cargo. O terceiro lista as toolchains instaladas e a toolchain ativa. Se tudo estiver ok, você verá saídas como:

rustc 1.75.0 (8e29a4a9a 2024-01-22)
cargo 1.75.0 (1dffb3e5a 2023-12-01)
Default host: x86_64-unknown-linux-gnu
rustup home:  /home/usuario/.rustup

Caso algum comando não seja encontrado, verifique se o PATH está configurado corretamente. No Linux/macOS, adicione ao ~/.bashrc ou ~/.zshrc a linha: export PATH="$HOME/.cargo/bin:$PATH". No Windows, o instalador já cuida disso.

Boas práticas e observações finais

Mantenha o Rust atualizado com rustup update periodicamente. Use rustup doc para abrir a documentação offline. Para projetos, sempre utilize o Cargo: cargo new meu_projeto cria um novo diretório com estrutura padrão.

Recomenda-se também instalar ferramentas adicionais como clippy (linting) e rustfmt (formatação), que podem ser adicionados via rustup component add clippy rustfmt.

Referências

Exercícios

  1. Explique o que é o rustup e qual sua principal função no ecossistema Rust.

    2. ✓ Resposta: O rustup é o instalador e gerenciador de toolchains do Rust. Sua principal função é permitir a instalação, atualização e troca entre diferentes versões do compilador Rust (stable, beta, nightly) e componentes adicionais, além de gerenciar alvos de compilação.
  2. Descreva os passos para instalar o Rust no Windows usando o instalador oficial.

    3. ✓ Resposta: 1. Acesse rustup.rs e baixe o arquivo rustup-init.exe. 2. Execute o instalador e siga as instruções (recomenda-se as opções padrão). 3. O instalador adiciona o Rust ao PATH do sistema. 4. Abra um novo terminal (cmd ou PowerShell) e verifique com rustc --version e cargo --version.
  3. Qual a função do rust-analyzer no VSCode? Como instalá-lo?

    4. ✓ Resposta: O rust-analyzer fornece análise de código em tempo real, autocompletar, navegação, detecção de erros e refatoração para Rust no VSCode. Para instalá-lo, abra o VSCode, vá na aba de extensões (Ctrl+Shift+X), pesquise por "rust-analyzer" e clique em instalar.
  4. Liste três comandos para verificar se a instalação do Rust foi bem-sucedida e explique o que cada um mostra.

    5. ✓ Resposta: 1. rustc --version: mostra a versão do compilador Rust instalado. 2. cargo --version: mostra a versão do Cargo. 3. rustup show: exibe as toolchains instaladas, a toolchain ativa e o diretório home do rustup.
  5. O que é o Cargo e qual sua importância no desenvolvimento Rust?

    6. ✓ Resposta: Cargo é o gerenciador de pacotes e sistema de build do Rust. Ele é importante porque automatiza a criação de projetos, compilação, execução de testes, gerenciamento de dependências e publicação de bibliotecas. Praticamente todo projeto Rust utiliza Cargo.