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 decontrole 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ê precisainstalar 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.
- Baixe o GitHub Desktop.
- Abra o GitHub Desktop, clique emSign in to GitHub.com e autorize o GitHub Desktop a acessar sua conta.
- De volta no GitHub Desktop, clique emFinish. 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 umrepositó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óriolocal:
No GitHub Desktop, clique emCreate a New Repository on your Local Drive.
Dê ao repositório o nome
learning-git.SelecioneInitialize this repository with a README para criar um arquivo
README.mdem branco automaticamente.Dica
É 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.Clique emCriar 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órioremoto para o mesmo projeto que será hospedado no GitHub. Vincular um repositório remoto facilita a colaboração e o backup do trabalho.
- No GitHub Desktop, clique emPublish repository.
- No pop-up exibido, clique emPublish repository mais uma vez.
- Para ver o repositório remoto, clique emView on GitHub.
Configurando um espaço para fazer alterações
Agora que você criou um repositório, vamos falar sobrebranches. 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 branchmain, que você pode considerar como a versão estável e primária do projeto. Por exemplo, no repositório de um site, o branchmain 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:
- No GitHub Desktop, selecione o menu suspensoCurrent Branch e clique emNew Branch.
- Dê ao novo branch o nome
readme-updatese clique emCreate Branch.
Salvando snapshots do projeto
Para salvar seu progresso no branch, você faz umcommit. 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 arquivoREADME.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.
No GitHub Desktop, clique emOpen in Visual Studio Code.
No VS Code, cole o seguinte texto em
README.mde salve as alterações:Markdown Hello, World!This is a demo project for learning how to use Git.
Hello, World!This is a demo project for learning how to use Git.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 chamamensagem do commit e ajuda você a acompanhar as alterações feitas em cada commit.
Para fazer commit, clique emCommit 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 umapull 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 emreadme-updates para o branch original,main.
Clique emPublish branch para efetuar push do branch
readme-updatescom suas alterações para o repositório remoto.Para revisar as alterações sugeridas, clique emPreview Pull Request.
Clique emCriar Solicitação de Pull.
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.
Clique emCriar solicitação de pull.
Para colocar as alterações no branch
main, na parte inferior da página, clique emMerge 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.
Próximo à parte inferior da página, clique emDelete branch. Excluir branches que foram mesclados ao
mainajuda 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 branchmain, há algumas etapas que deve adotar para se preparar para a próxima rodada de alterações:
No GitHub Desktop, se você não está no branch
main, selecione o menu suspensoCurrent Branch e clique emmain.Você quase sempre deve voltar para o branch
mainantes de criar outro branch, já que novos branches são criados como cópias do branch selecionado no momento.Para verificar se alguma alteração foi feita no branch
mainremoto, clique emFetch origin.Por fim, para atualizar o branch
mainlocal com alterações no branchmainremoto, clique emPull 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.
No GitHub Desktop, pressioneCtrl+` para abrir seu projeto na linha de comando.
Se estiver usando o Windows,instale o Git. Para macOS e Linux, o Git é instalado por padrão.
Instale a GitHub CLI, que permite executar ações relacionadas ao GitHub rapidamente na linha de comando.
Para se autenticar no GitHub usando a GitHub CLI, execute o seguinte comando:
Shell gh auth login
gh auth loginEscolha autenticar com oGitHub.com e siga os prompts na tela.
Instale a CLI do GitHub Copilot para que você possa usar o Copilot na linha de comando. ConfiraComo instalar a CLI do GitHub 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 mencionargit blame, mas não sabe o que ele faz. Experimente pedir que o Copilot explique isso com o seguinte comando:
gh copilot explain "git blame"
gh copilot explain "git blame"O Copilot informará quegit 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:
git blame README.md
git blame README.mdTrata-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ê:
gh copilot suggest "Show me the blame for line 1 of README.md"
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 escolhergit command e pressioneEnter. O Copilot vai sugerir o seguinte comando:
git blame -L 1,1 README.md
git blame -L 1,1 README.mdUse as teclas de direção para escolherExecute command e pressioneEnter. Você verá o autor e o commit da última linha 1 modificada deREADME.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. Experimentamosgh copilot explain egh 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 pressionandoCtrl+O (Windows/Linux) ouCommand+O (Mac) e experimente os benefícios do controle de versão por conta própria!