---
title: "Instalar Rust no WSL (Windows Subsystem for Linux)"
url: "https://rustlang.com.br/instalacao/wsl/"
markdown_url: "https://rustlang.com.br/instalacao/wsl.MD"
description: "Guia completo para instalar Rust no WSL2 com Ubuntu, configurar VS Code Remote, cross-compilation e dicas para desenvolvimento produtivo."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# Instalar Rust no WSL (Windows Subsystem for Linux)

Guia completo para instalar Rust no WSL2 com Ubuntu, configurar VS Code Remote, cross-compilation e dicas para desenvolvimento produtivo.


O **WSL (Windows Subsystem for Linux)** permite executar um ambiente Linux completo dentro do Windows, combinando o melhor dos dois mundos. É uma excelente opção para desenvolver em Rust com ferramentas Linux, mantendo a interface gráfica do Windows. Neste guia, vamos configurar o Rust no **WSL2** com Ubuntu.

## Instalar e Configurar o WSL2

Se você ainda não tem o WSL2, instale-o pelo PowerShell (como Administrador):

```powershell
wsl --install
```

Isso instala o **WSL2 com Ubuntu** por padrão. Reinicie o computador quando solicitado.

### Verificar a Versão do WSL

```powershell
wsl --list --verbose
```

Certifique-se de que a versão é **2** (WSL2). Se for 1, atualize:

```powershell
wsl --set-version Ubuntu 2
```

### Configurar o Ubuntu no WSL

Na primeira execução, defina usuário e senha. Depois, atualize o sistema:

```bash
sudo apt update && sudo apt upgrade -y
```

## Instalar Dependências de Compilação

Dentro do WSL (terminal Ubuntu):

```bash
sudo apt install -y build-essential curl gcc make pkg-config libssl-dev git
```

## Instalar Rust com Rustup

Execute o instalador oficial dentro do WSL:

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

Escolha a opção **1** para instalação padrão. Configure o PATH:

```bash
source "$HOME/.cargo/env"
```

Verifique a instalação:

```bash
rustc --version
cargo --version
rustup show
```

Para detalhes sobre o gerenciamento de toolchains, consulte o [Guia Completo do Rustup](/instalacao/rustup/).

## Configurar o VS Code com WSL Remote

O VS Code tem suporte nativo para desenvolvimento via WSL. Veja o [guia completo de VS Code para Rust](/instalacao/vscode/) para configuração detalhada. Aqui está o resumo:

1. **No Windows**, instale o VS Code e a extensão **WSL** (ms-vscode-remote.remote-wsl)

2. **No WSL**, abra o VS Code diretamente:
```bash
code .
```

3. O VS Code se conectará automaticamente ao WSL. Instale a extensão **rust-analyzer** dentro do WSL (ela aparecerá como "Install in WSL"):
```bash
code --install-extension rust-lang.rust-analyzer
```

> **Dica:** O VS Code Remote-WSL executa o servidor de linguagem dentro do WSL, então o rust-analyzer tem acesso direto aos arquivos e ferramentas do Linux.

## Onde Armazenar os Projetos

**Sempre armazene seus projetos dentro do filesystem do WSL**, não no `/mnt/c/`:

```bash
# BOM: Dentro do WSL (rápido)
mkdir -p ~/projetos
cd ~/projetos
cargo new meu-projeto

# RUIM: No drive do Windows (lento, 10-100x mais lento)
cd /mnt/c/Users/SeuNome/projetos  # NÃO FAÇA ISSO
```

O acesso ao filesystem do Windows via `/mnt/c/` é significativamente mais lento devido à camada de tradução de filesystem. Isso afeta diretamente o tempo de compilação do Rust.

## Criar e Executar um Projeto

```bash
cd ~/projetos
cargo new hello-wsl
cd hello-wsl
cargo run
```

Para entender melhor os comandos disponíveis, veja o [Guia Completo do Cargo](/instalacao/cargo/).

## Cross-Compilation: WSL para Windows

Uma vantagem do WSL é poder compilar tanto para Linux quanto para Windows:

### Compilar para Linux (nativo no WSL)

```bash
cargo build --release
# Gera: target/release/meu-app (binário Linux ELF)
```

### Compilar para Windows (cross-compilation)

```bash
# Instalar o target Windows
rustup target add x86_64-pc-windows-gnu

# Instalar o cross-compiler
sudo apt install -y gcc-mingw-w64-x86-64

# Compilar para Windows
cargo build --release --target x86_64-pc-windows-gnu
# Gera: target/x86_64-pc-windows-gnu/release/meu-app.exe
```

O executável `.exe` pode ser executado diretamente no Windows:

```bash
# Executar no Windows a partir do WSL
/mnt/c/Users/SeuNome/Desktop/meu-app.exe
# ou
cmd.exe /c "target/x86_64-pc-windows-gnu/release/meu-app.exe"
```

Para cenários mais avançados, veja o guia de [Cross-Compilation em Rust](/instalacao/cross-compilation/).

## Otimizar o Desempenho do WSL2

### Limitar Recursos do WSL2

Crie o arquivo `%USERPROFILE%\.wslconfig` no Windows:

```ini
[wsl2]
memory=8GB
processors=4
swap=4GB
```

### Usar Compilação Incremental

No WSL, o Rust já usa compilação incremental por padrão. Para projetos grandes, considere o linker `mold`:

```bash
sudo apt install -y mold
```

Adicione ao `~/.cargo/config.toml`:

```toml
[target.x86_64-unknown-linux-gnu]
linker = "clang"
rustflags = ["-C", "link-arg=-fuse-ld=mold"]
```

## Docker dentro do WSL

O WSL2 suporta Docker nativamente. Instale o Docker Desktop no Windows com integração WSL2, ou instale diretamente no WSL:

```bash
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
```

Combine com o [guia de Rust com Docker](/instalacao/docker/) para builds containerizadas.

## Solução de Problemas

### Compilação muito lenta

Certifique-se de que seus projetos estão no filesystem do WSL, não em `/mnt/c/`. A diferença de performance pode ser de 10-100x.

```bash
# Verificar onde você está
pwd
# Deve ser /home/usuario/..., NÃO /mnt/c/...
```

### Erro: "Permission denied" ao executar binários

```bash
chmod +x target/debug/meu-app
```

### VS Code não encontra o rust-analyzer

Certifique-se de instalar a extensão dentro do contexto WSL (não localmente no Windows). No VS Code, veja o canto inferior esquerdo — deve mostrar "WSL: Ubuntu".

## Próximos Passos

Com o Rust configurado no WSL:

- 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/)
- Compare com a [instalação nativa no Windows](/instalacao/windows/)
- Veja as [Perguntas Frequentes](/faq/) para mais dúvidas

Se você desenvolve com múltiplas linguagens no WSL, confira o [golang.com.br](https://golang.com.br) para configurar Go no mesmo ambiente.

---

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