Antes de começar, já devo avisar que o objetivo desta série não é ensinar git de A até Z como muitos fazem, pois eu não acho que conseguiria fazer algo melhor do que a documentação do git, que tem uma leitura fácil e entendível para quem está iniciando, além de ter uma boa parte já traduzida para o português brasileiro, caso tenha dificuldades com o inglês.
\nMeu objetivo é simplificar seu aprendizado, abordando o essencial, destrinchando as entrelinhas e explicando de uma forma fácil para iniciantes.
\n\n\nNota: Entenda que estamos falando do git (ferramenta de controle de versão), não do GitHub (repositório remoto). Isso porque em algum momento você irá trabalhar em empresas que utilizam outros, como BitBucket e GitLab. Pesquisem por conta sobre esses repositórios remotos. Se em algum momento eu me referir a repositório remoto, assuma que estou falando do GitHub para esses exemplos, mas o mesmo se aplicaria de forma similar aos outros citados.
\n
Vamos supor que você já assistiu seu curso da Udemy ou do YouTube e já sabe o básico do funcionamento de git. Logo, caso tenha entendido corretamente, o primeiro passo é inicializar um repositório dentro do diretório do seu projeto com o comando git init.
enzo@pc-do-enzo:~/projeto$ git init\nInitialized empty Git repository in /home/enzo/projeto/.git/\nenzo@pc-do-enzo:~/projeto$\nO que você precisa entender agora é que, ao inicializar um repositório, um diretório chamado .git será criado no diretório do projeto e que por padrão, nenhum dos seus arquivos estará, mas o git já consegue vê-los. Além disso, todos seus arquivos começarão com o estado untracked ou "não rastreado".
enzo@pc-do-enzo:~/projeto$ git status\nOn branch main\n\nNo commits yet\n\nUntracked files:\n (use "git add <file>..." to include in what will be committed)\n index.html\n style.css\n\nnothing added to commit but untracked files present (use "git add" to track)\nenzo@pc-do-enzo:~/projeto$\nÉ essencial que você entenda que o git possui três áreas e que seus arquivos vão ter estados nessas áreas. As áreas basicamente são: working directory, staging area e o diretório .git do projeto.
![\"As](\"/media/git-areas.png\")
\nResumindo o fluxo nessas áreas de maneira simples.
\n.gitVocê, como um ótimo desenvolvedor, terminou a primeira tarefa do projeto, que era criar o código HTML e o CSS de uma página importante e agora você quer que o git faça o versionamento desse código.
\nPrimeiro, precisamos adicionar as alterações que fizemos para a área de staging, ou "área de preparo". Para isso, utilizamos o comando git add que pode ser chamado das seguintes formas:
git add index.html: Adiciona um arquivo específicogit add index.html style.css: Adiciona múltiplos arquivosgit add foo/bar: Adiciona todos os arquivos de um diretóriogit add .: Adiciona todos os arquivosenzo@pc-pc-do-enzo:~/projeto$ git add index.html style.css\nenzo@pc-pc-do-enzo:~/projeto$ git status\nOn branch main\n\nNo commits yet\n\nChanges to be committed:\n (use "git rm --cached <file>..." to unstage)\n new file: index.html\n new file: style.css\n\nenzo@pc-pc-do-enzo:~/projeto$\nComo pode ver, as informações do comando git status são bem claras:
git rm --cached <nome-arquivo> para retirar da staging area de volta para o working directory.Agora, eu realmente espero que você tenha se questionado do seguinte:
\n\n\n"E se eu fizer uma modificação em um arquivo que eu já adicionei na staging area?"
\n
E aqui entramos em outro conceito importante que não se aplica somente ao git, mas em muitas ferramentas que você vai encontrar e ele se chama diffing.
\nEm termos simples, diffing é o processo de comparação entre arquivos, para saber o que mudou de um arquivo para outro. Você pode pensar nisso como um "jogo dos 7 erros", onde você tinha duas imagens e precisava encontrar a diferença entre elas.
\nGraças ao diffing, o git consegue te dizer exatamente quais linhas foram adicionadas (+) e quais linhas foram removidas (-) na comparação de uma versão anterior de um arquivo a uma versão atual.
\nenzo@pc-do-enzo:~/projeto$ git diff\ndiff --git a/index.html b/index.html\nindex c3939a0..e60d682 100644\n--- a/index.html\n+++ b/index.html\n@@ -7,12 +7,13 @@\n <link rel="stylesheet" href="style.css">\n </head>\n <body>\n- <h1>Página inicial</h1>\n+ <h1>Página inicial alterada</h1>\n <p>\n Lorem ipsum dolor, sit amet consectetur adipisicing elit. Harum ipsum\n temporibus minima explicabo molestiae repellendus deleniti dolore, at\n vitae illo numquam eaque veritatis exercitationem. Aliquam repudiandae\n similique quaerat quia optio.\n </p>\n+ <p>Uma nova alteração</p>\n </body>\n </html>\nenzo@pc-do-enzo:~/projeto$\nEntão, quando você realiza a modificação de um arquivo que já está na staging area, esse arquivo terá uma versão na staging area que irá para o próximo commit e uma versão em estado modified no working directory.
\nenzo@pc-do-enzo:~/projeto$ git status\nOn branch main\n\nNo commits yet\n\nChanges to be committed:\n (use "git rm --cached <file>..." to unstage)\n new file: index.html\n new file: style.css\n\nChanges not staged for commit:\n (use "git add <file>..." to update what will be committed)\n (use "git restore <file>..." to discard changes in working directory)\n modified: index.html\n\nenzo@pc-do-enzo:~/projeto$\n\n\n"Mas e se quiser adicionar a nova alteração que fiz junto a que já está na staging area?"
\n
Basta adicionar essa alteração com o git add quantas vezes forem necessárias.
A partir deste ponto, vamos assumir que você já fez e adicionou tudo o que era necessário e está pronto para o commit.
\n\n\nMas o que é esse tal de commit que tanto é falado?
\n
Um commit é um objeto do git que de fato vai registrar uma versão de código dentro do seu repositório git. Ele trás metadados como:
\nPara realizar o commit, você deve executar o comando git commit, que pode receber algumas opções, mas por enquanto vamos falar somente da flag -m
Se você deseja realizar o commit com uma descrição simples:
\ngit commit -m 'feat: implementação da página inicial do projeto'
Se você deseja realizar o commit com uma descrição simples e informar mais detalhes:\ngit commit
Isso irá abrir o editor padrão configurado para o git, para que você possa escrever mais detalhes sobre o commit. Você terá instruções em forma de comentários, indicando como você deve estruturar a mensagem.
\nGNU nano 7.2 /home/enzo/projeto/.git/COMMIT_EDITMSG *\n\nfeat: implementação da página inicial do projeto\n<ENTER>\n- Criação do header fixo\n- Criação de efeito parallax\n- Carregamento de fontes via CDN\n\n# Please enter the commit message for your changes. Lines starting\n# with '#' will be ignored, and an empty message aborts the commit.\n#\n# On branch main\n#\n# Initial commit\n#\n# Changes to be committed:\n# new file: index.html\n# new file: style.css\n#\n# Changes not staged for commit:\n# modified: index.html\n#\nAo salvar e sair, seu commit terá sido realizado.
\nenzo@pc-pc-do-enzo:~/projeto$ git commit\n[main (root-commit) af17a38] feat: implementação da página inicial do projeto\n 2 files changed, 32 insertions(+)\n create mode 100644 index.html\n create mode 100644 style.css\nenzo@pc-pc-do-enzo:~/projeto$\nE você pode ver detalhes sobre esse commit e outros, obtendo seus logs, com o comando git log.
commit af17a38bca106c5316239f9e209cc3c1d43fd5c5 (HEAD -> main)\nAuthor: Enzo da Silva <enzosilva@gmail.com>\nDate: Fri Feb 6 03:42:34 2026 -0300\n\n feat: implementação da página inicial do projeto\n\n - Criação do header fixo\n - Criação de efeito parallax\n - Carregamento de fontes via CDN\nNesta primeira parte da série, você aprendeu a inicializar um repositório git, preparar alterações para seu _commit e como realizá-lo.
\nAlém disso, expliquei sobre o diffing, que é o processo que o git usa para fazer comparações entre arquivos de versões diferentes, para saber qual mudança houve entre eles.
\nComo material complementar, eu fortemente recomendo que você leia os capitulos 1.1 até o 2.3 da documentação do git para entender com mais detalhes o que foi abordado aqui, pois sempre utilizo ele como base quando preciso explicar git
\nNo próximo capítulo, pretendo falar sobre:
\nQueria deixar registrado, meu agradecimento ao meu amigo Fabrício, que criou este espaço e permitiu que eu e outras pessoas compartilhássemos nossos conhecimentos com vocês.
\nhttps://git-scm.com/book/en/v2
\nhttps://git-scm.com/book/pt-br/v2
\nAgradeço a contribuição do Matheus Henrique.
\nGitHub: github.com/mathstylish
\nLinkedIn: linkedin.com/in/mathstylish/