Primeiros passos com o Git

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

Learn to code with GitHub Copilot

Artigo 2 de 10
Avançar:Localizando e entendendo código 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 as noções básicas de 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 ao GitHub Desktop, clique em Concluir. 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 .

  3. Selecione "Inicializar este repositório com um README" para criar automaticamente um arquivo em branco.

    Dica

    É prática padrão incluir um arquivo , 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 Exibir no GitHub.

Configurando um espaço para fazer alterações

Agora que você criou um repositório, vamos falar sobre ramificações. Branches, ou ramificações, são essencialmente cópias do seu projeto onde você pode testar alterações sem arriscar a estabilidade do trabalho já existente.

Os repositórios são criados automaticamente com um branch , 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 corresponde ao site que os visitantes podem ver.

Quando você cria um novo branch, está criando um espaço seguro para trabalhar em uma nova funcionalidade sem afetar a versão principal. Você e seus colaboradores podem usar ramificações diferentes para trabalhar em várias funcionalidades 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 e clique em Create Branch.

Salvando capturas do seu 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 .

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 Abrir em Visual Studio Code.

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

    Markdown
    Hello, World!

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

  3. Ao retornar para GitHub Desktop, você verá as atualizações que acabou de fazer no arquivo 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 o commit, clique em Commit para atualização do readme.

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 para o branch original, .

  1. Clique em Publish branch para fazer o push do branch 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 , na parte inferior da página, clique em Merge pull request.

    Observação

    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 Excluir ramificação. Excluir branches que foram mesclados ao ajuda a manter o repositório limpo e fácil de navegar.

Preparando-se para fazer mais alterações

Parabéns por integrar seu primeiro pull request! Agora que você incorporou suas alterações com sucesso na filial, existem algumas etapas que você deve seguir para se preparar para o próximo conjunto de alterações:

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

    Você quase sempre deve voltar para o branch 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 remoto, clique em Fetch origin.

  3. Por fim, para atualizar o branch local com alterações no branch 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 você estiver usando 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 CLI do GitHub Copilot para que você possa usar o Copilot na linha de comando. Consulte AUTOTITLE

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 , 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 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 setas do teclado para escolher o comando git 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 .

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 e 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 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!

AnteriorConfigurando Copilot para aprender a codificarAvançarLocalizando e entendendo código de exemplo