Configurar um ambiente de desenvolvimento WSL

Um guia passo a passo para as práticas recomendadas para configurar um ambiente de desenvolvimento WSL. Saiba como executar o comando para instalar o shell bash padrão que usa o Ubuntu ou pode ser definido para instalar outras distribuições do Linux, usar comandos básicos do WSL, configurar Visual Studio Code ou Visual Studio, Git, Windows Credential Manager, bancos de dados como MongoDB, Postgres ou MySQL, configurar aceleração de GPU, executar aplicativos GUI e muito mais.

Introdução

Subsistema do Windows para Linux vem com o sistema operacional Windows, mas você deve habilitá-lo e instalar uma distribuição do Linux antes de começar a usá-lo.

Para usar o comando simplificado --install, você deve estar executando um build recente do Windows (Build 20262+). Para verificar a sua versão e o número de build, selecione a tecla do logotipo do Windows + R, digite winver e selecione OK. Você pode atualizar usando o menu Configurações ou o Assistente de Windows Update.

Se você preferir instalar uma distribuição do Linux diferente do Ubuntu ou preferir concluir essas etapas manualmente, consulte a página de instalação do WSL para obter mais detalhes.

Abra o PowerShell (ou Prompt de Comando do Windows) e insira:

wsl --install

O comando --install executa as seguintes ações:

  • Habilita os componentes opcionais WSL e Plataforma de Máquina Virtual
  • Baixa e instala o kernel do Linux mais recente
  • Define WSL 2 como o padrão
  • Baixa e instala a distribuição do Ubuntu Linux (a reinicialização pode ser necessária)

Você precisará reiniciar o computador durante esse processo de instalação.

Linha de comando do PowerShell executando wsl --install

Verifique o artigo de instalação de solução de problemas se você tiver problemas.

Configurar seu nome de usuário e senha do Linux

Depois que o processo de instalação da distribuição do Linux com o WSL for concluído, abra a distribuição (Ubuntu por padrão) usando o menu Iniciar. Você será solicitado a criar um nome de usuário e senha para sua distribuição do Linux.

  • O Nome de Usuário e a Senha são específicos de cada distribuição do Linux separada que você instala e não têm nenhuma influência sobre o seu nome de usuário do Windows.

  • Observe que, ao inserir a Senha, nada aparecerá na tela. Isso é chamado de digitação cega. Você não verá o que está digitando, isso é completamente normal.

  • Depois de criar um Nome de Usuário e uma Senha, a conta será o usuário padrão para a distribuição e será conectada automaticamente ao iniciar.

  • Essa conta será considerada o administrador do Linux, com a capacidade de executar comandos administrativos sudo (Super User Do).

  • Cada distribuição do Linux em execução no WSL tem suas próprias contas de usuário e senhas do Linux. Você precisará configurar uma conta de usuário do Linux sempre que adicionar uma distribuição, reinstalação ou redefinição.

Observação

As distribuições do Linux instaladas com o WSL são uma instalação por usuário e não podem ser compartilhadas com outras contas de usuário do Windows. Encontrando um erro de nome de usuário? StackExchange: quais caracteres devo usar ou não em nomes de usuário no Linux?

Linha de comando do Ubuntu insira nome de usuário UNIX

Para alterar ou redefinir sua senha, abra a distribuição do Linux e insira o comando: passwd. Você será solicitado a inserir a senha atual, inserir a nova senha e, em seguida, confirmar a nova senha.

Se você esqueceu a senha da sua distribuição do Linux:

  1. Abra o PowerShell e insira a raiz da distribuição do WSL padrão usando o comando: wsl -u root

    Se você precisa atualizar a senha que foi esquecida em uma distribuição que não seja a padrão, use o comando: wsl -d Debian -u root, substituindo Debian pelo nome da sua distribuição direcionada.

  2. Depois que a distribuição WSL for aberta no nível raiz dentro do PowerShell, você poderá usar esse comando para atualizar sua senha: passwd <username> onde <username> está o nome de usuário da conta na distribuição cuja senha você esqueceu.

  3. Você será solicitado a inserir uma nova senha do UNIX e, em seguida, confirmar essa senha. Depois que você for informado de que a senha foi atualizada com êxito, feche o WSL dentro do PowerShell usando o comando: exit.

Pacotes de atualização e upgrade

Recomendamos que você atualize e atualize regularmente seus pacotes usando o gerenciador de pacotes preferencial para a distribuição. Para Ubuntu ou Debian, use o comando:

sudo apt update && sudo apt upgrade

O Windows não atualiza ou faz upgrade automaticamente de suas distribuições do Linux. Essa é uma tarefa que a maioria dos usuários do Linux prefere controlar por conta própria.

Adicionar distribuições adicionais

Para adicionar distribuições adicionais do Linux, você pode instalar por meio da Microsoft Store, por meio do comando --import ou sideload de sua própria distribuição personalizada. Você também pode querer configurar imagens WSL personalizadas para distribuição em sua empresa.

Configurar o Windows Terminal

O Windows Terminal pode executar qualquer aplicativo com uma interface de linha de comando. Seus principais recursos incluem suporte a várias guias, painéis, caracteres Unicode e UTF-8, um mecanismo de renderização de texto acelerado por GPU e a capacidade de criar os próprios temas e personalizar texto, cores, telas de fundo e atalhos.

Sempre que uma nova distribuição do WSL Linux for instalada, uma nova instância será criada para ela dentro do Windows Terminal que pode ser personalizada para suas preferências.

É recomendável usar o WSL com o Windows Terminal, especialmente se você planeja trabalhar com várias linhas de comando. Consulte os documentos do Windows Terminal para obter ajuda para configurá-lo e personalizar suas preferências, incluindo:

Captura de tela do Windows Terminal

Armazenamento de arquivos

  • Para abrir seu projeto WSL no Windows Explorador de Arquivos, insira:explorer.exe .
    Adicione o período ao final do comando para abrir o diretório atual.

  • Armazene seus arquivos de projeto no mesmo sistema operacional que as ferramentas que você planeja usar.
    Para obter a velocidade de desempenho mais rápida, armazene seus arquivos no sistema de arquivos WSL se você estiver trabalhando neles com ferramentas do Linux em uma linha de comando do Linux (Ubuntu, OpenSUSE etc.). Se você estiver trabalhando em uma linha de comando do Windows (PowerShell, Prompt de Comando) com ferramentas do Windows, armazene seus arquivos no sistema de arquivos do Windows. Os arquivos podem ser acessados nos sistemas operacionais, mas podem reduzir significativamente o desempenho.

Por exemplo, ao armazenar seus arquivos de projeto do WSL:

  • Use o diretório raiz do sistema de arquivos do Linux: \\wsl$\<DistroName>\home\<UserName>\Project
  • Não o diretório raiz do sistema de arquivos do Windows: C:\Users\<UserName>\Project ou /mnt/c/Users/<UserName>/Project$

Windows Explorador de Arquivos exibindo o armazenamento do Linux

Configurar seu editor de código favorito

É recomendável usar Visual Studio Code ou Visual Studio, pois eles dão suporte diretamente ao desenvolvimento remoto e à depuração com o WSL. Visual Studio Code permite que você use o WSL como um ambiente de desenvolvimento completo. O Visual Studio oferece suporte WSL nativo para desenvolvimento multiplataforma C++.

Usar o Visual Studio Code

Siga este guia passo a passo para começar a usar Visual Studio Code com o WSL, que inclui a instalação do pacote de extensão de Desenvolvimento Remoto. Essa extensão permite que você execute WSL, SSH ou um contêiner de desenvolvimento para edição e depuração com o conjunto completo de recursos Visual Studio Code. Troque rapidamente entre diferentes ambientes de desenvolvimento separados e faça atualizações sem se preocupar em afetar seu computador local.

Depois que o VS Code for instalado e configurado, você poderá abrir seu projeto WSL com um servidor remoto do VS Code inserindo: code .

Adicione o período ao final do comando para abrir o diretório atual.

VS Code com extensões WSL exibidas

Usar o Virtual Studio

Siga este guia passo a passo para começar a usar o Visual Studio com o WSL para desenvolvimento de plataforma cruzada C++. O Visual Studio 2022 permite que você crie e depure projetos do CMake em conexões do Windows, WSL e SSH da mesma instância do Visual Studio.

Selecionar um sistema de destino no Visual Studio 2022

Configurar o gerenciamento de versão com o Git

Siga este guia passo a passo para começar a usar o Git no WSL e conectar seu projeto ao sistema de controle de versão git, juntamente com o uso do gerenciador de credenciais para autenticação, usando arquivos Git Ignore, compreendendo terminações de linha git e usando os comandos git internos para VS Code.

Exibindo a versão git na linha de comando

Configurar contêineres de desenvolvimento remoto com o Docker

Siga este guia passo a passo para começar a usar contêineres remotos do Docker no WSL 2 e conectar seu projeto a um contêiner de desenvolvimento remoto com o Docker Desktop para Windows.

Captura de tela do Docker Desktop

Configurar um banco de dados

Siga este guia passo a passo para começar a usar bancos de dados no WSL e conectar seu projeto a um banco de dados no ambiente WSL. Introdução ao MySQL, PostgreSQL, MongoDB, Redis, Microsoft SQL Server ou SQLite.

Executando o MongoDB no Ubuntu via WSL

Configurar a aceleração de GPU para um desempenho mais rápido

Siga este guia passo a passo para configurar o treinamento de aprendizado de máquina acelerado de GPU no WSL e aproveitar a GPU do computador (unidade de processamento de elementos gráficos) para acelerar cargas de trabalho pesadas de desempenho.

Executando aceleração de GPU com WSL

Comandos WSL básicos

As distribuições do Linux instaladas por meio do WSL são mais bem gerenciadas usando o PowerShell ou o CMD (Prompt de Comando do Windows). Consulte o guia de referência de comando WSL para obter uma lista de comandos básicos com os quais se familiarizar ao usar o WSL.

Além disso, muitos comandos são interoperáveis entre Windows e Linux. Aqui estão alguns exemplos:

Montar uma unidade externa ou USB

Siga este guia passo a passo para começar a montar um disco linux no WSL 2.

captura de tela do comando de montagem wsl

Executar aplicativos de GUI do Linux

Siga este tutorial para saber como configurar e executar aplicativos de GUI do Linux no WSL.

Recursos adicionais