Como instalar o Linux no Windows com o WSL

Os desenvolvedores podem acessar o poder do Windows e do Linux ao mesmo tempo em um computador Windows. O Subsistema do Windows para Linux (WSL) permite que os desenvolvedores instalem uma distribuição do Linux (como Ubuntu, OpenSUSE, Kali, Debian, Arch Linux etc) e usem aplicativos Linux, utilitários e ferramentas de linha de comando bash diretamente no Windows, sem modificação, sem a sobrecarga de uma máquina virtual tradicional ou configuração dualboot.

Pré-requisitos

Você deve estar executando o Windows 10 versão 2004 e superior (Build 19041 e superior) ou Windows 11 para usar os comandos abaixo. Se você estiver em versões anteriores, consulte a página de instalação manual.

Instalar comando WSL

Agora você pode instalar tudo o que precisa para executar o WSL com um único comando. Abra o PowerShell no modo de administrador clicando com o botão direito do mouse e selecionando "Executar como administrador", insira o comando wsl --install e reinicie o computador.

wsl --install

Esse comando habilitará os recursos necessários para executar o WSL e instalar a distribuição do Ubuntu do Linux. (Essa distribuição padrão pode ser alterada).

Se você estiver executando um build mais antigo ou simplesmente preferir não usar o comando de instalação e quiser instruções passo a passo, consulte as etapas de instalação manual do WSL para versões mais antigas.

Na primeira vez que você iniciar uma distribuição do Linux recém-instalada, uma janela do console será aberta e você será solicitado a aguardar que os arquivos sejam descompactados e armazenados em seu computador. Todos os lançamentos futuros devem levar menos de um segundo.

Alterar a distribuição padrão do Linux instalada

Por padrão, a distribuição instalada do Linux será o Ubuntu. Isso pode ser alterado usando o -d sinalizador.

• Para alterar a distribuição instalada, insira:

  wsl.exe --install [Distro]
  

  Substitua [Distro] pelo nome da distribuição que você deseja instalar.

• Para ver uma lista das distribuições disponíveis do Linux disponíveis para download por meio da loja online, insira:

  wsl.exe --list --online
  

Se você encontrar um problema durante o processo de instalação, verifique a seção de instalação do guia de solução de problemas.

Para instalar uma distribuição do Linux que não está listada como disponível, você pode importar qualquer distribuição do Linux usando um arquivo TAR. Ou, em alguns casos, como no Arch Linux, você pode instalar usando um .appx arquivo. Você também pode criar sua própria distribuição personalizada do Linux para usar com o WSL.

Configurar suas informações de usuário do Linux

Depois de instalar o WSL, você precisará criar uma conta de usuário e uma senha para sua distribuição do Linux recém-instalada. Confira o guia Práticas recomendadas para configurar um ambiente de desenvolvimento WSL para saber mais.

Configuração e práticas recomendadas

Recomendamos seguir nossas práticas recomendadas para configurar um guia de ambiente de desenvolvimento do WSL para um passo a passo de como configurar um nome de usuário e senha para suas distribuições do Linux instaladas, usando comandos WSL básicos, instalar e personalizar o Terminal do Windows, configurar para controle de versão do Git, edição de código e depuração usando o servidor remoto do VS Code, boas práticas para armazenamento de arquivos, configuração de um banco de dados, montagem de uma unidade externa, configuração de aceleração de GPU e muito mais.

Verificar qual versão do WSL você está executando

Você pode listar as distribuições instaladas do Linux e verificar se a versão do WSL está definida inserindo o comando:

wsl.exe --list --verbose

Para definir a versão padrão como WSL 1 ou WSL 2 quando uma nova distribuição do Linux estiver instalada, use o comando:

wsl.exe --set-default-version <1|2>

Para definir a distribuição padrão do Linux usada com o wsl comando, insira:

wsl.exe --set-default <Distro>

Substituindo <Distro> pelo nome da distribuição do Linux que você gostaria de usar. Por exemplo, do PowerShell, insira: wsl -s Debian para definir a distribuição padrão como Debian. Agora, a execução wsl npm init do Powershell executará o npm init comando no Debian.

Para executar uma distribuição wsl específica no PowerShell sem alterar sua distribuição padrão, use o comando:

wsl.exe --distribution <DistroName>

Substituindo <DistroName> pelo nome da distribuição que você deseja usar.

Saiba mais no guia para comandos básicos para WSL.

Atualizar a versão do WSL 1 para o WSL 2

Novas instalações do Linux, instaladas usando o wsl --install comando, serão definidas como WSL 2 por padrão.

Para ver se a distribuição do Linux está definida como WSL 1 ou WSL 2, use o comando: wsl -l -v. A atualização do WSL 1 para o WSL 2 ou o downgrade do WSL 2 para o WSL 1 pode ser feito usando o seguinte comando:

wsl.exe --set-version <Distro> <1|2>

Substituindo <Distro> pelo nome da distribuição do Linux que você deseja atualizar. Por exemplo, wsl --set-version Ubuntu 2 definirá sua distribuição do Ubuntu para usar o WSL 2.

Se você instalou manualmente o WSL antes do wsl --install comando estar disponível, talvez você também precise habilitar o componente opcional da máquina virtual usado pelo WSL 2 e instalar o pacote de kernel se ainda não tiver feito isso.

Para saber mais, consulte a referência de comando para WSL para obter uma lista de comandos WSL, comparando wsl 1 e WSL 2 para obter diretrizes sobre quais usar para seu cenário de trabalho ou práticas recomendadas para configurar um ambiente de desenvolvimento WSL para diretrizes gerais sobre como configurar um bom fluxo de trabalho de desenvolvimento com o WSL.

Maneiras de executar várias distribuições do Linux com o WSL

O WSL dá suporte à execução de quantas distribuições diferentes do Linux você deseja instalar. Isso pode incluir a escolha de distribuições da Microsoft Store, a importação de uma distribuição personalizada ou a criação de sua própria distribuição personalizada.

Há várias maneiras de executar suas distribuições do Linux depois de instaladas:

• No Terminal do Windows(Recomendado) o uso do Terminal do Windows dá suporte a quantas linhas de comando você deseja instalar e permite abri-las em várias guias ou painéis de janela e alternar rapidamente entre várias distribuições do Linux ou outras linhas de comando (PowerShell, Prompt de Comando, CLI do Azure etc). Você pode personalizar totalmente seu terminal com esquemas de cores exclusivos, estilos de fonte, tamanhos, imagens de plano de fundo e atalhos de teclado personalizados. Saiba mais.
• Você pode abrir diretamente sua distribuição do Linux visitando o menu Iniciar do Windows e digitando o nome das distribuições instaladas. Por exemplo: "Ubuntu". Isso abrirá o Ubuntu em sua própria janela de console.
• No PowerShell, você pode inserir o nome da distribuição instalada. Por exemplo: ubuntu
• No PowerShell, você pode abrir sua distribuição padrão do Linux dentro da linha de comando atual, inserindo: wsl.exe.
• No PowerShell, você pode usar sua distribuição padrão do Linux dentro da linha de comando atual, sem inserir uma nova, inserindo:wsl [command]. Substituindo [command] por um comando WSL, como: wsl -l -v para listar distribuições instaladas ou wsl pwd para ver onde o caminho do diretório atual está montado no WSL. No PowerShell, o comando Get-Date fornecerá a data do sistema de arquivos do Windows e wsl date fornecerá a data do sistema de arquivos Linux.

O método selecionado deve depender do que você está fazendo. Se você abriu uma linha de comando WSL dentro de uma janela do PowerShell e deseja sair, insira o comando: exit.

Deseja testar os recursos de prévia mais recentes do WSL?

Experimente os recursos ou atualizações mais recentes do WSL ingressando no Programa Windows Insiders. Depois de ingressar no Windows Insiders, você pode escolher o canal que deseja receber builds de visualização de dentro do menu de configurações do Windows para receber automaticamente quaisquer atualizações do WSL ou recursos de visualização associados a esse build. Você pode escolher entre:

• Canary Channel:
  • Ideal para usuários altamente técnicos.
  • Visualizar as alterações mais recentes da plataforma no início do ciclo de desenvolvimento.
  • Essas versões podem ser instáveis e são liberadas com documentação limitada ou nenhuma.
• Canal de Desenvolvimento:
  • Ideal para entusiastas.
  • Acesse as versões prévias mais recentes do Windows 11 enquanto incubamos novas ideias e desenvolvemos funções de longa duração.
  • Haverá algumas bordas ásperas e baixa estabilidade.
• Canal Beta:
  • Ideal para os primeiros adotantes.
  • Visualizar e fornecer comentários sobre os recursos de pré-lançamento do Windows 11 em um ambiente estável.
• Canal de Prévia de Lançamento
  • Ideal se você quiser visualizar correções e determinados recursos principais, além de obter acesso opcional à próxima versão do Windows antes que ela esteja geralmente disponível para o mundo.
  • Esse canal também é recomendado para usuários comerciais.

Se você preferir não alternar sua instalação do Windows para um canal de visualização, ainda poderá testar a versão prévia mais recente do WSL emitindo o comando:

wsl.exe --update --pre-release

Para obter mais informações, verifique a página Versões do WSL no GitHub.

Próximas etapas

Vamos explorar os comandos básicos do WSL em seguida.

Instalação offline

Para instalar o WSL offline, você precisa executar estas etapas:

• Baixe e instale o pacote MSI mais recente do WSL na página de lançamentos do GitHub
• Abra uma janela do PowerShell com privilégios de administrador e execute dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart para habilitar o componente opcional da Plataforma de Máquina Virtual. Você provavelmente precisará reiniciar seu computador para que isso entre em vigor.
• Instale uma distribuição por meio de um arquivo .wsl. Você pode encontrar URLs para baixar esses arquivos em DistributionInfo.json para a distribuição escolhida.

Recursos adicionais

• Blog de Linha de Comando do Windows: instalar o WSL com um único comando agora disponível no Windows 10 versão 2004 e superior