---
title: "Instalar Rust no Windows 10/11"
url: "https://rustlang.com.br/instalacao/windows/"
markdown_url: "https://rustlang.com.br/instalacao/windows.MD"
description: "Guia completo para instalar Rust no Windows com Visual Studio Build Tools, MSVC vs GNU toolchain, rustup-init.exe e configuração de PATH."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# Instalar Rust no Windows 10/11

Guia completo para instalar Rust no Windows com Visual Studio Build Tools, MSVC vs GNU toolchain, rustup-init.exe e configuração de PATH.


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](/instalacao/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/](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:

| Toolchain | Target | Uso Recomendado |
|-----------|--------|-----------------|
| **MSVC** | `x86_64-pc-windows-msvc` | Padrão e recomendado. Compatível com o ecossistema Windows. |
| **GNU** | `x86_64-pc-windows-gnu` | Usa MinGW. Útil para portar código Linux. |

**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](https://www.rust-lang.org/tools/install)
2. Baixe o `rustup-init.exe` (64-bit)
3. Execute o arquivo baixado

Ou via PowerShell:

```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](/instalacao/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:

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

Se o PATH não foi configurado automaticamente:

```powershell
# 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:

```powershell
rustc --version
cargo --version
rustup show
```

Saída esperada:

```
rustc 1.83.0 (stable)
cargo 1.83.0
```

## Criar Seu Primeiro Projeto

```powershell
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](/tutoriais/primeiros-passos/).

## Configurar o VS Code

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

1. Instale o [VS Code](https://code.visualstudio.com/)
2. Abra o VS Code e instale a extensão **rust-analyzer**
3. Instale a extensão **CodeLLDB** para debugging

```powershell
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:

```powershell
# Instalar via winget
winget install Microsoft.WindowsTerminal
```

## Usar a Toolchain GNU (Alternativa)

Se precisar da toolchain GNU (MinGW):

```powershell
# 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](/instalacao/wsl/) com instruções detalhadas.

## Ferramentas Adicionais

```powershell
# 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:

```powershell
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](/tutoriais/primeiros-passos/)
- Consulte o [Cheatsheet Rust](/cheatsheet/) para referência rápida
- Configure [CI/CD com GitHub Actions](/instalacao/github-actions/) para seus projetos
- Aprenda sobre [Cross-Compilation](/instalacao/cross-compilation/) para compilar para Linux
- Veja as [Perguntas Frequentes](/faq/) para dúvidas comuns

Se você também programa em Go no Windows, visite o [golang.com.br](https://golang.com.br) para guias em português.

---

*Última atualização: 23 de fevereiro de 2026. Para desinstalar o Rust, veja [Como Desinstalar Rust](/instalacao/desinstalar/).*