Aprender Git: o tutorial completo para principiantes

O Git é um sistema de controlo de versões distribuído. Regista o estado dos teus ficheiros em cada etapa do trabalho, permite-te voltar atrás e torna possível trabalhar em várias pessoas no mesmo projeto sem que umas apaguem o trabalho das outras. É a ferramenta de base da profissão: serve tanto para um script de cem linhas como para o kernel do Linux.

O Git não é o GitHub

É a confusão mais frequente de quem começa. O Git é um programa que corre na tua máquina e gere o histórico do teu projeto numa pasta escondida, .git. Funciona sem ligação à internet e sem conta em lado nenhum.

O GitHub, o GitLab ou o Bitbucket são alojadores de repositórios Git. Guardam uma cópia do teu projeto nos seus servidores, servem de ponto de encontro a uma equipa e acrescentam as suas próprias ferramentas à volta do Git: gestão de tickets, revisão de código, integração contínua. Podes usar o Git a vida toda sem nunca criares uma conta no GitHub. O contrário não faz sentido.

Neste tutorial, o Git é a ferramenta que aprendes, o GitHub e o GitLab são os serviços que usas para partilhar o teu trabalho.

O que vais saber fazer no fim

• Instalar o Git e configurá-lo bem à primeira, incluindo a autenticação por chave SSH.
• Criar um repositório no GitHub ou no GitLab e ligá-lo a uma pasta da tua máquina, nos dois sentidos.
• Registar o teu trabalho em etapas legíveis, consultar o histórico e desfazer um erro sem perder tudo.
• Trabalhar numa branch, fundi-la e resolver um conflito à mão.
• Escolher o modelo de branches adequado à tua equipa, entre Gitflow e trunk-based development.

Do que precisas

Um terminal e mais nada. Este tutorial não usa nenhuma interface gráfica: nem o GitHub Desktop, nem o separador Git do teu editor. Essas ferramentas são práticas depois de perceberes o que fazem no teu lugar, e enganadoras antes disso. Todos os comandos funcionam da mesma maneira em Windows (no Git Bash), macOS e Linux.

Não é preciso qualquer conhecimento prévio, mas saber andar num terminal com o cd e o ls ajuda muito.

Uma palavra sobre as versões

O Git é um software estável e lento a mudar: os comandos deste tutorial funcionam há anos e vão continuar a funcionar. Ainda assim, há dois pontos que se mexem e que são tratados explicitamente nos capítulos em causa.

Primeiro, os comandos git switch e git restore, surgidos com o Git 2.23 em 2019, que substituem com vantagem o git checkout para mudar de branch e desfazer alterações. Já não estão marcados como experimentais na documentação oficial. Este tutorial ensina-os em primeiro lugar e dá o equivalente em git checkout para conseguires ler o código dos outros.

Depois, o nome da branch por omissão. Ao contrário do que se pensa, no Git 2.55 o git init continua a criar uma branch master, e não main. A mudança está anunciada para o Git 3.0. O primeiro capítulo mostra-te como resolver isto de uma vez por todas.

O percurso

1. Instalar e configurar o Git, instalação por sistema, identidade, branch por omissão e autenticação por chave SSH ou token.
2. Criar um repositório e trazê-lo para local, os dois caminhos possíveis: clonar um repositório existente, ou publicar uma pasta que já tens.
3. Os comandos básicos — status, add, commit, push, pull, o ficheiro .gitignore e, sobretudo, como desfazer um disparate.
4. Trabalhar em equipa com as branches, criar uma branch, fundi-la, resolver um conflito e escolher entre merge e rebase.
5. Gitflow ou trunk-based, os dois modelos de branches, os seus comandos e o contexto em que cada um se justifica.

Os capítulos seguem-se: cada um retoma o projeto onde o anterior o deixou. Ainda assim, podes entrar diretamente naquele que te interessa, porque os comandos necessários são relembrados.

Este tutorial faz parte do percurso Desenvolvimento web da Gekkode.