Compartilhar via

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 Prompt de Comando do PowerShell ou 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 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.

Observação

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

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 --install -d <Distribution Name>. Substitua <Distribution Name> pelo nome da distribuição que você deseja instalar.
  • Para ver uma lista de distribuições disponíveis 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 de dentro de uma linha de comando do Linux/Bash (em vez do PowerShell ou do 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 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 -l -v no Prompt de Comando do PowerShell ou no Windows.

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 --set-default-version <Version#>, substituindo <Version#> por 1 ou 2.

Para definir a distribuição padrão do Linux usada com o wsl comando, insira: wsl -s <DistributionName> ou wsl --set-default <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, a execução wsl npm init do Powershell executará o npm init comando no Debian.

Para executar uma distribuição wsl específica de dentro do PowerShell ou do 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 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.

O wsl --set-version comando 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 alterar as versões, use o comando: wsl --set-version <distro name> 2 substituindo <distro name> pelo nome da distribuição do Linux que você deseja 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 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:

  • Instalar o Terminal do Windows(Recomendado) usando o 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 Prompt de Comando do Windows ou no PowerShell, você pode inserir o nome da distribuição instalada. Por exemplo: ubuntu
  • 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.
  • 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, 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 em uma janela do Windows Prompt ou 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:

  • Canal de desenvolvimento: atualizações mais recentes, mas baixa estabilidade.
  • Canal beta: ideal para usuários pioneiros, versões mais confiáveis que as do canal Dev.
  • Canal Release Preview: Experimente correções e principais recursos na próxima versão do Windows pouco antes de estar disponível para o público em geral.

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 --update --pre-release. Para obter mais informações, verifique a página Versões do WSL no GitHub.

Recursos adicionais