Instalar o WSL

Pré-requisitos

Você deve estar executando o Windows 10 versão 2004 e superior (Build 19041 e superior) ou o Windows 11.

Observação

Para verificar a versão e o número de build do seu Windows, selecione a tecla do logotipo do Windows + R, digite winver e selecione OK. Você pode atualizar para a versão mais recente do Windows selecionando Iniciar>Configurações>Windows Update>Verificar atualizações.

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 .

Instalar

Agora você pode instalar tudo o que precisa para executar o WSL (Subsistema do Windows para Linux) inserindo este comando no PowerShell administrador ou no Prompt de Comando do Windows e reiniciando o computador.

wsl --install

Esse comando habilitará os componentes opcionais necessários, baixará o kernel mais recente do Linux, definirá o WSL 2 como padrão e instalará uma distribuição do Linux para você (Ubuntu, por padrão, veja abaixo como alterar isso) .

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.

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.

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

Para fazer a atualização do WSL 1 para o WSL 2 em distribuições do Linux instaladas anteriormente, use o comando: wsl --set-version <distro name> 2 substituindo <distro name> pela 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. Talvez você também precise habilitar o componente opcional da máquina virtual usado pelo WSL 2 e instalar o pacote do kernel caso ainda não tenha feito isso.

Novas instalações do Linux serão definidas como WSL 2 por padrão, mas o comando wsl --set-version também pode ser usado para fazer downgrade do WSL 2 para o WSL 1. Para ver se a distribuição do Linux está definida como WSL 1 ou WSL 2, use o comando: wsl -l -v.

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