Configurar seu ambiente de desenvolvimento no WSL

Um guia passo a passo das práticas recomendadas para configurar um ambiente de desenvolvimento do 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 o Visual Studio Code ou o Visual Studio, o Git, o Gerenciador de Credenciais do Windows, bancos de dados como MongoDB, Postgres ou MySQL, configurar aceleração de GPU, executar aplicativos GUI e muito mais.

Introdução

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.

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

wsl --install

O --install comando 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
• Faz download e instala uma distribuição do Linux (talvez seja necessário fazer a reinicialização)

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

Consulte o artigo solução de problemas de instalação se encontrar algum problema.

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 a conta de administrador do Linux, com permissão para executar comandos administrativos sudo (Super User Do).

• Cada distribuição do Linux em execução no Subsistema Windows para Linux 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.

Para alterar ou redefinir sua senha, abra a distribuição Linux e digite 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 acesse o diretório raiz da sua distribuição padrão do WSL usando o comando: wsl -u root

   Se você precisar atualizar a senha esquecida em uma distribuição que não é a sua padrão, use o comando: wsl -d <DistroName> -u root, substituindo <DistroName> pelo nome da distribuição de destino.

2. Depois que sua distribuição do WSL for aberta como raiz no PowerShell, você poderá usar este comando para redefinir sua senha: passwd <username>, em que <username> é o nome de usuário da conta na distribuição da qual você esqueceu a senha.

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 sucesso, feche o WSL no PowerShell usando o comando: exit

Pacotes de atualização e upgrade

Recomendamos que você 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 outras distribuições Linux, você pode instalar pela Microsoft Store, pelo comando --import ou carregando manualmente sua própria distribuição personalizada. Talvez você também queira configurar imagens personalizadas do WSL para distribuição em toda a sua empresa.

Configurar o Windows Terminal

Windows Terminal pode executar qualquer aplicativo com 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 Linux do WSL for instalada, uma nova instância será criada para ela dentro do Windows Terminal e poderá ser personalizada conforme suas preferências.

Recomendamos usar o WSL com Windows Terminal, especialmente se você planeja trabalhar com múltiplas linhas de comando. Consulte a documentação do Windows Terminal para obter ajuda para configurá-lo e personalizar suas preferências, incluindo:

• Instalar o Windows Terminal ou Windows Terminal (Prévia) da Microsoft Store
• Usar a Paleta de Comandos
• Configurar ações personalizadas como atalhos de teclado para fazer o terminal parecer natural para suas preferências
• Configurar o perfil de inicialização padrão
• Personalize a aparência: tema, esquemas de cores, nome e diretório inicial, imagem de plano de fundo, etc.
• Saiba como usar argumentos de linha de comando , como abrir um terminal com várias linhas de comando divididas em painéis de janela ou guias
• Saiba mais sobre o recurso de busca
• Encontre dicas e truques, como renomear ou colorir uma guia, usar interações do mouse ou habilitar o "modo Quake"
• Saiba como configurar um prompt de comando personalizado, perfis SSH ou títulos de guia
• Localizar uma galeria de terminais personalizada e um guia de solução de problemas

Armazenamento de arquivos

• Para abrir seu projeto do WSL no Explorador de Arquivos do Windows, insira: explorer.exe .

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

• Armazene os arquivos do projeto no mesmo sistema operacional das ferramentas que você pretende usar.

  Para obter velocidade de desempenho mais rápida, armazene os seus arquivos no sistema de arquivos WSL se você estiver trabalhando em uma linha de comando do Linux (Ubuntu, OpenSUSE etc.). Se você estiver trabalhando na linha de comando do Windows (PowerShell, Prompt de Comando) usando ferramentas do Windows, armazene seus arquivos no sistema de arquivos do Windows. Os arquivos podem ser acessados nos sistemas operacionais, mas isso 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$

Configure seu editor de código favorito

Recomendamos usar o Visual Studio Code ou o Visual Studio, pois eles oferecem suporte direto ao desenvolvimento remoto e à depuração remota com o WSL. O Visual Studio Code permite que você use o WSL como um ambiente de desenvolvimento completo. O Visual Studio oferece suporte nativo ao WSL para desenvolvimento multiplataforma do 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 da extensão WSL. Essa extensão permite que você use o WSL como um ambiente de desenvolvimento completo diretamente do VS Code. Alterne 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 estiver instalado e configurado, você poderá abrir seu projeto do WSL usando um servidor remoto do VS Code digitando: code .

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

Usar o Visual Studio

Siga este guia passo a passo para começar a usar o Visual Studio com WSL para desenvolvimento multiplataforma em C++. O Visual Studio 2022 permite compilar e depurar projetos CMake no Windows, em distribuições do WSL e em conexões SSH a partir da mesma instância do Visual Studio.

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, além de usar o gerenciador de credenciais para autenticação, arquivos .gitignore, entender as terminações de linha do Git e usar os comandos do Git integrados ao VS Code.

Configurar contêineres de desenvolvimento remoto com o Docker

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

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.

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 (unidade de processamento gráfico) do seu computador para acelerar cargas de trabalho com uso intensivo de processamento.

Comandos básicos do WSL

As distribuições do Linux instaladas por meio do WSL são mais bem gerenciadas usando o PowerShell ou o Prompt de Comando do Windows (CMD). Consulte o guia de referência de comandos do WSL para ver uma lista de comandos básicos com os quais você deve 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:

• Executar ferramentas do Linux a partir de uma linha de comando do Windows: Abra o PowerShell e exiba o conteúdo do diretório de C:\temp> usando o comando do Linux ls -la digitando: wsl ls -la

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

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

• Execute a ferramenta ipconfig.exe do Windows com a ferramenta grep do Linux: No Bash, digite o comando ipconfig.exe | grep IPv4 | cut -d: -f2 ou, no PowerShell, digite ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2. Este exemplo demonstra a ferramenta ipconfig no sistema de arquivos do Windows sendo usada para exibir os valores atuais de configuração de rede TCP/IP e, em seguida, sendo filtrada com o grep, uma ferramenta do Linux, para mostrar apenas o resultado de IPv4.

Montar uma unidade externa ou USB

Siga este guia passo a passo para Introdução à montagem de um disco Linux no WSL 2.

Executar aplicativos de GUI do Linux

Siga este tutorial para aprender a configurar e executar aplicativos GUI do Linux no WSL.

Recursos adicionais

• Configure seu ambiente de desenvolvimento no Windows: saiba mais sobre como configurar seu ambiente de desenvolvimento para a linguagem ou o framework de sua preferência, como React, Python, NodeJS, Vue etc.
• Resolução de problemas: Encontre problemas comuns, onde relatar bugs, onde solicitar novas funcionalidades e como contribuir com a documentação.
• Perguntas frequentes: Consulte uma lista de perguntas frequentes.
• Notas sobre a versão: examine as Notas de Versão do WSL para obter um histórico de atualizações de build anteriores. Você também pode encontrar as notas de versão do kernel Linux do WSL.