Introdução ao WSL2 - Como Usar Linux no Windows
O que você vai conseguir fazer
- Preparar um ambiente Linux no Windows usando o WSL2
- Entender a diferença entre o WSL2 e uma máquina virtual
Pré-requisitos (leia estes primeiro)
O que é o WSL2?
O WSL2 (Windows Subsystem for Linux 2) permite executar um ambiente Linux completo diretamente no Windows. Você não precisa montar uma máquina virtual (software que roda um PC dentro de outro) nem um dual boot. Ele já vem com o Windows 10 (versão 2004+) e o Windows 11.
Ao contrário do WSL1, o WSL2 inclui um kernelO programa central de um sistema operacional. Faz a ponte entre hardware e software. Linux real — a parte central do sistema operacional. É por isso que Docker, systemd e praticamente todas as ferramentas Linux funcionam como esperado. Para quem está aprendendo Linux em um PC com Windows, o WSL2 é o ponto de partida mais prático hoje.
O que você pode fazer com o WSL2
- Executar Ubuntu, Debian, Fedora e outras distribuições Linux no Windows
- Executar containers Docker nativamente
- Configurar ambientes de desenvolvimento com Python, Node.js e outras ferramentas
- Escrever e executar shellUm programa interativo que interpreta os comandos digitados e os executa. scripts
- Editar arquivos Linux diretamente no VS Code via Remote - WSL
Quais são os requisitos do sistema para o WSL2?
Você precisa do Windows 10 versão 2004 (build 19041) ou posterior, ou do Windows 11. Também precisa da virtualização (VT-x / AMD-V) ligada no BIOS/UEFI — a tela de configuração que você abre enquanto o PC inicia. O UEFI é a geração mais nova do BIOS.
| Requisito | Mínimo |
|---|---|
| SO | Windows 10 versão 2004 (build 19041+) ou Windows 11 |
| Arquitetura | x64 ou ARM64 |
| Virtualização | Habilitada no BIOS/UEFI |
Verifique sua versão do Windows executando winver na caixa de diálogo Executar (Win+R).
Para verificar se a virtualização está ligada, abra o Gerenciador de Tarefas com Ctrl+Shift+Esc. Vá em Desempenho → CPU e procure "Virtualização: Habilitada".
Como instalar o WSL2?
No Windows 11 e Windows 10 (Atualização de outubro de 2021 ou posterior), um único comando instala o WSL2 e o Ubuntu juntos.
1. Abra o PowerShell ou PromptUm símbolo (como $ ou #) exibido quando o shell está esperando sua entrada. de Comando como Administrador
Clique com o botão direito no botão Iniciar e selecione "Terminal do Windows (Admin)" ou pesquise "PowerShell" e execute como Administrador.
2. Execute o comando de instalação
wsl --install
Installing: Virtual Machine Platform Virtual Machine Platform has been installed. Installing: Windows Subsystem for Linux Windows Subsystem for Linux has been installed. Installing: Ubuntu Ubuntu has been installed. The requested operation is successful.
3. Reinicie o computador
Após a reinicialização, a configuração do Ubuntu inicia automaticamente. Defina aqui um nome de usuário e uma senha. Feito isso, seu ambiente Linux está pronto.
A senha que você definir aqui é necessária sempre que usar o sudo — o comando que executa um comando como administrador. Anote-a em algum lugar seguro.
Instalando uma distribuição específica
Você pode escolher sua distribuição — um conjunto com o Linux em si mais os programas que o acompanham, muitas vezes chamado de "distro". Veja primeiro o que está disponível:
wsl --list --online
NAME FRIENDLY NAME Ubuntu Ubuntu Debian Debian GNU/Linux kali-linux Kali Linux Rolling Ubuntu-22.04 Ubuntu 22.04 LTS Ubuntu-24.04 Ubuntu 24.04 LTS ...
Para instalar uma específica:
wsl --install -d Ubuntu-24.04
Verificar a instalação
wsl -l -v
NAME STATE VERSION * Ubuntu Running 2 Ubuntu-24.04 Stopped 2
A coluna VERSION deve mostrar 2 para WSL2.
Qual distribuição Linux devo escolher?
Para a maioria dos usuários, o Ubuntu é a escolha certa. Ele tem a maior comunidade e a maior quantidade de documentação. Também vem com o apt, o gerenciador de pacotesUma ferramenta que instala e atualiza softwares para você em um só lugar. que instala, atualiza e remove programas para você.
| Distribuição | Características | Melhor para |
|---|---|---|
| Ubuntu | Grande comunidade, gerenciador apt | Iniciantes, desenvolvimento geral |
| Debian | Leve, focado em estabilidade | Usuários com experiência em servidor |
| Kali Linux | Coleção de ferramentas de segurança | Aprendizes de segurança |
| openSUSE | Ferramentas de nível empresarial | Fluxos de trabalho corporativos |
Em caso de dúvida, escolha o Ubuntu LTS (Long Term Support, suporte de longo prazo). São cinco anos de suporte e a maior cobertura de documentação.
Como começar a usar Linux no WSL2?
Há duas formas de iniciar o WSL2. Pesquise "Ubuntu" no menu Iniciar, ou digite wsl em qualquer janela do PowerShell ou do Prompt de Comando.
wsl
Dentro do shell Linux, você pode executar comandos Linux padrão:
# Mostrar diretório atual pwd
/home/username
# Listar arquivos com detalhes ls -la
# Atualizar listas de pacotes (sempre execute após a configuração inicial) sudo apt update && sudo apt upgrade -y
Desligar o WSL2
# Encerrar uma distro específica wsl --terminate Ubuntu # Desligar todas as instâncias WSL wsl --shutdown
Como compartilhar arquivos entre Windows e Linux?
O WSL2 monta os drives do Windows em /mnt/ — o drive C: aparece em /mnt/c/. No sentido contrário, o Windows alcança os arquivos Linux por \\wsl$\Ubuntu no Explorador de Arquivos.
Acessando arquivos do Windows pelo WSL2
# Navegar pelo drive C: ls /mnt/c/Users/ # Copiar um arquivo para os Documentos do Windows cp meuarquivo.txt /mnt/c/Users/usuario/Documents/
Abrindo arquivos Linux no Explorador de Arquivos do Windows
De dentro do shell Linux, execute:
explorer.exe .
Isso abre o diretórioUm local que organiza arquivos. É a mesma ideia da "pasta" do Windows ou macOS. Linux atual no Explorador de Arquivos. Você também pode digitar \\wsl$\Ubuntu\home\usuario diretamente na barra de endereços do Explorador de Arquivos.
Mantenha seus arquivos de trabalho dentro do diretório home do Linux (/home/usuario/) em vez do sistema de arquivos do Windows (/mnt/c/...). Leituras e escritas que cruzam a fronteira entre os sistemas operacionais são bem mais lentas.
Editando arquivos Linux no VS Code
Instale a extensão "Remote - WSL" no VS Code — uma extensão é um complemento que acrescenta recursos ao editor. Depois execute isso do seu shell WSL2:
code .
O VS Code abre com acesso completo ao sistema de arquivos Linux, terminal e extensões sendo executadas dentro do Linux.
Como resolver erros comuns do WSL2?
Erro "Virtualization is not enabled"
Causa: VT-x / AMD-V está desligado no BIOS.
Solução: Reinicie o computador e entre na tela de configuração do BIOS/UEFI (geralmente F2 ou DEL). Ligue a opção de virtualização por lá.
wsl --install falha em versões mais antigas do Windows 10
Em versões do Windows 10 1903–2004, pode ser necessário ligar os componentes na mão:
# Execute no PowerShell (Admin) dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Reinicie e instale o pacote de atualização do kernel Linux para WSL2 da Microsoft. Depois disso, defina o WSL2 como padrão:
wsl --set-default-version 2
Erro 0x80370102: WslRegisterDistribution falhou
Causa: Hyper-V ou Virtual Machine Platform não está habilitado.
Solução:
# Execute no PowerShell (Admin) dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Reinicie e tente novamente.
Senha esquecida
# No PowerShell (Admin) — inicie a distro como root ubuntu config --default-user root # Dentro do WSL2, redefina a senha passwd username # Restaure o usuário padrão ubuntu config --default-user username
Substitua ubuntu pelo nome real do comando da sua distro (por exemplo, ubuntu2404) se necessário.