Instalar o Git e criar o primeiro repositório

No fim desta aula vais ter o Git instalado e configurado com o teu nome, e uma pasta de projeto que já guarda o próprio histórico. Não precisas de saber programar: o exemplo do curso é uma lista de receitas em texto simples, e tudo o que aprenderes serve igualmente para código, documentos ou qualquer projeto feito de ficheiros.

Para que serve o Git

O Git é um sistema de controlo de versões. Em vez de guardares lista-final.md, lista-final-2.md e lista-final-mesmo.md, guardas versões do mesmo ficheiro, cada uma com uma data, um autor e uma frase que explica o que mudou. Podes voltar a qualquer versão, comparar duas versões e trabalhar numa alteração arriscada sem estragar a versão que funciona.

Há uma diferença importante em relação a outros sistemas mais antigos: no Git, cada pasta de projeto tem o histórico completo. Não dependes de um servidor nem de ligação à Internet para guardar versões. O GitHub, que vais usar no módulo 3, serve para partilhar e guardar uma cópia online, mas o Git funciona sem ele.

Instalar e confirmar

• Windows: instala o «Git for Windows» a partir de git-scm.com. Aceita as opções propostas; no fim terás o programa «Git Bash», que é onde vais escrever os comandos.
• macOS: abre o Terminal e escreve git --version. Se o Git não existir, o sistema propõe instalar as ferramentas de linha de comandos.
• Linux: usa o gestor de pacotes da tua distribuição, por exemplo sudo apt install git.

Confirma a instalação:

git --version

Deves ver algo como git version 2.43.0. Qualquer versão igual ou superior a 2.28 serve para este curso. Os exemplos foram testados com a 2.43.

Dizer ao Git quem és

Cada versão guardada fica assinada com um nome e um e-mail. Configura-os uma única vez no computador:

git config --global user.name "Ana Silva"
git config --global user.email "ana@exemplo.pt"
git config --global init.defaultBranch main

A terceira linha define main como nome do ramo principal dos projetos novos. É o nome usado pelo GitHub e em quase toda a documentação atual; algumas instalações antigas ainda usam master. Para verificares o que ficou guardado, usa git config --list.

Se mais tarde quiseres ligar-te ao GitHub, usa aqui o mesmo e-mail da tua conta GitHub.

Criar o repositório

Um repositório é uma pasta cujo histórico o Git acompanha. Cria uma nova:

git init receitas
cd receitas

O Git responde com Initialized empty Git repository in .../receitas/.git/. Se já tiveres uma pasta com ficheiros, entra nela e escreve apenas git init.

Lista o conteúdo, incluindo ficheiros escondidos:

ls -A

Vais ver uma pasta .git. É aí que o Git guarda todo o histórico. As tuas pastas de trabalho ficam limpas, sem ficheiros de controlo espalhados. Por isso mesmo, nunca apagues nem edites a pasta .git à mão: apagá-la é apagar o histórico.

O comando que vais usar mais vezes

git status

Num repositório acabado de criar, a resposta é:

On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

Lê-se assim: estás no ramo main, ainda não guardaste nenhuma versão e não há nada para guardar. Ganha o hábito de escrever git status antes e depois de cada passo: é a forma mais simples de confirmares que estás a fazer o que pensas que estás a fazer.

Nota: As mensagens do Git podem aparecer em português se o teu sistema estiver configurado nessa língua. O significado é o mesmo.

Exercício

1. Instala o Git e confirma a versão.
2. Configura o nome, o e-mail e main como ramo por omissão.
3. Cria o repositório receitas e confirma com git status que não há versões.

Como sabes que correu bem: git config --list mostra o teu nome e e-mail, e git status dentro de receitas mostra On branch main e No commits yet.

Fonte e licença. Adaptado de «Git», Wikibooks (colaboradores), capítulos «Obtaining Git» e «Introduction», CC BY-SA 4.0 — https://en.wikibooks.org/wiki/Git. Alterações: tradução para português europeu, atualização para o Git atual e exemplos novos. Esta aula é distribuída sob a mesma licença (https://creativecommons.org/licenses/by-sa/4.0/).