3. Colocando o projeto sob controle de versão

Registrando alterações

Neste momento, o repositório não contém nenhum arquivo nem alteração. Sim, temos o arquivo hello.html no diretório de trabalho, mas ele ainda não está sob controle de versão. Precisamos adicionar explicitamente as alterações ao repositório.

Uma alteração no repositório Git é chamada de

. Você pode pensar em um commit como um snapshot do repositório em um determinado momento. Ele contém todas as alterações feitas desde o último commit. Você também pode adicionar uma mensagem ao commit para descrever o que mudou.

Antes de criar um commit, precisamos dizer ao Git quais alterações queremos colocar nesse commit. Em termos de Git, precisamos adicionar todas as alterações relevantes à

. É um jeito chique de selecionar os arquivos que queremos incluir no próximo commit.

Agora vamos adicionar nossa página "Hello, World!" ao controle de versão. Para isso, vamos usar o comando

. Depois do comando, passamos um argumento: o arquivo que queremos adicionar à staging area. No nosso caso, é o hello.html.

Executar no terminal:
git add hello.html
Tarefa
Concluída

Adicione o arquivo hello.html à staging area do repositório.

Agora, estamos prestes a fazer nosso primeiro commit. Podemos fazer isso usando o comando

assim:

Executar no terminal:
git commit -m "Initial commit"

A opção importante aqui é -m (abreviação de --message), que nos deixa escrever a mensagem do commit na própria linha do comando. Uma boa mensagem do commit explica brevemente o que mudou, para que o seu eu do futuro e a sua equipe consigam entender o histórico. Se você omitir a opção -m, o Git abre seu editor de texto padrão e pede para você escrever a mensagem lá.

Se você executou o comando de commit sem a opção -m, deve ter notado que seu terminal mudou: o histórico sumiu e você está diante de uma tela em branco. Esse é o editor de texto que o Git abriu para a mensagem do commit. Você pode escrever a mensagem, salvá-la e fechar o editor para completar o commit. Esse editor normalmente é um

como o vim ou o nano.

Parece fácil. O que poderia dar errado? Quem não conhece esses editores pode ter dificuldade até para sair deles. Se for o seu caso, aqui vão alguns vídeos que ajudam a sair desses editores: Vim, Nano.

Se nada ajudar, feche a aba ou a janela do terminal, abra uma nova e comece de novo.

No exemplo acima, o trecho "Initial commit" é o valor da opção -m, nossa mensagem do commit. Repare que a mensagem do commit deve estar entre aspas para que a mensagem inteira seja tratada como um único valor. Ela será registrada sem as aspas ao redor.

Tarefa
Concluída

Faça o commit do arquivo hello.html no repositório.

Você deve ver algo assim na saída:

Resultado:

[main (root-commit) 571a4dd] Initial commit 1 file changed, 1 insertion(+) create mode 100644 hello.html

É uma boa prática dividir alterações independentes em commits separados. Por exemplo, se você adicionou uma funcionalidade nova e corrigiu um bug, é melhor fazer dois commits separados em vez de um. Assim, você pode reverter facilmente a funcionalidade nova sem perder a correção do bug. Essa prática é chamada de

.

O nome técnico da staging area é índice (index). No GitByBit, vamos usar staging area na maioria das vezes, porque o nome descreve para que ela serve: preparar as alterações para o próximo commit.

Next step
Quer testar o modo história?

Faça o curso do jeito que ele foi pensado: progressão em pequenas doses, ordem linear e focada, desbloqueio gradual das entradas da Gitopedia. Continue com o Git de verdade no VS Code/Cursor/Antigravity/Windsurf a qualquer momento.

Modo história
GRATUITO
mas precisa de login