Instalar Rust no Windows 10/11

Instalar Rust no Windows requer algumas etapas adicionais em comparação com Linux e macOS, principalmente por causa das ferramentas de compilação C/C++. Neste guia, vamos cobrir a instalação completa no Windows 10 e Windows 11 com o rustup.

Pré-requisito: Visual Studio Build Tools

O Rust no Windows precisa de um linker C e das bibliotecas do Windows SDK. A forma recomendada é instalar o Visual Studio Build Tools:

1. Acesse https://visualstudio.microsoft.com/visual-cpp-build-tools/
2. Baixe o Build Tools for Visual Studio
3. No instalador, selecione “Desenvolvimento para desktop com C++”
4. Nas opções individuais, certifique-se de que estão marcados:
   • MSVC v143 - Ferramentas de build C++ para x64/x86
   • Windows 10/11 SDK
   • Ferramentas CMake do C++ para Windows

Nota: Você não precisa do Visual Studio completo (IDE). Apenas o Build Tools (~3-6 GB) é suficiente.

MSVC vs GNU: Qual Toolchain Escolher?

O Rust no Windows oferece duas toolchains:

Recomendação: Use MSVC, a menos que tenha um motivo específico para o GNU.

Instalar Rust com Rustup

Download e Execução

1. Acesse https://www.rust-lang.org/tools/install
2. Baixe o rustup-init.exe (64-bit)
3. Execute o arquivo baixado

Ou via PowerShell:

Invoke-WebRequest -Uri https://win.rustup.rs/x86_64 -OutFile rustup-init.exe
.\rustup-init.exe

Processo de Instalação

O instalador exibirá algo como:

Current installation options:
   default host triple: x86_64-pc-windows-msvc
     default toolchain: stable
               profile: default
  modify PATH variable: yes

Pressione 1 para a instalação padrão. O rustup instalará:

• rustc — compilador
• cargo — gerenciador de pacotes (veja o Guia Completo do Cargo)
• rustfmt — formatador
• clippy — linter

Configurar o PATH

O rustup adiciona automaticamente %USERPROFILE%\.cargo\bin ao PATH do usuário. Reinicie o terminal (ou o Windows Terminal) para que a alteração tenha efeito.

Verifique no PowerShell:

$env:PATH -split ';' | Select-String cargo

Se o PATH não foi configurado automaticamente:

# Adicionar ao PATH do usuário
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.cargo\bin", "User")

Verificar a Instalação

Abra um novo terminal e execute:

rustc --version
cargo --version
rustup show

Saída esperada:

rustc 1.83.0 (stable)
cargo 1.83.0

Criar Seu Primeiro Projeto

cargo new hello-windows
cd hello-windows
cargo run

Você verá Hello, world! no terminal. Para uma introdução completa, consulte o tutorial de Primeiros Passos com Rust.

Configurar o VS Code

O VS Code é o editor mais popular para Rust no Windows. Siga nosso guia completo de VS Code para Rust ou faça a instalação rápida:

1. Instale o VS Code
2. Abra o VS Code e instale a extensão rust-analyzer
3. Instale a extensão CodeLLDB para debugging

code --install-extension rust-lang.rust-analyzer
code --install-extension vadimcn.vscode-lldb

Windows Terminal (Recomendado)

O Windows Terminal é muito melhor que o CMD clássico para desenvolvimento:

# Instalar via winget
winget install Microsoft.WindowsTerminal

Usar a Toolchain GNU (Alternativa)

Se precisar da toolchain GNU (MinGW):

# Instalar MSYS2
winget install MSYS2.MSYS2

# Depois, no MSYS2:
pacman -S mingw-w64-x86_64-gcc

# Instalar a toolchain GNU no rustup
rustup toolchain install stable-x86_64-pc-windows-gnu
rustup default stable-x86_64-pc-windows-gnu

Alternativa: WSL

Se você prefere um ambiente Linux no Windows, considere usar o WSL (Windows Subsystem for Linux). Temos um guia dedicado para Rust no WSL com instruções detalhadas.

Ferramentas Adicionais

# Auditoria de segurança
cargo install cargo-audit

# Recompilação automática
cargo install cargo-watch

# Gerenciador de versões mais rápido
cargo install cargo-binstall

Solução de Problemas

Erro: “link.exe not found” ou “MSVC not found”

O Visual Studio Build Tools não está instalado ou configurado corretamente:

1. Abra o Visual Studio Installer
2. Clique em Modificar no Build Tools
3. Certifique-se de que “Desenvolvimento para desktop com C++” está selecionado
4. Reinicie o terminal após a instalação

Erro: “error: process didn’t exit successfully” com status 0xc0000135

Faltam as Visual C++ Redistributables:

winget install Microsoft.VCRedist.2015+.x64

Antivírus bloqueando a compilação

Alguns antivírus (como o Windows Defender) podem interferir na compilação Rust. Adicione exclusões:

1. Abra Segurança do Windows > Proteção contra vírus e ameaças
2. Em Configurações, clique em Gerenciar configurações
3. Em Exclusões, adicione:
   • %USERPROFILE%\.cargo
   • %USERPROFILE%\.rustup
   • A pasta do seu projeto (ex: C:\Users\SeuNome\projetos)

Próximos Passos

Com o Rust instalado no Windows:

• Siga o tutorial de Primeiros Passos com Rust
• Consulte o Cheatsheet Rust para referência rápida
• Configure CI/CD com GitHub Actions para seus projetos
• Aprenda sobre Cross-Compilation para compilar para Linux
• Veja as Perguntas Frequentes para dúvidas comuns

Se você também programa em Go no Windows, visite o golang.com.br para guias em português.

Última atualização: 23 de fevereiro de 2026. Para desinstalar o Rust, veja Como Desinstalar Rust.