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):
wsl --install
Isso instala o WSL2 com Ubuntu por padrão. Reinicie o computador quando solicitado.
Verificar a Versão do WSL
wsl --list --verbose
Certifique-se de que a versão é 2 (WSL2). Se for 1, atualize:
wsl --set-version Ubuntu 2
Configurar o Ubuntu no WSL
Na primeira execução, defina usuário e senha. Depois, atualize o sistema:
sudo apt update && sudo apt upgrade -y
Instalar Dependências de Compilação
Dentro do WSL (terminal Ubuntu):
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:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Escolha a opção 1 para instalação padrão. Configure o PATH:
source "$HOME/.cargo/env"
Verifique a instalação:
rustc --version
cargo --version
rustup show
Para detalhes sobre o gerenciamento de toolchains, consulte o Guia Completo do 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 para configuração detalhada. Aqui está o resumo:
No Windows, instale o VS Code e a extensão WSL (ms-vscode-remote.remote-wsl)
No WSL, abra o VS Code diretamente:
code .
- O VS Code se conectará automaticamente ao WSL. Instale a extensão rust-analyzer dentro do WSL (ela aparecerá como “Install in WSL”):
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/:
# 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
cd ~/projetos
cargo new hello-wsl
cd hello-wsl
cargo run
Para entender melhor os comandos disponíveis, veja o Guia Completo do Cargo.
Cross-Compilation: WSL para Windows
Uma vantagem do WSL é poder compilar tanto para Linux quanto para Windows:
Compilar para Linux (nativo no WSL)
cargo build --release
# Gera: target/release/meu-app (binário Linux ELF)
Compilar para Windows (cross-compilation)
# 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:
# 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.
Otimizar o Desempenho do WSL2
Limitar Recursos do WSL2
Crie o arquivo %USERPROFILE%\.wslconfig no Windows:
[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:
sudo apt install -y mold
Adicione ao ~/.cargo/config.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:
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
Combine com o guia de Rust com 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.
# Verificar onde você está
pwd
# Deve ser /home/usuario/..., NÃO /mnt/c/...
Erro: “Permission denied” ao executar binários
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
- Consulte o Cheatsheet Rust para referência rápida
- Configure CI/CD com GitHub Actions
- Compare com a instalação nativa no Windows
- Veja as Perguntas Frequentes para mais dúvidas
Se você desenvolve com múltiplas linguagens no WSL, confira o 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.