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 configurado para instalar outras distribuições Linux, usar comandos WSL básicos, configurar o Visual Studio Code ou Visual Studio, Git, Windows Credential Manager, bancos de dados como MongoDB, Postgres ou MySQL, configurar a aceleração da GPU, executar aplicativos GUI e muito mais.

Começar

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

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

Se você preferir instalar uma distribuição 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 o Prompt de Comando do Windows) e digite:

wsl --install

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

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

Será necessário reiniciar a máquina durante este processo de instalação.

Consulte o artigo de resolução de problemas de instalação caso enfrente algum problema.

Configure seu nome de usuário e senha do Linux

Quando o processo de instalação de sua distribuição Linux com WSL estiver concluído, abra a distribuição (Ubuntu por padrão) usando o menu Iniciar. Ser-lhe-á pedido para criar um Nome de Utilizador e uma Palavra-passe para a sua distribuição Linux.

• Este de Nome de Usuário e de Senha de é específico para cada distribuição Linux separada que você instala e não tem nenhuma relação com seu nome de usuário do Windows.

• Por favor, note que ao digitar o de 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 Utilizador e uma Palavra-passe, a conta será o seu utilizador predefinido para a distribuição e iniciará sessão automaticamente ao arrancar.

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

• Cada distribuição Linux em execução na WSL tem suas próprias contas de usuário e senhas do Linux. Você terá que configurar uma conta de usuário Linux toda vez que adicionar uma distribuição, reinstalar ou redefinir.

Observação

As distribuições Linux instaladas com 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: Que caracteres devo usar ou não usar em nomes de usuário no Linux?

Para alterar ou redefinir sua senha, abra a distribuição Linux e digite o comando: passwd. Ser-lhe-á pedido que introduza a sua palavra-passe atual, que introduza a sua nova palavra-passe e, em seguida, que confirme a sua nova palavra-passe.

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

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

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

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

3. Ser-lhe-á pedido para introduzir uma nova palavra-passe UNIX e, em seguida, confirmar essa palavra-passe. Depois de ser informado de que a senha foi atualizada com êxito, feche o WSL dentro do PowerShell usando o comando: exit.

Atualizar e fazer upgrade de pacotes

Recomendamos que atualize e faça upgrade regularmente dos seus pacotes usando o gestor de pacotes preferido da distribuição. Para Ubuntu ou Debian, use o comando:

sudo apt update && sudo apt upgrade

O Windows não atualiza automaticamente nem faz uma atualização de versão das suas distribuições Linux. Esta é uma tarefa que a maioria dos usuários do Linux preferem controlar a si mesmos.

Adicionar distribuições adicionais

Para adicionar distribuições Linux adicionais, você pode instalar através do Microsoft Store, através do comando --import, ou sideloading seu própriode distribuição personalizado . Você também pode querer configurar imagens WSL personalizadas para distribuição em toda a sua empresa.

Configurar o Windows Terminal

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

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

Recomendamos o uso do 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 com a configuração e personalização das suas preferências, incluindo:

• Terminal o Windows Terminal ou o Windows (Pré-visualização) a partir da Microsoft Store
• Use a paleta de comandos
• Configure ações personalizadas, como atalhos de teclado, para que o terminal se adapte às suas preferências.
• Configurar o perfil de inicialização padrão
• Personalize a aparência: tema, esquemas de cores, nome e diretório de início, imagem de fundo, etc.
• Saiba como usar argumentos de linha de comando, tais como abrir um terminal com várias linhas de comando, divididas em painéis de janela ou guias.
• Saiba mais sobre o recurso de pesquisa
• Encontre truques e dicas, como renomear ou colorir uma aba, usar interações com o rato ou ativar o "Modo Quake"
• Encontre tutoriais sobre como configurar um prompt de comando personalizado, perfis SSHou títulos de guias
• Encontre uma galeria de terminais personalizada e um guia de solução de problemas

Armazenamento de ficheiros

• Para abrir seu projeto WSL no Explorador de Arquivos do Windows, digite: explorer.exe .
  Certifique-se de adicionar o ponto no 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 estiver trabalhando neles com ferramentas Linux em uma linha de comando 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 em todos os sistemas operacionais, mas isso pode diminuir significativamente o desempenho.

Por exemplo, ao armazenar seus arquivos de projeto WSL:

• Use o diretório raiz do sistema de arquivos 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$

do Linux

Configure seu editor de código favorito

Recomendamos o uso do Visual Studio Code ou do Visual Studio, pois eles oferecem suporte direto ao desenvolvimento remoto e à depuração com o WSL. O Visual Studio Code permite que você use o WSL como um ambiente de desenvolvimento completo. O Visual Studio oferece suporte WSL nativo para desenvolvimento entre plataformas C++.

Usar o Visual Studio Code

Siga este guia passo a passo para Introdução ao uso do Visual Studio Code com WSL, que inclui a instalação do pacote de extensão Remote Development. 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 do Visual Studio Code. Troque rapidamente entre ambientes de desenvolvimento diferentes e separados e faça atualizações sem se preocupar em afetar sua máquina local.

Depois que o VS Code estiver instalado e configurado, você poderá abrir seu projeto WSL com um servidor remoto 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 Introdução ao uso do Visual Studio com WSL para desenvolvimento de plataforma cruzada C++. Visual Studio 2022 permite-lhe criar e depurar projetos CMake no Windows, em distribuições WSL e através de conexões SSH, tudo a partir da mesma instância do Visual Studio.

Configurar o gerenciamento de versões com o Git

Siga este guia passo a passo para Comece a usar o Git no WSL e conecte seu projeto ao sistema de controle de versão do Git, além de usar o gerenciador de credenciais para autenticação, usar arquivos Git Ignore, 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 Introdução aos contêineres remotos do Docker no WSL 2 e conecte seu projeto a um contêiner de desenvolvimento remoto com o Docker Desktop para Windows.

Configurar uma base de dados

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

Configure a aceleração da GPU para um desempenho mais rápido

Siga este guia passo a passo para configurar 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 pesadas de desempenho.

Comandos básicos da WSL

As distribuições Linux que você instala via WSL são melhor gerenciadas usando o PowerShell ou o Prompt de Comando do Windows (CMD). Consulte o guia de referência de comandos do 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. Eis alguns exemplos:

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

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

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

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

Monte uma unidade externa ou USB

Siga este guia passo a passo para Comece a montar um disco Linux no WSL 2.

Executar aplicativos GUI do Linux

Siga este tutorial para saber como configurar e executar aplicativos 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 de problemas: Encontre problemas comuns, onde relatar bugs, onde solicitar novos recursos e como contribuir para os documentos.
• FAQs: Encontre uma lista de perguntas frequentes.
• Notas de versão: Revise as Notas de versão do WSL para obter um histórico de atualizações de compilações anteriores. Você também pode encontrar as notas de lançamento para o WSL Linux Kernel.