Git e GitHub: O Guia para Salvar Seus Projetos (e Sua Sanidade) em 5 Passos

Você está lá, focado, escrevendo seu código. Seu primeiro projeto começa a ganhar forma. E então, uma gota de suor frio escorre pela sua testa. O medo bate.

E se meu computador quebrar amanhã? E se eu apagar um arquivo importante sem querer? E se eu fizer uma alteração que estraga tudo e não souber como voltar atrás?

De repente, seu precioso projeto parece um frágil castelo de cartas.

Muitos iniciantes, nesse momento, recorrem ao método que conhecem: projeto_v1.zip, projeto_final.zip, projeto_agora_vai_FINAL.zip. Como sua mentora, estou aqui para te dizer: existe uma forma muito melhor, a forma que os profissionais usam.

Resumo rápido

• Git roda no seu computador e registra cada mudança do seu código, é o seu sistema de versionamento local. GitHub é o serviço na nuvem que hospeda esses repositórios.
• O fluxo que você vai usar quase todo dia é sempre o mesmo: git add, git commit, git push.
• Dado real: segundo o relatório Octoverse 2025 do GitHub, a plataforma passou de 180 milhões de desenvolvedores cadastrados, o maior crescimento absoluto da sua história.

Git e GitHub não são a mesma coisa

Antes de digitar qualquer comando, vale reforçar a diferença entre as duas ferramentas, porque essa confusão trava muito iniciante:

• Git: é o programa instalado no seu computador. Ele funciona totalmente offline, controla as versões do seu código e rastreia cada mudança. É o seu sistema de segurança local, criado por Linus Torvalds (o mesmo criador do Linux) em 2005.
• GitHub: é o site na internet. É um serviço de hospedagem para repositórios Git, comprado pela Microsoft em 2018. É a sua fortaleza na nuvem, seu portfólio público e uma rede social para código.

Você usa o Git para versionar o projeto localmente e o GitHub para enviar essa versão para a nuvem. Simples assim.

Mindset chave: pense em “checkpoints”, não em “salvar”

Apertar Ctrl + S simplesmente sobrescreve um arquivo. É um ato de esquecimento.

Um commit no Git é diferente. É um checkpoint, como em um videogame. Você chegou a um ponto seguro, uma pequena parte do seu código está funcionando, e cria um commit para registrar esse momento. Se mais tarde você cair num abismo de bugs, pode simplesmente voltar para o último checkpoint. Essa mudança de mentalidade, de “salvar” para “criar checkpoints”, é o que te dá superpoderes.

Passo 1: configuração inicial (só acontece uma vez)

Se você seguiu o guia Do Zero ao Hello World, você já instalou o Git no seu PC. Se ainda não instalou, o download oficial está em git-scm.com.

Agora, vamos apresentar você a ele. Abra seu terminal (PowerShell no Windows, Terminal no Mac/Linux) e rode estes dois comandos, um de cada vez, substituindo pelos seus dados:

git config --global user.name "Seu Nome Completo"
git config --global user.email "seuemail@exemplo.com"

Isso é como assinar um documento. Cada checkpoint que você criar vai carregar essa assinatura.

Agora, crie sua conta gratuita em github.com. É como criar qualquer outra conta de rede social.

Passo 2: criando seu primeiro repositório

Um “repositório” (ou “repo”) é apenas um nome chique para a pasta de um projeto.

No GitHub, depois de criar sua conta, clique no sinal de + no canto superior direito e selecione “New repository”. Dê um nome ao seu projeto (por exemplo, meu-primeiro-site), marque-o como “Public” (para que ele possa entrar no seu portfólio) e clique em “Create repository”.

No seu PC, crie uma pasta para o mesmo projeto e entre nela pelo terminal:

mkdir meu-primeiro-site
cd meu-primeiro-site

Passo 3: o fluxo de trabalho essencial

Esta é a sequência de comandos que você vai usar na maior parte do tempo. Rode-a dentro da pasta do seu projeto, no terminal.

git init Liga o controle de versão na pasta atual. Ele cria uma subpasta oculta .git que passa a rastrear tudo. Acontece só uma vez por projeto.

git add . Seleciona os arquivos para o próximo checkpoint. Se você alterou 3 arquivos, git add . seleciona todas as mudanças da pasta para serem commitadas.

git commit -m "Mensagem descritiva aqui" Cria o checkpoint com as mudanças que você adicionou. A mensagem entre aspas é crucial: ela deve descrever o que você fez (por exemplo, “Cria a página inicial HTML” ou “Corrige o bug no botão de contato”).

git push Envia seus checkpoints locais para o GitHub.

Na primeira vez, o Git não sabe para onde enviar. O GitHub te dá os comandos exatos na página do seu repositório recém-criado, parecidos com isto:

git remote add origin https://github.com/seu-usuario/meu-primeiro-site.git
git branch -M main
git push -u origin main

Copie e cole esses comandos. Nas próximas vezes, você só vai precisar digitar git push.

(Um detalhe técnico: desde outubro de 2020 o GitHub usa main como nome padrão do branch principal em vez de master, por isso o comando git branch -M main aparece no fluxo.)

Passo 4: verificando se deu certo

Volte para a página do seu repositório no GitHub e atualize a página (F5). Lá estarão eles: seus arquivos, seguros, na nuvem. A sensação de ver seu código ali, sabendo que está protegido e acessível de qualquer lugar do mundo, compensa o esforço de aprender o fluxo.

Passo 5: a regra do “commit pequeno, commit frequente”

A tentação do iniciante é trabalhar por 5 horas e só no final fazer um commit gigante. Não faça isso. A regra de ouro é: fez uma pequena parte que funciona? Crie um checkpoint.

Corrigiu um bug visual? git commit -m "Corrige cor do botão principal". Adicionou um parágrafo no seu blog? git commit -m "Adiciona seção sobre a regra de ouro". Isso transforma seu histórico em uma narrativa clara e torna muito mais fácil reverter um erro pequeno, em vez de ter que desfazer horas de trabalho de uma vez.

Esse histórico organizado também vira prova de trabalho: é justamente esse tipo de repositório público, com commits claros, que compõe seu portfólio quando você for buscar sua primeira vaga como desenvolvedor.

Perguntas frequentes

Preciso estar conectado à internet para usar o Git? Não. Você pode usar git add e git commit o dia inteiro offline, por exemplo em uma viagem. Você só precisa de internet no momento do git push, quando envia o trabalho para o GitHub.

O que é um branch? Parece complicado. Um branch (ramo) é como criar uma cópia do seu projeto para experimentar uma funcionalidade nova sem estragar a versão principal que já funciona. É um conceito poderoso, mas para começar, foque em dominar o fluxo no branch principal (main).

GitHub é o único site que faz isso? Não. Existem alternativas usadas no mercado, como o GitLab e o Bitbucket, comuns em ambientes corporativos. Para quem está começando, porém, o GitHub costuma ser a escolha mais prática pela comunidade, pela integração com outras ferramentas e por ser o padrão de fato para projetos de código aberto e portfólios pessoais.

Conclusão

Hoje você aprendeu um fluxo de trabalho que protege seu bem mais valioso: seu tempo e seu código. A diferença entre Git e GitHub não é mais um mistério, e o ciclo add, commit, push é o seu novo hábito de segurança.

Com o código seguro no GitHub, você não tem apenas um backup. Você tem o começo do seu portfólio profissional, o mesmo tipo de repositório público que serve de prova de trabalho quando chega a hora de aplicar para vagas. Se ainda não tem um projeto próprio para versionar, o guia do Kit de Ferramentas do Programador mostra como construir seu primeiro app do zero.