O Que É o Git e Porque Deve Utilizá-lo

O que é o Git

O Git é um sistema de controlo de versões distribuído que regista as alterações nos ficheiros e permite que as equipas colaborem eficientemente no mesmo projeto. Foi criado por Linus Torvalds em 2005 para o desenvolvimento do kernel do Linux e tornou-se desde então o padrão de facto da indústria. Quer trabalhe sozinho num pequeno projeto, quer numa equipa de cem programadores, o Git permite-lhe acompanhar todas as alterações, voltar a versões anteriores e trabalhar em várias funcionalidades em paralelo sem conflitos.

Ao contrário de sistemas mais antigos como o SVN, o Git é distribuído, o que significa que cada programador tem uma cópia completa de todo o histórico do projeto no seu computador. Isto permite trabalhar sem ligação à internet, operações mais rápidas porque a maioria das coisas é feita localmente, e maior resistência à perda de dados, porque cada clone é uma cópia de segurança completa. Compreender o Git é hoje uma competência básica para qualquer programador e developer web.

Porque utilizar o Git

Registo de alterações

Sem um sistema de controlo de versões, os programadores recorrem à cópia manual de ficheiros. Para guardar projetos, considere o espaço de cópia de segurança com nomes como site-v2-versao-final-2.zip. Esta abordagem é insustentável porque rapidamente se torna impossível saber que versão contém que alterações. O Git regista automaticamente cada alteração com a informação de quem a fez, quando e porquê. Pode ver todo o histórico do projeto, comparar quaisquer duas versões e saber exatamente que linha de código foi alterada em qualquer momento.

Cada commit no Git é um instantâneo do estado do projeto num momento específico, com uma mensagem que descreve o que mudou e porquê. Isto é inestimável quando, meses mais tarde, precisa de compreender porque foi feita uma alteração ou de encontrar o commit que introduziu um bug. O comando git blame mostra quem alterou pela última vez cada linha de código, acelerando a identificação dos responsáveis por uma parte específica do código.

Branches e trabalho em paralelo

As branches do Git são uma das funcionalidades mais poderosas. Uma branch é uma linha de desenvolvimento independente que lhe permite trabalhar numa nova funcionalidade sem afetar o código principal. Pode criar uma branch para cada correção de bug ou nova funcionalidade, trabalhar nela o tempo que for necessário e juntá-la à branch principal apenas quando tudo estiver testado e pronto. Se a funcionalidade se revelar uma má ideia, basta apagar a branch sem quaisquer consequências para o resto do projeto.

Numa equipa, cada programador pode trabalhar na sua branch sem se preocupar em sobrescrever o trabalho de outra pessoa. O Git junta automaticamente as alterações de diferentes branches e, na maioria dos casos, fá-lo sem intervenção. Quando ocorre um conflito, o Git assinala claramente as partes problemáticas e pede ao programador para o resolver manualmente. Isto é muito melhor do que o cenário alternativo em que dois programadores alteram o mesmo ficheiro e um sobrescreve o trabalho do outro sem aviso.

Cópia de segurança e recuperação

Cada repositório Git num servidor remoto como o GitHub serve de cópia de segurança de todo o projeto com o histórico completo. Mesmo que o seu disco rígido falhe, pode clonar o repositório num computador novo em segundos e continuar o trabalho exatamente onde o deixou. O Git guarda todas as versões de todos os ficheiros alguma vez registados em commit, o que significa que pode reverter qualquer ficheiro para qualquer estado anterior. Isto é um seguro de vida para qualquer projeto.

Comandos básicos do Git

Inicialização e configuração

Começar com o Git requer a instalação e a configuração básica. Na maioria das distribuições Linux, o Git já está instalado ou instala-se com apt install git ou dnf install git. No macOS vem com as Xcode Command Line Tools. Após a instalação, configure o nome e o email utilizados nos commits com git config global user.name "O Seu Nome" e git config global user.email voce@email.com. Esta informação é registada em cada commit.

Cria um novo repositório com git init na diretoria do projeto. Isto cria uma pasta oculta .git que contém todo o histórico e a configuração do repositório. Em alternativa, pode clonar um repositório existente com git clone URL, que descarrega o projeto com todo o histórico para o seu computador. O ficheiro .gitignore define que ficheiros o Git deve ignorar, como a diretoria node_modules, os ficheiros .env com segredos e os ficheiros binários compilados.

Comandos do dia a dia

O comando git status mostra o estado atual do repositório — que ficheiros estão alterados, quais foram adicionados à staging area e quais não estão a ser acompanhados. Use-o frequentemente para ter uma visão geral do que se passa. O git add adiciona ficheiros à staging area, que é a preparação para o commit. Pode adicionar ficheiros individuais com git add ficheiro.js ou todos os ficheiros alterados com git add ., mas tenha cuidado para não adicionar ficheiros indesejados.

O comando git commit cria um instantâneo do estado atual da staging area, com uma mensagem descritiva. Uma boa mensagem de commit é curta mas informativa, por exemplo "Adicionar validação do campo de email no formulário de contacto." A convenção é escrever as mensagens no imperativo, como se estivesse a dizer o que o commit faz. O git log mostra o histórico de commits com identificadores hash, autores, datas e mensagens. Use git log oneline para uma visão compacta ou git log graph para a representação visual das branches.

Trabalhar com branches

Criar uma nova branch: git branch nome-da-branch cria uma branch mas não muda para ela. O git checkout nome-da-branch muda para uma branch existente. A combinação git checkout -b nome-da-branch cria uma nova branch e muda imediatamente para ela, o que é o fluxo de trabalho mais comum. O Git moderno oferece também o comando git switch, que é uma alternativa mais intuitiva ao checkout quando se trabalha com branches. Dê nomes descritivos às branches, como feature/encomendas-online ou fix/bug-login.

A junção de branches faz-se com git merge nome-da-branch, estando na branch para a qual quer juntar as alterações. O fluxo típico é: mudar para a branch principal e depois executar o merge da sua feature branch. Se não houver conflitos, o Git junta o código automaticamente. Se houver conflitos, o Git assinala as partes problemáticas nos ficheiros com marcadores especiais e você escolhe manualmente que alterações manter. Após resolver os conflitos, faz commit do resultado.

GitHub e repositórios remotos

O GitHub é a plataforma mais popular para alojamento de repositórios Git, com mais de 100 milhões de utilizadores. Além do armazenamento de código, o GitHub oferece o acompanhamento de issues, o fluxo de pull requests, CI/CD com o GitHub Actions, páginas wiki e muito mais. Entre as plataformas alternativas estão o GitLab, que oferece self-hosting, e o Bitbucket, que se integra bem com as ferramentas da Atlassian, como o Jira.

O comando git remote add origin URL liga o repositório local ao remoto no GitHub. O git push envia os seus commits para o servidor remoto, onde os outros membros da equipa os podem ver e descarregar. O git pull descarrega as alterações mais recentes do remoto e junta-as ao seu código local. O git fetch descarrega as alterações mas não as junta automaticamente, dando-lhe a oportunidade de as rever antes de as juntar.

Fluxo de Pull Request

Um pull request ou PR é um mecanismo de revisão de código antes da junção com a branch principal. O programador cria uma branch, faz commit das alterações, faz push para o GitHub e abre um PR com a descrição das alterações. Os outros membros da equipa revêem o código e deixam comentários e sugestões. Só após a aprovação por um ou mais revisores é que o PR é juntado à branch principal. Este fluxo garante a qualidade do código e a partilha de conhecimento na equipa, pois cada programador vê o que os outros estão a fazer.

Um bom PR tem uma mensagem clara que descreve o que mudou e porquê, uma dimensão razoável porque rever um PR com milhares de linhas de código é impossível, e verificações automáticas como testes e linting a correr através do CI/CD. O GitHub Actions pode correr automaticamente os testes em cada push e mostrar o resultado no PR, impedindo a junção de código que parta os testes.

O Git no fluxo de deployment

O Git é a base do deployment moderno, especialmente em servidores VPS. A abordagem mais simples é o deployment manual, em que se executa git pull no servidor para descarregar as alterações mais recentes. Isto é suficiente para sites pequenos, mas não escala bem e está sujeito a erros humanos. Uma abordagem melhor é o deployment automatizado, em que um push para uma branch específica como a main aciona automaticamente o deployment através de uma pipeline de CI/CD.

Um fluxo automatizado típico funciona assim: o programador faz push do código para o GitHub, o GitHub Actions corre os testes e o build, se tudo passar o código é automaticamente implementado no servidor de staging para teste, e após a aprovação é implementado em produção. Esta abordagem elimina a possibilidade de esquecer correr os testes ou de implementar a versão errada. Na BeoHosting, suportamos o deployment via Git para todos os pacotes de alojamento, com automatização através de webhooks.

Estratégias de Git para equipas

O Git Flow é uma estratégia de branching popular que define funções para diferentes branches: main para o código de produção, develop para o desenvolvimento, feature branches para novas funcionalidades, release branches para a preparação de versões e hotfix branches para correções urgentes em produção. Esta estratégia é minuciosa, mas pode ser demasiado complexa para equipas pequenas. O trunk-based development é uma alternativa mais simples, em que todos os programadores fazem commit diretamente na branch principal, com feature branches curtas que duram um ou dois dias.

Independentemente da estratégia, várias regras são universais: nunca fazer commit diretamente na branch principal, usar sempre PR para revisão, escrever mensagens de commit descritivas, manter os commits pequenos e focados numa única alteração, e nunca fazer commit de segredos como palavras-passe ou chaves de API. Se fizer commit de um segredo por engano, altere-o de imediato, porque mesmo após o apagar do histórico, é possível que alguém já o tenha descarregado.

Conclusão

O Git é uma ferramenta indispensável para quem trabalha com código, quer seja um developer a solo, quer faça parte de uma grande equipa. Investir na aprendizagem do Git compensa muitas vezes através de uma melhor organização, da segurança do código e de um trabalho de equipa mais eficiente. Comece pelos comandos básicos, use o GitHub para o alojamento dos repositórios e introduza gradualmente fluxos de trabalho mais avançados. Na BeoHosting, suportamos o deployment via Git para todos os pacotes de alojamento, permitindo-lhe implementar de forma rápida e fiável diretamente a partir do seu repositório.