Partilhar via

Comece a usar o Git no Subsistema Windows para Linux

O Git é o sistema de controle de versão mais usado. Com o Git, você pode controlar as alterações feitas nos arquivos, para que tenha um registro do que foi feito e tenha a capacidade de reverter para versões anteriores dos arquivos, se necessário. O Git também facilita a colaboração, permitindo que as alterações feitas por várias pessoas sejam mescladas em uma única fonte.

O Git pode ser instalado no Windows E no WSL

Uma consideração importante: quando você habilita o WSL e instala uma distribuição Linux, você está instalando um novo sistema de arquivos, separado da unidade Windows NTFS C:\ em sua máquina. Em Linux, os drives não recebem letras. Eles recebem pontos de montagem. A raiz do seu sistema de arquivos / é o ponto de montagem da sua partição raiz, ou pasta, no caso do WSL. Nem tudo sob / é o mesmo disco. Por exemplo, no meu laptop, eu instalei duas versões do Ubuntu (20.04 e 18.04), bem como o Debian. Se eu abrir essas distribuições, selecione o diretório base com o comando cd ~e, em seguida, digite o comando explorer.exe ., o Explorador de Arquivos do Windows será aberto e me mostrará o caminho do diretório para essa distribuição.

Distribuição Linux Caminho do Windows para acessar a pasta base
Ubuntu 20,04 \\wsl$\Ubuntu-20.04\home\username
Ubuntu 18.04 \\wsl$\Ubuntu-18.04\home\username
Debian \\wsl$\Debian\home\username
Windows PowerShell C:\Users\username

Dica

Se você estiver procurando acessar o diretório de arquivos do Windows a partir de sua linha de comando de distribuição WSL, em vez de C:\Users\username, o diretório seria acessado usando /mnt/c/Users/username, porque a distribuição Linux vê seu sistema de arquivos do Windows como uma unidade montada.

Você precisará instalar o Git em cada sistema de arquivos com o qual pretende usá-lo.

Mostrando versões do Git por distro

Instalar o Git

O Git já vem instalado com a maioria das distribuições do Subsistema Windows para Linux, no entanto, você pode querer atualizar para a versão mais recente. Você também precisará configurar seu arquivo de configuração do git.

Para instalar o Git, consulte o site Download do Git para Linux. Cada distribuição Linux tem seu próprio gerenciador de pacotes e comando install.

Para a última versão estável do Git no Ubuntu / Debian, digite o comando:

sudo apt-get install git

Observação

Você também pode querer instalar o Git para Windows caso ainda não o tenha feito.

Configuração do arquivo de configuração do Git

Para configurar seu arquivo de configuração do Git, abra uma linha de comando para a distribuição em que você está trabalhando e defina seu nome com este comando (substituindo "Seu Nome" pelo seu nome de usuário preferido):

git config --global user.name "Your Name"

Defina o seu e-mail com este comando (substituindo "youremail@domain.com" pelo e-mail que preferir):

git config --global user.email "youremail@domain.com"

Dica

Se você ainda não tem uma conta do GitHub, você pode se inscrever para uma no GitHub. Se você nunca trabalhou com o Git antes, Guias do GitHub podem ajudá-lo a começar. Se você precisar editar sua configuração do Git, você pode fazê-lo com um editor de texto embutido como nano: nano ~/.gitconfig.

Recomendamos que você proteger sua conta com autenticação de dois fatores (2FA).

Configuração do Git Credential Manager

do Git Credential Manager (GCM) é um auxiliar de credenciais Git seguro criado em .NET que pode ser usado com WSL1 e WSL2. Ele habilita o suporte à autenticação multifator para repositórios GitHub, Azure DevOps, Azure DevOps Server e Bitbucket.

O GCM se integra ao fluxo de autenticação de serviços como o GitHub e, uma vez autenticado em seu provedor de hospedagem, solicita um novo token de autenticação. Em seguida, armazena o token de forma segura no Gerenciador de Credenciais do Windows. Após a primeira vez, você pode usar o Git para falar com seu provedor de hospedagem sem precisar autenticar novamente. Ele apenas acessará o token no Gerenciador de Credenciais do Windows.

Para usar o GCM com WSL, você deve estar no Windows 10 Versão 1903 ou posterior. Esta é a primeira versão do Windows que inclui a ferramenta de wsl.exe necessária que o GCM usa para interoperar com o Git em suas distribuições WSL.

Recomenda-se instalar o Git mais recente para Windows para compartilhar credenciais & configurações entre o WSL e o host Windows. O Git Credential Manager está incluído no Git para Windows e a versão mais recente está incluída em cada nova versão do Git para Windows. Durante a instalação, você será solicitado a selecionar um auxiliar de credencial, com o GCM definido como padrão.

Se você tiver um motivo para não instalar o Git para Windows, poderá instalar o GCM como um aplicativo Linux diretamente em sua distribuição WSL, mas observe que isso significa que o GCM está sendo executado como um aplicativo Linux e não pode utilizar os recursos de autenticação ou armazenamento de credenciais do sistema operacional Windows host. Consulte o repositório GCM para obter instruções sobre como configurar o WSL sem o Git para Windows.

Para configurar o GCM para uso com uma distribuição WSL, abra sua distribuição e digite este comando:

Se o GIT instalado for >= v2.39.0

git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager.exe"

caso contrário, se o GIT instalado for >= v2.36.1

git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/libexec/git-core/git-credential-manager.exe"

Caso contrário, se a versão for < v2.36.1, digite este comando:

git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager-core.exe"

Observação

Usar o GCM como um auxiliar de credenciais para uma instalação do WSL Git significa que qualquer configuração definida no WSL Git NÃO é respeitada pelo GCM (por padrão). Isso ocorre porque o GCM está sendo executado como um aplicativo do Windows e, portanto, usará a instalação do Git para Windows para consultar a configuração. Isso significa que coisas como configurações de proxy para GCM precisam ser definidas no Git para Windows, bem como no WSL Git, pois são armazenadas em arquivos diferentes (%USERPROFILE%\.gitconfig vs \\wsl$\distro\home\$USER\.gitconfig). Você pode configurar o WSL para que o GCM use a configuração do WSL Git, mas isso significa que as configurações de proxy serão exclusivas para a instalação específica do WSL e não compartilhadas com outras pessoas ou com o host Windows.

Git com SSH

O Git Credential Manager só funciona com controles remotos HTTP(S). Você ainda pode usar o Git com SSH:

Configuração adicional para o Azure

Se você pretende trabalhar com Azure Repos ou Azure DevOps, algumas configurações adicionais são necessárias:

git config --global credential.https://dev.azure.com.useHttpPath true

Agora, qualquer operação git que você executar em sua distribuição WSL usará o GCM. Se você já tiver credenciais armazenadas em cache para um host, ele as acessará a partir do gerenciador de credenciais. Caso contrário, você receberá uma resposta de diálogo solicitando suas credenciais, mesmo que esteja em um console Linux.

Dica

Se você estiver usando uma chave GPG para segurança de assinatura de código, talvez seja necessário associar sua chave GPG ao seude e-mail do GitHub.

Adicionando um ficheiro Git Ignore

Recomendamos adicionar um arquivo .gitignore aos seus projetos. O GitHub oferece uma coleção de modelos .gitignore úteis com configurações de arquivo .gitignore recomendadas organizadas de acordo com seu caso de uso. Por exemplo, aqui está o modelo padrão de gitignore do GitHub para um projeto Node.js.

Se você optar por criar um novo repositório usando o site do GitHub, há caixas de seleção disponíveis para inicializar seu repositório com um arquivo LEIA-ME, arquivo .gitignore configurado para seu tipo de projeto específico e opções para adicionar uma licença, se você precisar de uma.

Git e VS Code

O Visual Studio Code vem com suporte interno para o Git, incluindo uma guia de controle do código-fonte que mostrará suas alterações e manipulará uma variedade de comandos git para você. Saiba mais sobre o suporte Git do VS Code .

Terminações de linha Git

Se você estiver trabalhando com a mesma pasta de repositório entre Windows, WSL ou um contêiner, certifique-se de configurar terminações de linha consistentes.

Como o Windows e o Linux usam terminações de linha padrão diferentes, o Git pode relatar um grande número de arquivos modificados que não têm diferenças além de suas terminações de linha. Para evitar que isso aconteça, você pode desativar a conversão de terminação de linha usando um arquivo .gitattributes ou globalmente no lado do Windows. Veja este documento do VS Code sobre como resolver problemas de terminação de linha Git.

Recursos adicionais