Configurando um ambiente de desenvolvimento com WSL no Windows

Se você programa no Windows e deseja aproveitar as ferramentas e fluxos de trabalho de Linux sem máquinas virtuais pesadas ou Bota dual, WSL é seu melhor aliadoCom o Subsistema Windows para Linux, você pode instalar distribuições como Ubuntu, Debian ou openSUSE e executar utilitários, shells e servidores como se estivessem no Linux nativo, mas integrados ao Windows.

Neste guia, explico, passo a passo, como configurar um ambiente de desenvolvimento moderno com WSL: instalação rápida, seleção de distribuição, gerenciamento de versão do WSL, nome de usuário e senha, boas práticas de armazenamento, Terminal, VS Code/Visual Studio, Git, Docker, bancos de dados, aceleração de GPU, aplicativos gráficos Linux e comandos de teclas.Além disso, você aprenderá a personalizar seu shell com Zsh e gerenciar o Node.js com nvm para trabalhar com várias versões sem complicações.

Pré-requisitos e verificação da versão do Windows

O WSL é executado nativamente no Windows 10 versão 2004 (compilação 19041) ou superior e em Windows 11. Se não tiver certeza da sua versão, pressione Windows + R, digite winver e confirme se sua compilação é compatível.

Para usar o comando de instalação simplificado wsl --install É recomendável ter compilações recentes (Windows 10 20262+ ou Windows 11 atual)Caso esteja faltando alguma atualização, você pode fazê-lo nas Configurações ou com o Assistente do Windows Update.

Se o seu computador não for compatível com WSL 2, ative a virtualização no BIOS/UEFI e certifique-se de que o recurso "Plataforma de Máquina Virtual" esteja disponível no Windows.Em computadores provenientes de instalações manuais mais antigas, pode ser necessário atualizar o kernel WSL Linux.

Instalação WSL ultrarrápida

A maneira mais direta é abrir PowerShell o Símbolo do sistema como administrador e executar:

wsl --install

Este comando habilita os componentes WSL e Virtual Machine Platform, baixa o kernel do Linux, define o WSL 2 como padrão e instala o Ubuntu automaticamente.. O Windows pode solicitar que você reinicie para concluir a instalação.

Se preferir outra distribuição, você pode especificá-la na instalação com:

wsl --install -d <NombreDeLaDistro>

Para visualizar o catálogo disponível online utilize:

wsl --list --online

Em computadores mais antigos ou se você quiser um controle mais refinado, você tem a opção de seguir a instalação manual dos Recursos do Windows ou importar um TAR com uma distribuição personalizada. Ainda assim, para a maioria dos usuários, o atalho com --install É a maneira mais confortável.

Primeira inicialização: nome de usuário e senha do Linux

Após a instalação, abra a distribuição no menu Iniciar (Ubuntu por padrão) e crie seu nome de usuário e senha do Linux.. Essas credenciais são independentes da sua conta do Windows.

A senha é digitada “às cegas” (você não verá nada ao digitar), isso é completamente normal.. Uma vez criada, sua conta será a padrão e terá permissões administrativas por meio sudo.

Lembre-se de que cada distribuição tem suas próprias contasSe você instalar, reinstalar ou adicionar novas distros, repita esse processo para cada uma delas.

Esqueceu sua senha? Abra o PowerShell e digite como raiz na distribuição padrão:

wsl -u root

Se você precisar de outra distribuição específica, indique o nome dela.:

wsl -d Debian -u root

Dentro da sessão root redefina a senha do usuário com:

passwd <usuario>

Quando você vir a mensagem de senha atualizada com sucesso, saia com:

exit

Atualizações e manutenção de pacotes

O Windows não atualiza automaticamente os pacotes de distribuição, então é uma boa ideia fazer isso de tempos em tempos.. No Ubuntu/Debian:

sudo apt update && sudo apt upgrade

Manter seu sistema atualizado evita erros bobos e problemas de compatibilidade com ferramentas de desenvolvimento.. É uma rotina básica recomendada após a primeira partida.

Escolha, adição e gerenciamento de distribuições

Você pode instalar distros da Microsoft Store, com wsl --install -d ou importá-los no formato TAR para cenários personalizados. O WSL não limita o número de distros: use quantas precisar.

Para listar as distros instaladas e ver sua versão WSL (1 ou 2), execute:

wsl -l -v

Se você deseja que novas instalações usem uma versão específica por padrão:

wsl --set-default-version 2

Para alterar a versão de uma distribuição específica:

wsl --set-version <NombreDistro> 2

Você também pode escolher qual distribuição será usada por padrão ao invocar wsl:

wsl -s <NombreDistro>

E para inicializar uma distribuição específica diretamente sem alterar o padrão:

wsl -d <NombreDistro>

Terminal Windows: A experiência ideal para vários consoles

O Terminal do Windows traz guias, painéis, aceleração de GPU, Unicode/UTF-8 e personalização de atalhos, cores e temas. Se você vai viver com vários shells (PowerShell, CMD, várias distribuições WSL, Azure CLI…), você o achará muito confortável.

Toda vez que você instalar uma nova distribuição, o Windows Terminal a detectará e você poderá ajustar seu perfil conforme sua preferência.. É a combinação perfeita para WSL se você trabalha com várias linhas de comando.

Armazenamento e desempenho de arquivos

Abra o diretório WSL atual no Explorador de Arquivos com:

explorer.exe .

Regra de ouro: salve os projetos no sistema de arquivos do SO cujas ferramentas você usaráSe você estiver trabalhando com ferramentas Linux (gcc, node, python, etc.) no terminal WSL, salve no WSL FS.

Rotas recomendadas no WSL:

• WSL: \\wsl$\<NombreDistro>\home\<Usuario>\Proyecto
• Evita: C:\Users\<Usuario>\Proyecto o /mnt/c/Users/<Usuario>/Proyecto se você compilar/executar com ferramentas Linux devido ao impacto no desempenho.

O acesso cruzado entre Windows e Linux existe, mas pode penalizar severamente o desempenho em tarefas intensivas.. Ajuste onde você salva com base no seu fluxo de trabalho.

Editor de código: VS Code e Visual Studio

O Visual Studio Code com a extensão Remote Development transforma o WSL em um ambiente de desenvolvimento completo. Uma vez instalado, no terminal da distribuição abra seu projeto com:

code .

Você trabalhará “dentro” da distribuição com todo o ecossistema de extensões, depuração e terminal integrado. Além disso, você pode alternar entre ambientes (WSL, SSH ou contêineres) em segundos.

Para C++ multiplataforma, o Visual Studio 2022 integra projetos CMake com conexões WSL e SSH na mesma instância.Se sua pilha for C++ nativa, vale a pena.

Git e gerenciamento de credenciais

Instale o Git na distribuição e configure o nome e o e-mail:

sudo apt install -y git
git config --global user.name "Tu Nombre"
git config --global user.email "tu@correo.com"

Em projetos híbridos Windows/WSL, confie no Gerenciador de Credenciais do Windows e/ou nos recursos integrados do VS Code.. Verifique também o tratamento de terminações de linha (LF/CRLF) e seu .gitignore para evitar surpresas.

Contêineres com Docker no WSL 2

O Docker Desktop integra-se com o WSL 2, permitindo que você execute contêineres Linux com desempenho quase nativoVocê pode abrir o projeto como “Remoto – Contêineres” no VS Code e desenvolver dentro do contêiner.

Essa configuração facilita a criação de equipes com ambientes reproduzíveis e isola dependências sem bagunçar a distribuição base.. Ideal para pilhas complexas ou microsserviços.

Bancos de dados em WSL

O WSL é um ambiente perfeito para configurar MySQL, PostgreSQL, MongoDB, Redis, SQLite ou mesmo SQL Server para Linux. Instale-os a partir do gerenciador de pacotes da sua distribuição ou seguindo os guias oficiais de cada mecanismo.

Ao trabalhar o aplicativo e a base dentro do WSL você reduz latências e evita problemas de compatibilidade entre sistemas operacionais.Se precisar expor portas para o Windows, você pode se conectar a partir de clientes nativos sem complicações.

Aceleração de GPU e cargas de trabalho exigentes

O WSL permite que você aproveite a GPU do seu computador para acelerar tarefas de computação, como treinar modelos de aprendizado de máquina.. Com o Drivers adequado e WSL 2, você notará melhorias claras no desempenho.

Se seu trabalho envolver CUDA, TensorFlow, PyTorch ou OpenCL, verifique os requisitos de driver e versão.. Vale a pena se o seu streaming exige muita GPU.

Aplicações GUI Linux no Windows

O WSL suporta aplicativos gráficos Linux, para que você possa abrir editores ou utilitários com um front-end diretamente no Windows.. É conveniente para ferramentas de nicho que só existem no Linux.

A integração do Windows é perfeita: eles se comportam como aplicativos de desktop dentro do Windows.. Útil para fluxos onde você combina CLI com utilitários GUI específicos.

Comandos essenciais e interoperabilidade Windows/Linux

Uma das grandes vantagens do WSL é combinar comandos de ambos os mundos em uma única linha.. Alguns exemplos úteis:

• Lista com Linux do PowerShell: wsl ls -la
• Misturando Linux e Windows: wsl ls -la | findstr "git" o dir | wsl grep git
• Abra as ferramentas do Windows a partir do WSL: notepad.exe .bashrc
• Filtrar IP com utilitários cruzados:
  • No Bash: ipconfig.exe | grep IPv4 | cut -d: -f2
  • No PowerShell com WSL: ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2

Para alterar as distros rapidamente do Windows sem alterar o padrão, lembre-se de que wsl -d <NombreDistro> abre aquela distribuição pontual. Se você quiser sair de uma sessão incorporada, digite exit.

Montar unidades externas ou USB no WSL

O WSL 2 permite a montagem de unidades externas, USB ou Partições Linux. Depois de identificar a rota, você pode montá-la com o comando mount da WSL e trabalhar com seu conteúdo.

É conveniente para copiar dados, analisar discos ou reutilizar mídia de desenvolvimento sem sair do ambiente.. Desmonte quando terminar para evitar bloqueios.

Maneiras de abrir e alternar entre suas distribuições

Você pode iniciar a distribuição a partir do menu Iniciar (digite, por exemplo, “Ubuntu”), do PowerShell/CMD digitando seu nome ou com wsl.exe para abrir o padrão. Ajuste o método ao que for mais confortável para você.

Para obter informações rápidas sobre o status do WSL, use wsl [comando] das janelas, por exemplo wsl -l -v para listar distros e versões ou wsl pwd para ver a rota atual montada.

Prévias e atualizações da WSL

Se você gosta das novidades, pode participar do Windows Insider (canal Dev, Beta ou Preview) para receber os recursos mais recentes do WSL.A estabilidade varia de acordo com o canal, escolha com base em suas necessidades.

Sem mudar de canal você pode experimentar a prévia do WSL com:

wsl --update --pre-release

Consulte as notas de versão do WSL para ver as alterações e os requisitos de cada compilação.Em ambientes de trabalho, avalie o risco antes de testar as visualizações.

Personalize seu terminal: Zsh, Oh My Zsh e temas

Para uma experiência mais produtiva, instale o Zsh e o Oh My Zsh com temas e plugins que melhoram a sugestão automática, a coloração e os avisos.. No Ubuntu/Debian:

sudo apt update && sudo apt install -y zsh curl git

Faça do Zsh seu shell padrão:

chsh -s $(which zsh)

Instalar Oh My Zsh (via curl):

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Para o tópico Powerlevel10k:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Ative-o editando ~/.zshrc e estabelecendo:

ZSH_THEME="powerlevel10k/powerlevel10k"

Plugins recomendados: acrescenta em plugins=(...) de ~/.zshrc:

• git
• zsh-autosugestões

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

• zsh-sintaxe-destaque

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Após salvar as alterações em ~/.zshrc, reinicie o terminal ou execute source ~/.zshrc para aplicar configurações. Ajuste fontes e símbolos se o tema exigir.

Node.js no WSL 2 com nvm (várias versões)

Para trabalhar com várias versões do Node.js sem conflitos, use nvm (Node Version Manager). Instale o nvm com:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Cierra y abre la terminal o:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Instale o Node.js (LTS ou uma versão específica) e verifique as versões:

nvm install --lts
node -v
npm -v

Liste e troque versões sempre que precisar:

nvm ls
nvm install 22
nvm alias default 22
nvm use 22

Com o nvm você evita “quebrar” projetos ao mudar versões e mantém um ambiente limpo para cada aplicativo.Se você estiver usando o VS Code, ele será integrado à versão ativa no terminal.

Comandos básicos do Bash para você se orientar

Uma rápida revisão dos utilitários comuns economizará seu tempo se você estiver começando a usar a linha de comando.:

• pwd: mostra a rota atual.
• ls, ls -a, ls -l: lista arquivos e opções.
• cd, cd .., cd ~: navegar entre diretórios.
• mkdir y touch: cria pastas e arquivos.
• cat: exibe o conteúdo de um arquivo.
• rm: excluir arquivos/pastas (cuidado, não há lixeira!).
• history y !número: Revise e repita os comandos anteriores.
• clear: limpar a tela.

Com essas noções básicas, você poderá avançar com confiança e se concentrar no seu projeto o mais rápido possível.A prática diária é o que consolida esses atalhos.

Diagnosticar e resolver problemas comuns

Si wsl --install Se isso falhar, verifique se há atualizações do Windows, se a virtualização está habilitada e se você pode ativar a “Plataforma de Máquina Virtual”. Em cenários legados, instale/atualize o kernel WSL manualmente.

Se a distribuição não inicializar ou travar, tente reiniciar o WSL com:

wsl --shutdown

Para problemas com permissões ou caminhos entre sistemas, verifique onde você armazena seu código e evite trabalhar com ferramentas Linux em /mnt/c Se você estiver buscando desempenho, também ajuda verificar se há software antivírus que possa interferir.

Com tudo isso, você agora tem uma base sólida para um poderoso ambiente de desenvolvimento Windows com alma Linux, desde a instalação e manutenção do WSL até a integração com VS Code/Visual Studio, Git, Docker e bancos de dados, incluindo aceleração de GPU, aplicativos gráficos e um terminal com Zsh otimizado. A partir daqui, só falta adaptar os detalhes à sua pilha e começar a produzir.