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 WSL básicos, configurar Visual Studio Code ou Visual Studio, Git, Windows Gerenciador de Credenciais, bancos de dados como MongoDB, Postgres ou MySQL, configurar a 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 habilita-lo e instalar uma distribuição do Linux antes de começar a usá-la.

Para usar o comando simplificado --install, você deve executar 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 Windows Assistente de Atualização.

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 Windows prompt de comando) 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 Ubuntu Linux sistema (a reinicialização pode ser necessária)

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

PowerShell command line running 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 Uma 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.

  • 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?

Ubuntu command line enter UNIX username

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 do WSL tiver sido aberta no nível raiz dentro do PowerShell, você poderá usar este comando para atualizar sua senha: em que é o nome de usuário da conta na distribuição cuja senha você passwd <username><username> esqueceu.

  3. Você será solicitado a inserir uma nova senha do UNIX e, em seguida, confirmar essa senha. Quando 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 do Microsoft Store, por meio do comando --importou por meio do sideload de sua própria distribuição personalizada. Talvez você também queira configurar imagens WSL personalizadas para distribuição em toda a empresa.

Configurar o Windows Terminal

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 Linux do WSL for instalada, uma nova instância será criada para ela dentro do Windows que pode ser personalizada de acordo com Terminal suas preferências.

É recomendável usar o WSL com Windows Terminal , especialmente se você planeja trabalhar com várias linhas de comando. Confira os Windows Terminal documentos para ajudar a defini-lo e personalizar suas preferências, incluindo:

Windows <span class=Captura Windows <span class= de tela do terminal" data-linktype="relative-path"/>

Armazenamento de arquivos

  • Para abrir seu projeto WSL no Windows Explorador de Arquivos, insira:explorer.exe .
    Certifique-se de adicionar o ponto no final do comando para abrir o diretório atual.

  • Armazene os arquivos de projeto no mesmo sistema operacional que as ferramentas que você planeja usar.
    Para 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 Windows comando (PowerShell, Prompt de Comando) com ferramentas Windows, armazene seus arquivos no Windows de arquivos. Os arquivos podem ser acessados entre os sistemas operacionais, mas podem diminuir 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 File Explorer displaying Linux storage

Configurar seu editor de código favorito

É recomendável usar Visual Studio Code ou Visual Studio, pois eles suportam diretamente o desenvolvimento remoto e a depuração com o WSL. Visual Studio Code permite que você use o WSL como um ambiente de desenvolvimento completo. Visual Studio oferece suporte nativo do WSL para desenvolvimento de plataforma cruzada C++.

Usar o Visual Studio Code

Siga este guia passo a passo para Começar a usar o 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 o WSL, o SSH ou um contêiner remoto para edição e depuração com o conjunto completo de Visual Studio Code recursos. Alterne rapidamente entre ambientes de desenvolvimento diferentes e separados e faça atualizações sem se preocupar em afetar seu computador local.

Depois VS Code instalação e configuração, você pode abrir seu projeto WSL com um VS Code remoto inserindo:code .

Certifique-se de adicionar o ponto no final do comando para abrir o diretório atual.

VS Code with WSL extensions displayed

Usar o Virtual Studio

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

Select a target system in 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 conecte seu projeto ao sistema de controle de versão do Git, juntamente com o uso do gerenciador de credenciais para autenticação, o uso de arquivos Git Ignore, o entendimento das terminações de linha do Git e o uso dos comandos git integrados para VS Code.

Displaying git version in the command line

Configurar contêineres de desenvolvimento remoto com o Docker

Siga este guia passo a passo para Começar a trabalhar com 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.

Docker Desktop screenshot

Configurar um banco de dados

Siga este guia passo a passo para Começar a trabalhar com bancos de dados no WSL e conectar seu projeto a um banco de dados no ambiente WSL. Começar a trabalhar com MySQL, PostgreSQL, MongoDB, Redis, Microsoft SQL Server ou SQLite.

Running MongoDB in 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 por GPU no WSL e aproveitar a GPU do computador (unidade de processamento gráfico) para acelerar cargas de trabalho pesadas de desempenho.

Running GPU acceleration with WSL

Comandos básicos do WSL

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

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

  • Execute ferramentas do Linux em uma Windows decomando: abra o PowerShell e exibe o conteúdo do diretório usando o comando do Linux ls -la inserindo:wsl ls -la

  • Combinar comandos linux e Windows: neste exemplo, o comando do Linux é usado para listar arquivos no diretório e, em seguida, o comando do PowerShell é usado para filtrar os resultados para palavras que contêm findstr "git": wsl ls -la | findstr "git" . Isso também pode ser feito combinando o comando Windows dir com o comando do grep Linux: dir | wsl grep git .

  • Execute uma Windows diretamente da linha de comando do WSL: Por exemplo, para abrir o arquivo .bashrc (o script de shell que é executado sempre que a linha de comando do Linux é iniciada), insira:notepad.exe .bashrc

  • Execute a Windows ipconfig.exe com a ferramenta Grep do Linux: Este exemplo demonstra a ferramenta ipconfig no sistema de arquivos do Windows que está sendo usado para exibir os valores atuais de configuração de rede TCP/IP e, em seguida, sendo filtrado apenas para o resultado IPv4 com grep, uma ferramenta linux.

Montar uma unidade externa ou USB

Siga este guia passo a passo para Começar a montar um disco do Linux no WSL 2.

wsl mount command screenshot

Executar aplicativos de GUI do Linux

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

Recursos adicionais

  • Configurar seu ambiente de desenvolvimento no Windows:saiba mais sobre como configurar seu ambiente de desenvolvimento para sua linguagem ou estrutura preferida, como React, Python, NodeJS, Vue etc.
  • Solução deproblemas: encontre problemas comuns, onde relatar bugs, onde solicitar novos recursos e como contribuir com os documentos.
  • Perguntas frequentes:encontre uma lista de perguntas frequentes.
  • Notas sobre aversão: revise as Notas de versão do WSL para ver um histórico de atualizações de build anteriores. Você também pode encontrar as notas de versão para o Kernel do Linux WSL.