Instalar o Linux no Windows com o WSL

Os desenvolvedores podem aproveitar o Windows e o Linux ao mesmo tempo em um computador Windows. O WSL (Subsistema do Windows para Linux) permite que os desenvolvedores instalem uma distribuição do Linux (como Ubuntu, OpenSUSE, Kali, Debian, Arch Linux etc) e usem aplicativos, utilitários e ferramentas de linha de comando bash do Linux 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 o Windows 11 para usar os comandos abaixo. Se você estiver em versões anteriores, consulte a página de instalação manual.

Comando de instalação do WSL

Agora você pode instalar tudo o que precisa para executar o WSL com apenas um comando. Abra o PowerShell ou o Prompt de Comando do Windows 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 Ubuntu do Linux. (Essa distribuição padrão pode ser alterada.)

Se você estiver executando um build mais antigo ou simplesmente prefere não usar o comando para instalar e quer instruções passo a passo, confira Etapas de instalação manual do WSL para versões mais antigas .

Se você estiver executando um build mais antigo ou simplesmente prefere não usar o comando para instalar e quer instruções passo a passo, confira 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 de console será aberta e será solicitado que você aguarde para que os arquivos sejam descompactados e armazenados em seu computador. Todas as futuras inicializações deverão levar menos de um segundo.

Observação

O comando acima só funcionará se o WSL não estiver instalado; se você executar wsl --install e vir o texto de ajuda do WSL, tente executar wsl --list --online para ver a lista de distribuições disponíveis e execute wsl --install -d <DistroName> para instalar uma distribuição. Para desinstalar o WSL, confira Desinstalar a versão herdada do WSL ou Cancelar o registro ou fazer a desinstalação de uma distribuição do Linux.

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

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

  • Para alterar a distribuição instalada, insira: wsl --install -d <Distribution Name>. Substitua <Distribution Name> pelo nome da distribuição que você gostaria de instalar.
  • Para ver uma lista das distribuições do Linux disponíveis para download por meio da loja online, insira: wsl --list --online ou wsl -l -o.
  • Para instalar distribuições adicionais do Linux após a instalação inicial, você também pode usar o comando: wsl --install -d <Distribution Name>.

Dica

Se você quiser instalar distribuições adicionais usando uma linha de comando Linux/Bash (em vez do PowerShell ou prompt de comando), deverá usar .exe no comando: wsl.exe --install -d <Distribution Name> ou, para listar as distribuições disponíveis: wsl.exe -l -o.

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 esteja 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 fazer a instalação usando um arquivo .appx. Você também pode criar sua distribuição personalizada do Linux a ser usada 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 a distribuição do Linux recém-instalada. Confira o guia Melhores práticas para configurar um ambiente de desenvolvimento do WSL para mais informações.

Configuração e melhores práticas

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

Verificar a versão do WSL que você está executando

Você pode listar suas distribuições do Linux instaladas e verificar a versão do WSL para a qual cada uma está definida inserindo o comando: wsl -l -v no PowerShell ou Prompt de Comando do Windows.

Para definir a versão padrão como WSL 1 ou WSL 2 quando uma nova distribuição do Linux é instalada, use o comando: wsl --set-default-version <Version#>, substituindo <Version#> por 1 ou 2.

Para definir a distribuição padrão do Linux usada com o comando wsl, insira wsl -s <DistributionName> ou wsl --setdefault <DistributionName>, substituindo <DistributionName> pelo nome da distribuição do Linux que você gostaria de usar. Por exemplo, do PowerShell/CMD, insira: wsl -s Debian para definir a distribuição padrão como Debian. Agora, executar wsl npm init no PowerShell executará o comando npm init no Debian.

Para executar uma distribuição específica do WSL no PowerShell ou no Prompt de Comando do Windows sem alterar sua distribuição padrão, use o comando: wsl -d <DistributionName>, substituindo <DistributionName> pelo nome da distribuição que você deseja usar.

Saiba mais no guia de Comandos básicos para WSL.

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

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

O comando wsl --set-version pode ser usado para fazer downgrade do WSL 2 para o WSL 1 ou atualizar as distribuições do Linux instaladas anteriormente do WSL 1 para o WSL 2.

Para ver se a distribuição do Linux está definida como WSL 1 ou WSL 2, use o comando: wsl -l -v.

Para mudar de versão, use o comando: wsl --set-version <distro name> 2 substituindo <distro name> pelo nome da distribuição do Linux que você quer atualizar. Por exemplo, wsl --set-version Ubuntu-20.04 2 definirá sua distribuição do Ubuntu 20.04 para usar o WSL 2.

Se você instalou o WSL manualmente antes da disponibilização do comando wsl --install, poderá ser necessário habilitar o componente opcional de máquina virtual usado pelo WSL 2 e instalar o pacote do kernel, se isso ainda não foi feito.

Para saber mais, confira Referência de comando para WSL para obter uma lista de comandos do WSL, Comparar WSL 1 e WSL 2 para obter diretrizes sobre qual deles usar para seu cenário de trabalho ou Práticas recomendadas para configurar um ambiente de desenvolvimento do WSL para obter 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 do Linux diferentes você gostaria de instalar. Isso pode incluir a escolha de distribuições da Microsoft Store, a importação de uma distribuição personalizada ou a criação da sua distribuição personalizada.

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

  1. Instalar o Terminal do Windows(recomendado) O uso do Terminal do Windows dá suporte a quantas linhas de comando você deseja instalar e permite que você as abra em várias guias ou painéis de janela e alterne rapidamente entre várias distribuições do Linux ou outras linhas de comando (PowerShell, Prompt de Comando, PowerShell, CLI do Azure etc.). Você pode personalizar totalmente o terminal com esquemas de cores exclusivos, estilos de fonte, tamanhos, imagens de tela de fundo e atalhos de teclado personalizados. Saiba mais.
  2. 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 na própria janela do console.
  3. No Prompt de Comando do Windows ou no PowerShell, você pode inserir o nome da distribuição instalada. Por exemplo: ubuntu
  4. No Prompt de Comando do Windows ou no PowerShell, você pode abrir sua distribuição padrão do Linux dentro da linha de comando atual inserindo: wsl.exe.
  5. No Prompt de Comando do Windows ou no PowerShell, você pode usar sua distribuição padrão do Linux dentro da linha de comando atual inserindo, sem entrar em uma nova, inserindo: wsl [command]. Substituindo [command] por um comando do WSL, como: wsl -l -v para listar distribuições instaladas ou wsl pwd para ver onde o caminho de diretório atual está montado em 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 do Linux.

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

Deseja experimentar os recursos de versão prévia mais recentes do WSL?

Experimente os recursos ou atualizações mais recentes do WSL participando do Programa Windows Insider. Depois de ingressar no Windows Insider, você pode escolher o canal do qual gostaria de receber compilações de pré-visualização no menu de configurações do Windows para receber automaticamente todas as atualizações ou recursos de versão prévia do WSL associados a esse build. Você pode escolher:

  • Canal do Desenvolvedor: atualizações mais recentes, mas baixa estabilidade.
  • Canal Beta: ideal para os usuários pioneiros, builds mais confiáveis do que o canal do Desenvolvedor.
  • Canal de pré-visualização de lançamento: visualize correções e principais recursos da próxima versão do Windows antes de estar disponível para o público em geral.

Recursos adicionais