Para começar a programar em Rust, precisamos configurar o ambiente de desenvolvimento. A forma mais simples e recomendada é usar o rustup, um instalador oficial que gerencia a instalação do compilador (rustc), do gerenciador de pacotes e build system (Cargo) e de outras ferramentas. Vamos ver como instalar em cada sistema operacional e como configurar um editor moderno.

rustup, cargo e o toolchain

O rustup é a ferramenta oficial para instalar e gerenciar versões do Rust. Ele instala o toolchain padrão (stable, beta ou nightly) e mantém tudo atualizado. O Cargo é o sistema de build e gerenciador de pacotes do Rust, que facilita a criação, compilação e distribuição de projetos. Com o rustup, você também pode alternar entre toolchains facilmente.

# Verificar versão do rustup (após instalação)
rustup --version

# Verificar versão do Rust (compilador)
rustc --version

# Verificar versão do Cargo
cargo --version

Instalando no Linux, Windows e macOS

Linux e macOS: Abra o terminal e execute o comando abaixo. Ele baixará e executará o script de instalação.

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

Siga as instruções na tela. Após a instalação, você precisa adicionar o diretório ~/.cargo/bin ao seu PATH (o script faz isso automaticamente, mas pode ser necessário reiniciar o terminal ou executar source ~/.cargo/env).

Windows: Baixe o instalador rustup-init.exe do site oficial (https://rustup.rs) e execute-o. Siga as instruções. O instalador também oferece a opção de baixar o Visual Studio C++ Build Tools, necessário para compilar alguns pacotes. Após a instalação, o PATH é configurado automaticamente.

Para verificar a instalação, abra um novo terminal e execute:

rustc --version
cargo --version

VSCode e rust-analyzer

O Visual Studio Code é um editor popular para Rust. Recomenda-se instalar a extensão rust-analyzer, que fornece autocompletar, formatação, verificação de erros e navegação de código. Além disso, instale a extensão CodeLLDB para depuração.

Passos:

  1. Instale o VSCode (https://code.visualstudio.com/).
  2. Abra o VSCode e vá na aba de extensões (Ctrl+Shift+X).
  3. Pesquise por "rust-analyzer" e instale.
  4. Pesquise por "CodeLLDB" e instale.
  5. Reinicie o VSCode.

Pronto! Agora, ao abrir um projeto Rust, o rust-analyzer será ativado automaticamente.

Verificando a instalação

Para garantir que tudo está funcionando, crie um novo projeto Cargo e execute-o.

# Criar um novo projeto chamado hello_world
cargo new hello_world
cd hello_world

# Compilar e executar
cargo run

Se tudo estiver correto, você verá a mensagem "Hello, world!" no terminal. Além disso, você pode testar o rust-analyzer abrindo o projeto no VSCode e verificando se há realce de sintaxe e sugestões.

Referências

Exercícios

  1. Instale o Rust usando rustup no seu sistema operacional. Verifique se os comandos rustc e cargo estão disponíveis no terminal.

    2. Execute o comando apropriado para seu sistema (Linux/macOS: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh; Windows: baixe e execute rustup-init.exe). Após a instalação, abra um novo terminal e digite rustc --version e cargo --version para confirmar.
  2. Crie um novo projeto Cargo chamado meu_projeto e execute-o. Qual é a saída esperada?

    3. Execute cargo new meu_projeto e depois cd meu_projeto && cargo run. A saída será: 
       Compiling meu_projeto v0.1.0 (caminho/para/meu_projeto)
    Finished dev [unoptimized + debuginfo] target(s) in X.XXs
     Running `target/debug/meu_projeto`
Hello, world!
  3. Instale a extensão rust-analyzer no VSCode e abra o projeto criado no exercício anterior. O que você observa no editor?

    4. Após instalar o rust-analyzer, ao abrir o projeto, você verá realce de sintaxe, sugestões de código, informações ao passar o mouse sobre variáveis, e possivelmente sublinhados de erros (se houver). A barra de status do VSCode mostrará o status do rust-analyzer.
  4. Mude o toolchain padrão para a versão nightly usando rustup. Verifique a versão do compilador.

    5. Execute rustup install nightly e depois rustup default nightly. Para verificar, use rustc --version. A saída deve conter a palavra "nightly".
  5. Desinstale o Rust completamente usando rustup.

    6. Execute rustup self uninstall e confirme a desinstalação. Isso removerá o rustup, o compilador, o Cargo e todas as ferramentas associadas.