O Windows Subsystem for Linux (WSL) permite executar distribuições Linux diretamente no Windows. A seguir, um guia detalhado e passo a passo para instalar e configurar o WSL manualmente usando comandos no PowerShell. Este guia é baseado na instalação manual, recomendada para maior controle. Após a instalação, explicarei a configuração do arquivo .wslconfig, incluindo os principais parâmetros na seção [wsl2].
Pré-requisitos
- Certifique-se de que seu Windows está na versão 10 (build 19041 ou superior) ou Windows 11.
- Abra o PowerShell como administrador (clique direito em PowerShell e selecione "Executar como administrador").
Passo 1: Habilitar os Recursos Necessários do Windows
- No PowerShell como administrador, execute o comando para habilitar o componente "Virtual Machine Platform", essencial para o WSL 2:dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- Pode ser necessário reiniciar o computador para aplicar as mudanças.
Passo 2: Baixar e Instalar o Pacote MSI do WSL (para Instalação Offline, se Necessário)
- Baixe o pacote MSI mais recente do WSL da página de releases no GitHub: https://github.com/microsoft/wsl/releases.
- Instale o pacote baixado. Isso é opcional se você estiver online, mas garante uma instalação manual completa.
Passo 3: Instalar uma Distribuição Linux
- Liste as distribuições disponíveis para download:wsl.exe --list --online
- Instale uma distribuição específica (exemplo: Ubuntu):wsl.exe --install -d Ubuntu- Substitua Ubuntupelo nome da distribuição desejada (como Debian, Fedora, etc.). Se não especificar, o Ubuntu é instalado por padrão.
 
- Substitua 
- Aguarde a descompactação dos arquivos. Isso pode levar alguns minutos.
Passo 4: Configurar o Usuário Linux
- Ao abrir a distribuição pela primeira vez (via prompt ou menu Iniciar), você será solicitado a criar um nome de usuário e senha para a conta Linux. Siga as instruções na janela do console.
Passo 5: Verificar e Configurar a Versão do WSL
- Verifique a versão das distribuições instaladas:wsl.exe --list --verbose
- Defina a versão padrão para novas instalações (recomendado WSL 2):wsl.exe --set-default-version 2
- Para atualizar uma distribuição específica para WSL 2:wsl.exe --set-version Ubuntu 2- Substitua Ubuntupelo nome da sua distribuição.
 
- Substitua 
Passo 6: Configurar Distribuição Padrão e Executar Comandos
- Defina uma distribuição como padrão:wsl.exe --set-default Ubuntu
- Para executar comandos em uma distribuição específica sem alterar o padrão:wsl.exe --distribution Ubuntu
- Para sair de uma sessão WSL no PowerShell, digite:exit
Passos Pós-Instalação
- Instale o Windows Terminal para uma melhor experiência (disponível na Microsoft Store).
- Atualize o WSL para features de preview, se desejar:wsl.exe --update --pre-release
- Configure seu ambiente de desenvolvimento: instale Git, editores de código, etc., dentro da distribuição Linux.
- Para parar todas as instâncias do WSL (útil para aplicar configurações):wsl.exe --shutdown
Agora que o WSL está instalado, vamos à configuração avançada via arquivo .wslconfig.
Configuração do Arquivo .wslconfig
O arquivo .wslconfig é usado para definir configurações globais para todas as distribuições Linux rodando no WSL 2. Ele afeta a máquina virtual que executa o WSL. O arquivo não existe por padrão e deve ser criado no diretório %UserProfile% (acessível via cd ~ no PowerShell ou digitando %UserProfile% no Explorador de Arquivos). O caminho típico é C:\Users\<SeuNomeDeUsuario>\.wslconfig.
- Crie o arquivo com um editor de texto (como Notepad) e salve-o como .wslconfig(sem extensão .txt).
- As configurações são aplicadas na seção [wsl2].
- Após editar, reinicie o WSL com wsl --shutdownpara aplicar as mudanças.
- Requer Windows build 19041 ou superior.
Se precisar de mais detalhes ou troubleshooting, consulte a documentação oficial da Microsoft.
(Continua...)
 
            