Como configurar corretamente o WSL2 para funcionar com Linux no Windows

Última atualização: 27/11/2025

  • O WSL2 integra distribuições Linux reais no Windows, com kernel completo e suporte completo a chamadas de sistema.
  • A instalação é simplificada com o comando `wsl --install`, que habilita os componentes, instala o kernel e configura o Ubuntu por padrão.
  • A combinação de WSL2, Windows Terminal e VS Code permite um ambiente de desenvolvimento quase idêntico ao de produção.
  • O WSL2 melhora significativamente o uso do Docker, de bancos de dados e de ferramentas Linux, mantendo a praticidade da área de trabalho do Windows.
WSL2 para trabalhar com Linux no Windows

Se você programa em Windows, mas implanta em servidores Linux, provavelmente já se deparou mais de uma vez com diferenças de ambiente, bibliotecas que só falham em produção ou o Docker funcionando de forma errática. O WSL foi criado justamente para evitar esse pesadelo, e com WSL2 A Microsoft finalmente acertou em cheio: Um Linux quase nativo, integrado ao Windows. e sem precisar configurar uma máquina virtual complexa.

Essa já é a opção preferida de milhares de desenvolvedores, pois permite abrir um terminal Ubuntu, Debian ou Kali no Windows 10 ou 11, executar comandos, Docker, bancos de dados ou ferramentas de linha de comando como se estivesse em um servidor Linux, sem abrir mão dos seus aplicativos e jogos do Windows. Vamos ver como funciona, como instalar, como difere do WSL1 e como tirar o máximo proveito dele no seu dia a dia.

O que é o WSL e por que ele muda a vida de um desenvolvedor Windows?

 

WSL é a sigla para Subsistema Windows para LinuxO subsistema que permite executar distribuições GNU/Linux no Windows sem a necessidade de uma máquina virtual tradicional ou dual boot. Você pode instalar Ubuntu, Debian, Kali, openSUSE, Arch (usando appx) ou outras distribuições e usar suas ferramentas de console diretamente da sua área de trabalho do Windows.

Ao contrário do WSL1, WSL2 Ele usa um kernel Linux real. Ele é executado em uma máquina virtual leve gerenciada pelo Windows (Hyper-V e a plataforma de máquina virtual), com suporte completo para chamadas de sistema ELF64. O WSL1 era uma camada de tradução de sistema, rápida para certas tarefas, mas com sérias limitações de compatibilidade, especialmente com ferramentas como o Docker.

Para desenvolvedores web, desenvolvedores backend, especialistas em DevOps ou em dados, isso significa que você pode Trabalhar em um ambiente quase idêntico ao ambiente de produção. (que na maioria dos casos é Linux), usando as mesmas bibliotecas, gerenciadores de banco de dados, filas, servidores de mensagens, etc., sem abandonar o Windows. O clássico "funciona na minha máquina" é coisa do passado, porque você desenvolve no Windows e implanta em uma distribuição Linux completamente diferente.

O WSL2 não é um ambiente gráfico completo para Linux. Semelhante a uma máquina virtual GNOME ou KDE, a interface principal é o terminal. No entanto, atualmente também é possível executar aplicativos GUI do Linux no WSL2 e até mesmo aproveitar a aceleração por GPU para cargas de trabalho como aprendizado de máquina ou gráficos avançados. Se precisar acessar aplicativos remotamente, você pode configurar o WSL2. Área de Trabalho Remota do Chrome no Windows.

WSL2

Windows vs Linux: o clássico problema do ambiente de desenvolvimento

O Windows continua sendo o sistema operacional mais instalado em computadores de mesa.Embora a maioria das implantações de aplicativos de produção seja feita em Linux, essa dualidade sempre gerou conflitos para os desenvolvedores que trabalham no Windows, mas mantêm ou implantam aplicativos em servidores Linux.

Tradicionalmente, os usuários do macOS têm experimentado menos atrito. Como o macOS compartilha uma base semelhante ao Unix e muitas ferramentas se comportam de maneira similar ao Linux, esse foi um dos motivos pelos quais tantos desenvolvedores migraram para o Mac anos atrás: eles buscavam um terminal decente e ambientes mais próximos da produção.

O grande ponto de virada aconteceu com DockerOs contêineres tornaram-se essenciais para o desenvolvimento e a implantação, mas no Windows, o desempenho e a experiência do usuário eram bastante precários, com camadas de compatibilidade ineficientes. O WSL2 resolve muitos desses problemas, oferecendo um ambiente onde o Docker funciona muito melhor.

Conteúdo exclusivo - Clique aqui  Como remover a barra de jogos do Windows 11

WSL1 vs WSL2: diferenças e por que você deve usar a versão 2.

O WSL existe em duas versões principais: WSL1 e WSL2Embora ambos permitam executar Linux no Windows, a arquitetura de um para o outro mudou bastante, e isso é perceptível no desempenho e na compatibilidade.

  • O WSL1 traduz chamadas de sistema do Linux. para o kernel do Windows. Isso resulta em tempos de inicialização muito rápidos e boa integração de arquivos, mas tem compatibilidade limitada com alguns aplicativos, especialmente aqueles que precisam de um kernel Linux real, como certos mecanismos de banco de dados ou o Docker em plena capacidade.
  • O WSL2 utiliza uma máquina virtual leve com um kernel Linux completo.Gerenciado pelo Windows. Oferece total compatibilidade com chamadas de sistema, desempenho aprimorado do sistema de arquivos (especialmente no próprio sistema de arquivos Linux) e habilita recursos avançados, como Docker nativo no WSL2 e acesso direto ao kernel.
  • Ambas as versões compartilham algumas características.Suas vantagens incluem integração com o Windows, inicialização rápida, compatibilidade com ferramentas de virtualização como VMWare ou VirtualBox (em versões recentes) e suporte a múltiplas distribuições. No entanto, somente o WSL2 possui um kernel Linux completo e suporte total a chamadas de sistema.

Por todo o interior, A opção recomendada atualmente é usar o WSL2.A menos que você tenha um motivo muito específico para continuar usando o WSL1. O Docker Desktop, por exemplo, foi projetado para se integrar ao WSL2, e muitos guias e ferramentas modernas já consideram essa versão como padrão.

WSL2

Requisitos para instalar o WSL2 no Windows 10 e no Windows 11

Para usar o WSL2, você precisa de uma versão relativamente recente do Windows. Em geral, você deve atender às seguintes condições:

  • Windows 10 versão 2004 ou posterior (compilação 19041+) para usar o comando simplificado wsl --install.
  • Especificamente para o WSL2, Windows 10 versão 1903, compilação 18362 ou superiorou Windows 11.
  • Arquitetura de 64 bitsO WSL2 não está disponível no Windows 10 de 32 bits.

Além do mais, Você deve garantir que a virtualização esteja habilitada na BIOS. da sua equipe. Caso contrário, você poderá encontrar erros como 0x80370102Essas mensagens geralmente indicam que a virtualização de hardware não está ativa. Acesse a BIOS/UEFI, procure as opções relacionadas à CPU ou "Tecnologia de Virtualização" e habilite-as.

Instale o WSL2 do zero usando o comando wsl --install

Nas versões modernas do Windows 10 e do Windows 11, a instalação foi bastante simplificada: agora requer apenas um comando e uma reinicialização.

1. Abra o PowerShell como administradorProcure por “PowerShell” no menu Iniciar, clique com o botão direito do mouse e selecione “Executar como administrador”. Aceite a solicitação do Controle de Conta de Usuário (UAC) se ela aparecer.

2. Execute o comando de instalação completo.:

Comando: wsl --install

Este comando executa várias etapas internas sem que você precise mexer em mais nada:

  • Ative os componentes opcionais necessários: Subsistema Windows para Linux y Plataforma de máquina virtual.
  • Baixe e instale o kernel Linux mais recente para WSL.
  • Configurar WSL2 como versão padrão.
  • Baixe e instale uma distribuição Linux padrão (normalmente Ubuntu).

3. Reinicie o computador quando o Windows solicitar.Isso é essencial para que as novas funcionalidades ativadas entrem em funcionamento.

4. Na primeira inicialização da distribuição Linux (No Ubuntu, a menos que você especifique o contrário), uma janela de console será aberta para extrair os arquivos. A primeira vez demora um pouco mais; as inicializações subsequentes costumam ser quase instantâneas.

Escolher e alterar a distribuição Linux no WSL

  • Por padrão, o comando wsl --install geralmente instala o Ubuntu como distribuição padrão. No entanto, você pode escolher uma distribuição diferente durante e após a instalação.
  • Para ver a lista de distribuições disponíveis onlineAbra o PowerShell e digite:
  • Lista: wsl.exe --list --online
  • Para instalar uma distribuição específica a partir do console, use a opção -d Indicando seu nome:
  • Instalar distribuição: wsl.exe --install -d NombreDeLaDistro
  • Se você quiser alterar a distribuição padrão (aquela que abre quando você simplesmente corre) wsl), você pode fazer:
  • Padrão: wsl.exe --set-default NombreDeLaDistro
  • E se você quiser apenas lançar uma distribuição específica de forma pontual? Sem alterar a configuração padrão, utilize:
  • Lançamento no prazo: wsl.exe --distribution NombreDeLaDistro

Além das distribuições da Microsoft Store, É possível importar distribuições personalizadas a partir de um arquivo TAR ou instalar pacotes. .appx em alguns casoscomo o Arch Linux. Você pode até criar suas próprias imagens WSL personalizadas para padronizar ambientes dentro de uma empresa.

Conteúdo exclusivo - Clique aqui  A Microsoft encerra as portas para a ativação do Windows 11 sem internet.

wsl2

Configure seu nome de usuário e senha do Linux no WSL.

Na primeira vez que você abrir sua distribuição Linux instalada com o WSLVocê será solicitado a criar um nome de usuário e uma senha do UNIX. Essa conta será o usuário padrão para essa distribuição.

Tenha em mente alguns detalhes importantes sobre este usuário:

  • Não está vinculado à sua conta de usuário do Windows.Você pode (e é recomendável) usar um nome diferente.
  • Ao digitar a senha, nada será exibido na tela. (Sem asteriscos). Isso é conhecido como entrada "cega", o que é perfeitamente normal no Linux.
  • Esse usuário é considerado um administrador nessa distribuição. e pode usar sudo Para executar comandos com privilégios elevados.
  • Cada distribuição tem seu próprio conjunto de usuários. e senhas; se você adicionar uma nova distribuição, terá que repetir o processo de criação da conta.

Se você gostar alterar a senha Em seguida, abra a distribuição e execute: Alterar a senha: passwd

Se você esqueceu a senha de um usuário da distribuição Mas se você ainda tiver acesso de administrador no Windows, poderá recuperar o controle desta forma:

  1. Abra o Prompt de Comando ou o PowerShell como administrador. e faça login como root na distribuição padrão:
    wsl -u root
    Para uma distribuição específica:
    wsl -d NombreDistro -u root
  2. Dentro desse terminal raiz, corre:
    passwd nombre_usuario e defina a nova senha.
  3. Saia da sua conta WSL com exit e faça login normalmente com a conta de usuário recuperada.

Formas de inicializar e usar suas distribuições Linux no Windows

Depois de instalar várias distribuiçõesVocê pode abri-los de diferentes maneiras, dependendo do que for mais conveniente para você em determinado momento.

  • Terminal do Windows (recomendado). O Windows Terminal é o emulador de terminal moderno da Microsoft. Cada vez que você instala uma nova distribuição Linux no WSL, um novo perfil aparece no Windows Terminal, que você pode personalizar (ícone, esquema de cores, comando de inicialização, etc.). É a maneira mais conveniente de trabalhar com várias linhas de comando simultaneamente.
  • A partir do menu Iniciar. Você pode digitar o nome da distribuição (“Ubuntu”, “Debian”, “Kali Linux”...). Clicar nela a abrirá diretamente em sua própria janela de console.
  • A partir do PowerShell ou do CMD. Você pode digitar diretamente o nome da distribuição (por exemplo, ubuntu) ou use o comando genérico:
    wsl para entrar na distribuição padrão, ou
    wsl -d NombreDistro Para inserir um específico.
  • Executar um comando específico do Linux a partir do Windows. Use a sintaxe:
    wsl
    Por exemplo: wsl ls -la, wsl pwd, wsl dateetc. Dessa forma, você combina comandos do Windows e do Linux no mesmo pipeline.

Terminal do Windows

Windows Terminal: o companheiro perfeito para o WSL2

Para tirar o máximo proveito do WSL2, vale a pena instalar Terminal do Windows Disponível na Microsoft Store, ele é muito mais prático e poderoso do que o Prompt de Comando clássico ou mesmo a janela padrão do PowerShell.

O Terminal do Windows permite Criar perfis para cada distribuição.Defina qual terminal será aberto por padrão (PowerShell, CMD, Ubuntu, etc.), use abas, painéis divididos, diferentes temas de cores, fontes personalizadas, imagens de fundo e atalhos de teclado avançados.

Conteúdo exclusivo - Clique aqui  A OpenAI adicionará controles parentais ao ChatGPT com contas familiares, avisos de risco e limites de uso.

Para muitos desenvolvedores no WindowsO Windows Terminal + WSL2 é a combinação que mais se aproxima da experiência de trabalho de um sistema Linux nativo ou de um macOS com um terminal avançado, sem sair do seu ambiente Windows habitual.

Configurando seu ambiente de desenvolvimento: VS Code, Visual Studio, Git e bancos de dados.

Assim que o WSL2 estiver instalado e funcionando, o próximo passo lógico é Integre seu editor ou IDE favorito. Nesse ambiente, a Microsoft investiu muito esforço para que o Visual Studio Code e o Visual Studio funcionem perfeitamente com o WSL.

VS Code

Idealmente, você deveria instalar o Pacote de Desenvolvimento RemotoEsta extensão permite abrir uma pasta localizada no WSL como se fosse um projeto local, mas executando o servidor VS Code dentro da distribuição. Basta digitar:

code .

A partir do terminal WSL, na pasta do seu projeto, o VS Code abrirá esse caminho "remoto" com todo o seu ecossistema: extensões, depuração, terminal integrado, etc., mas na verdade operando no Linux.

Visual Studio

Ele permite configurar o WSL como destino para projetos C++ usando o CMake. Você pode compilar e depurar no Windows, no WSL ou em máquinas remotas, alternando o destino diretamente na IDE.

Em relação ao controle de versão, usar o Git no WSL é tão simples quanto instalá-lo com o gerenciador de pacotes da sua distribuição (por exemplo, sudo apt install git (no Ubuntu) e configure credenciais, arquivos de exclusão, finais de linha, etc. Você também pode usar o Gerenciador de Credenciais do Windows para integrar a autenticação.

Configurando bancos de dados no WSL A instalação de serviços como MySQL, PostgreSQL, MongoDB, Redis, SQL Server, SQLite, etc., é muito semelhante à de qualquer servidor Linux. Você pode iniciar os serviços dentro da distribuição ou usar contêineres Docker no WSL2 e, em seguida, conectar seus aplicativos a partir do Windows ou do próprio WSL, dependendo das suas necessidades.

Gerenciamento de unidades externas, interface gráfica e backups de distribuições.

O WSL2 também permite montar discos externos ou unidades USB diretamente no ambiente Linux. Existe documentação específica para montar discos com o comando. wsl --mountIsso oferece muita flexibilidade ao trabalhar com dados que você possui em outras unidades.

Se você gostar executar aplicativos gráficos do Linux Agora é possível usar a interface gráfica do usuário (GUI) no WSL2 graças ao suporte da Microsoft para aplicativos com GUI. Isso permite abrir editores gráficos, ferramentas de design ou ambientes de desktop leves sem precisar inicializar uma máquina virtual tradicional.

Pendência backups ou migração de uma distribuição completa para outro computadorO WSL inclui dois comandos muito úteis:

  • Exportar uma distribuição:
    wsl --export NombreDistro backup-wsl.tar
    Isso gera um arquivo TAR com todo o seu sistema de arquivos.
  • Importar uma distribuição:
    wsl --import NombreDistro C:\ruta\destino backup-wsl.tar --version 2
    Isso restaura a distribuição com todo o seu conteúdo em outro caminho e, se desejar, garante que ela utilize o WSL2.

Esse mecanismo de exportação/importação é muito conveniente para clonar ambientes de desenvolvimento, compartilhá-los com colegas ou simplesmente manter um backup de segurança antes de fazer alterações importantes.

O WSL2 se consolidou como o principal ambiente de desenvolvimento. Para muitos usuários do Windows que não querem abrir mão de jogos, softwares específicos ou de seu fluxo de trabalho no sistema, mas precisam de um ambiente Linux completo para programação, experimentar o WSL2 pode ser uma mudança radical na forma como trabalham.

Como usar o PhotoPrism como uma galeria privada com inteligência artificial em seu computador local.
Artigo relacionado:
Como usar o PhotoPrism como uma galeria privada com inteligência artificial em seu computador local.