Primeiros passos com o Git

Aprenda noções básicas sobre o Git trabalhando em um cenário de exemplo.

Neste artigo

Você já quis ter uma máquina do tempo para seu código? Bem, o Git é exatamente isso e muito mais!

Se você não está familiarizado com o Git, trata-se de um sistema de controle de versão que ajuda você a controlar alterações em seu código. Você pode salvar um snapshot de seu projeto em um determinado ponto no tempo e fazer alterações experimentais sem arriscar seu trabalho, já que você sempre pode voltar ao snapshot.

O GitHub é uma plataforma criada em torno do Git que permite que você salve projetos do Git na nuvem e trabalhe neles com outros desenvolvedores.

Embora possa ser complicado, o Git é uma ferramenta poderosa e necessária para qualquer desenvolvedor. Este artigo fornecerá todas as ferramentas necessárias para usar o Git em seu fluxo de trabalho cotidiano.

Pré-requisitos

Para seguir este tutorial, você precisa instalar o Visual Studio Code.

Aprendendo noções básicas do Git com o GitHub Desktop

Para operações Git padrão, recomendamos o GitHub Desktop, um aplicativo que permite interagir visualmente com o Git em vez de por meio de comandos escritos. Nesta seção, aprenderemos a usar o GitHub Desktop para executar rapidamente as operações Git mais comuns.

Configurando o GitHub Desktop

Se esta for a primeira vez que usa o GitHub Desktop, você precisará instalá-lo e conectar sua conta do GitHub.

  1. Baixe o GitHub Desktop.
  2. Abra o GitHub Desktop, clique em Sign in to GitHub.com e autorize o GitHub Desktop a acessar sua conta.
  3. De volta no GitHub Desktop, clique em Finish. Isso adicionará seu nome e o email de sua conta do GitHub ao Git.

Criando um repositório local

Agora, você pode dar seus primeiros passos no Git criando um repositório. Pense em um repositório como uma pasta de projeto que controla as alterações e armazena o histórico. Primeiro, criaremos um repositório local:

  1. No GitHub Desktop, clique em Create a New Repository on your Local Drive.

  2. Dê ao repositório o nome learning-git.

  3. Selecione Initialize this repository with a README para criar um arquivo README.md em branco automaticamente.

    Tip

    É prática padrão incluir um arquivo README.md, também conhecido como README, em seus projetos. Normalmente, os arquivos README contêm informações que ajudam outras pessoas a entender, configurar e executar seu projeto.

  4. Clique em Criar repositório.

Criando um repositório remoto

O repositório local que você acabou de criar fica em seu computador. Agora, vamos criar um repositório remoto para o mesmo projeto que será hospedado no GitHub. Vincular um repositório remoto facilita a colaboração e o backup do trabalho.

  1. No GitHub Desktop, clique em Publish repository.
  2. No pop-up exibido, clique em Publish repository mais uma vez.
  3. Para ver o repositório remoto, clique em View on GitHub.

Configurando um espaço para fazer alterações

Agora que você criou um repositório, vamos falar sobre branches. Essencialmente, branches são cópias do projeto em que você pode testar alterações sem arriscar a estabilidade do trabalho existente.

Os repositórios são criados automaticamente com um branch main, que você pode considerar como a versão estável e primária do projeto. Por exemplo, no repositório de um site, o branch main corresponde ao site que os visitantes podem ver.

Quando cria outro branch, você está criando um espaço seguro para trabalhar em um novo recurso sem afetar a versão primária. Você e seus colaboradores podem usar branches diferentes para trabalhar em vários recursos ao mesmo tempo.

Vamos criar um branch para trabalhar em alterações no repositório:

  1. No GitHub Desktop, selecione o menu suspenso Current Branch e clique em New Branch.
  2. Dê ao novo branch o nome readme-updates e clique em Create Branch.

Salvando snapshots do projeto

Para salvar seu progresso no branch, você faz um commit. Um commit é um snapshot que você faz do projeto em um determinado momento. Na verdade, você já fez o primeiro commit: quando você inicializou o projeto com um README, o GitHub Desktop criou automaticamente um commit inicial para adicionar o arquivo README.md.

Sempre que concluir uma parte do trabalho que deseja salvar, faça um commit. Depois de fazer isso, você sempre poderá voltar a esse ponto no tempo, não importa quantas alterações faça no futuro.

  1. No GitHub Desktop, clique em Open in Visual Studio Code.

  2. No VS Code, cole o seguinte texto em README.md e salve as alterações:

    Markdown
    Hello, World!

This is a demo project for learning how to use Git.

  3. De volta no GitHub Desktop, você verá as atualizações que acabou de fazer no README. No canto inferior esquerdo, ao lado de sua foto de perfil do GitHub, digite "Atualizar README" na caixa de texto. Isso se chama mensagem do commit e ajuda você a acompanhar as alterações feitas em cada commit.

  4. Para fazer commit, clique em Commit to readme-updates.

Trazendo as alterações para o branch principal

Quando estiver satisfeito com as alterações feitas em um branch, você poderá publicar o branch no repositório remoto e criar uma pull request. Pull requests permitem que você revise um conjunto de alterações propostas e, em seguida, mescle-as de um branch em outro. Em nosso caso, criaremos uma pull request que traz as alterações feitas em readme-updates para o branch original, main.

  1. Clique em Publish branch para efetuar push do branch readme-updates com suas alterações para o repositório remoto.

  2. Para revisar as alterações sugeridas, clique em Preview Pull Request.

  3. Clique em Criar Solicitação de Pull.

  4. Na janela do GitHub exibida, altere o título da pull request para "Adicionar uma mensagem ao README" e escreva uma breve descrição das alterações na caixa de comentários.

  5. Clique em Criar solicitação de pull.

  6. Para colocar as alterações no branch main, na parte inferior da página, clique em Merge pull request.

    Note

    Quando você está trabalhando em um projeto com outros desenvolvedores, é prática padrão que outra pessoa revise sua pull request antes que ela seja mesclada.

  7. Próximo à parte inferior da página, clique em Delete branch. Excluir branches que foram mesclados ao main ajuda a manter o repositório limpo e fácil de navegar.

Preparando-se para fazer mais alterações

Parabéns por mesclar sua primeira pull request! Agora que você colocou suas alterações com êxito no branch main, há algumas etapas que deve adotar para se preparar para a próxima rodada de alterações:

  1. No GitHub Desktop, se você não está no branch main, selecione o menu suspenso Current Branch e clique em main.

    Você quase sempre deve voltar para o branch main antes de criar outro branch, já que novos branches são criados como cópias do branch selecionado no momento.

  2. Para verificar se alguma alteração foi feita no branch main remoto, clique em Fetch origin.

  3. Por fim, para atualizar o branch main local com alterações no branch main remoto, clique em Pull origin.

Agora, você tem todas as habilidades necessárias para configurar e usar o Git em um projeto!

Aprofundando-se no Git na linha de comando

O GitHub Desktop foi projetado para atender às suas necessidades diárias do Git. À medida que você evolui como desenvolvedor, é provável que encontre algumas situações incomuns em que deseja ter mais controle sobre uma operação Git ou precisa usar comandos mais complexos. Nesses casos, você precisará usar comandos Git gravados na linha de comando.

Configurando a linha de comando

Antes de começar a trabalhar com a linha de comando, você precisa configurar algumas ferramentas.

  1. No GitHub Desktop, pressione Ctrl+` para abrir seu projeto na linha de comando.

  2. Se estiver usando o Windows, instale o Git. Para macOS e Linux, o Git é instalado por padrão.

  3. Instale a GitHub CLI, que permite executar ações relacionadas ao GitHub rapidamente na linha de comando.

  4. Para se autenticar no GitHub usando a GitHub CLI, execute o seguinte comando:

    Shell
    gh auth login

    Escolha autenticar com o GitHub.com e siga os prompts na tela.

  5. Instale a GitHub Copilot in the CLI, uma extensão avançada para a GitHub CLI que ajuda você a encontrar e entender comandos executando o seguinte comando:

    Shell
    gh extension install github/gh-copilot

Experimentando comandos complexos

Agora que está tudo pronto, vamos ver como encontrar e entender os comandos necessários no futuro. Por exemplo, digamos que você viu alguém online mencionar git blame, mas não sabe o que ele faz. Experimente pedir que o Copilot explique isso com o seguinte comando:

Shell
gh copilot explain "git blame"

O Copilot informará que git blame fornece um histórico detalhado de um arquivo, mostrando o autor e o commit que modificou pela última vez cada linha no arquivo. Experimente por conta própria com o seguinte comando:

Shell
git blame README.md

Trata-se de uma ótima ferramenta, mas como você pode imaginar, o blame de um arquivo pode ficar muito longo. Digamos que você tenha interesse apenas na atualização mais recente de uma linha específica em um arquivo. Você pode pedir ao Copilot para criar o comando certo para você:

Shell
gh copilot suggest "Show me the blame for line 1 of README.md"

Quando o Copilot perguntar que tipo de comando você está procurando, use as teclas de direção para escolher git command e pressione Enter. O Copilot vai sugerir o seguinte comando:

Shell
git blame -L 1,1 README.md

Use as teclas de direção para escolher Execute command e pressione Enter. Você verá o autor e o commit da última linha 1 modificada de README.md.

Revisão e próximas etapas

Neste artigo, abordamos as noções básicas do Git com o GitHub Desktop, e aprendemos termos importantes como:

  • Repositório: uma pasta que salva todas as alterações feitas nos arquivos em seu projeto.
  • Commit: um snapshot do projeto em um determinado momento.
  • Branch: uma cópia do projeto em que você pode trabalhar em um conjunto de alterações.
  • Pull request: uma solicitação para mesclar as alterações de um branch em outro.

Também tratamos sobre como executar operações Git mais complicadas na linha de comando. Experimentamos gh copilot explain e gh copilot suggest para entender e encontrar novos comandos e funcionalidades.

Agora, tente aplicar o que você aprendeu ao seu trabalho. Adicione o Git a um projeto existente com o GitHub Desktop pressionando Ctrl+O (Windows/Linux) ou Command+O (Mac) e experimente os benefícios do controle de versão por conta própria!