1
resposta

[Sugestão] Passo a Passo para Configurar o WSL no Windows - Parte 1

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

  1. 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
    
  2. 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

  1. Liste as distribuições disponíveis para download:
    wsl.exe --list --online
    
  2. Instale uma distribuição específica (exemplo: Ubuntu):
    wsl.exe --install -d Ubuntu
    
    • Substitua Ubuntu pelo nome da distribuição desejada (como Debian, Fedora, etc.). Se não especificar, o Ubuntu é instalado por padrão.
  3. 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

  1. Verifique a versão das distribuições instaladas:
    wsl.exe --list --verbose
    
  2. Defina a versão padrão para novas instalações (recomendado WSL 2):
    wsl.exe --set-default-version 2
    
  3. Para atualizar uma distribuição específica para WSL 2:
    wsl.exe --set-version Ubuntu 2
    
    • Substitua Ubuntu pelo nome da sua distribuição.

Passo 6: Configurar Distribuição Padrão e Executar Comandos

  1. Defina uma distribuição como padrão:
    wsl.exe --set-default Ubuntu
    
  2. Para executar comandos em uma distribuição específica sem alterar o padrão:
    wsl.exe --distribution Ubuntu
    
  3. 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 --shutdown para 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...)

1 resposta

Olá Mauricio!
Muito bom, valeu! Obrigada!