O que é Git e GitHub? Guia prático para principiantes

Se alguma vez guardaste ficheiros como trabalho_final.docx, trabalho_final_2.docx e trabalho_final_agora_sim.docx, já percebeste o problema que o Git resolve. É a ferramenta que quase todos os programadores usam para guardar o histórico do seu código. O GitHub é o sítio onde esse código fica guardado na internet. Neste guia explicamos tudo de forma simples.

O que é o Git

O Git é um sistema de controlo de versões. Regista cada alteração que fazes ao teu projeto, com data e descrição, e permite:

• voltar a uma versão anterior se algo correr mal;
• ver exatamente o que mudou e quando;
• trabalhar com outras pessoas no mesmo projeto sem se apagarem o trabalho;
• testar ideias novas sem estragar a versão que funciona.

O Git corre no teu computador, mesmo sem internet.

O que é o GitHub

O GitHub é um serviço online onde guardas repositórios (projetos) Git. Funciona como uma "nuvem" para o teu código e como um portfólio público: recrutadores e colegas podem ver o que fazes. Existem alternativas, como GitLab e Bitbucket, com ideias muito semelhantes.

Conceitos-chave

• Repositório: a pasta do projeto com o seu histórico.
• Commit: um "ponto de gravação" com uma mensagem a explicar o que mudou.
• Branch (ramo): uma linha paralela de trabalho, para testar coisas sem mexer na principal.
• Merge: juntar um ramo à principal.
• Remote: a cópia do repositório no GitHub.
• Push e pull: enviar as tuas alterações para o GitHub e trazer as de lá.

Instalar e configurar

1. Instala o Git a partir de git-scm.com.
2. No terminal, diz quem és:

git config --global user.name "O Teu Nome"
git config --global user.email "o.teu@email.com"

1. Cria uma conta gratuita no GitHub.

O fluxo básico, passo a passo

Dentro da pasta do teu projeto:

git init
git add .
git commit -m "Primeira versão do projeto"

• git init cria o repositório.
• git add . prepara todos os ficheiros para serem gravados.
• git commit grava o ponto no histórico.

Para ligar ao GitHub, cria um repositório vazio lá e depois:

git remote add origin https://github.com/o-teu-utilizador/o-teu-projeto.git
git branch -M main
git push -u origin main

A partir daqui, o ciclo diário é simples:

git add .
git commit -m "Adicionei o formulário de contacto"
git push

Comandos úteis para o dia a dia

• git status: mostra o que mudou.
• git log --oneline: lista o histórico resumido.
• git diff: mostra as diferenças linha a linha.
• git checkout -b nova-funcionalidade: cria um ramo novo e muda para ele.
• git pull: traz as alterações do GitHub.

Boas práticas de commits

1. Faz commits pequenos, com uma ideia de cada vez.
2. Escreve mensagens claras: "Corrige erro no cálculo do troco" é melhor do que "mudanças".
3. Nunca envies palavras-passe, chaves de API ou ficheiros pessoais. Usa um ficheiro .gitignore para os excluir.
4. Não faças commit de pastas enormes que se regeneram, como node_modules.

Como usar o GitHub como portfólio

Cria repositórios com nomes claros, escreve um README.md que explique o que o projeto faz e como correr, e fixa os melhores no teu perfil. Vê o nosso guia sobre como criar um portfólio de programador.

Erros comuns

• Ter medo do Git. Começa só com add, commit e push; o resto vem com o tempo.
• Trabalhar na main em equipa sem avisar.
• Enviar segredos por engano. Se acontecer, muda logo a palavra-passe ou chave.