Guia Prático: Primeiros Passos com Git e GitHub
Se você trabalha ou pretende trabalhar com Salesforce — especialmente no lado de desenvolvimento — vai esbarrar em Git e GitHub mais cedo ou mais tarde. Na verdade, provavelmente mais cedo. É uma daquelas habilidades que ninguém te ensina na faculdade, mas que todo tech lead espera que você saiba no primeiro dia.
A boa notícia: Git não é tão complicado quanto parece. Neste guia, vou te levar do zero ao seu primeiro repositório no GitHub, passo a passo. Sem mistério, sem jargão desnecessário.
O que é Git (e por que você precisa dele)
Git é um sistema de controle de versão. Na prática, ele rastreia todas as alterações que você faz nos seus arquivos e permite voltar a qualquer versão anterior. Pense nele como um "Ctrl+Z infinito e inteligente" para o seu código.
GitHub é uma plataforma online que hospeda repositórios Git. É onde equipes colaboram, revisam código e mantêm projetos organizados. Se Git é o motor, GitHub é a garagem na nuvem.
Toda empresa séria que trabalha com Salesforce usa Git. Se você quer se destacar no mercado, dominar essas ferramentas não é opcional — é pré-requisito.
Instalando o Git no seu computador
O processo é simples e leva menos de 5 minutos, independentemente do seu sistema operacional.
Windows:
Baixe o instalador em git-scm.com. Na instalação, aceite as opções padrão. Ele inclui o Git Bash, um terminal próprio que emula comandos Linux no Windows — é o que vamos usar neste tutorial.
macOS:
Abra o Terminal (busque "Terminal" no Spotlight com Cmd+Espaço) e digite:
git --version
Se o Git não estiver instalado, o sistema vai oferecer para instalar automaticamente. Você também pode instalar via Homebrew:
brew install git
Linux (Ubuntu/Debian):
sudo apt update && sudo apt install git
Para Fedora: sudo dnf install git.
Verificando a instalação:
Depois de instalar, abra o terminal e confirme:
git --version
Se aparecer algo como git version 2.43.0 (qualquer versão 2+), está tudo certo.
Dica: se o comando git não for reconhecido no Windows, reinicie o terminal ou o computador. A instalação pode precisar que o terminal seja reaberto.
Configuração inicial: sua identidade
Antes de usar o Git, você precisa configurar seu nome e email. Essas informações aparecem em cada commit que você fizer — são sua assinatura digital.
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"
Para confirmar que deu certo:
git config user.name
git config user.email
O --global significa que essas configurações valem para todos os repositórios do seu computador. Você só precisa fazer isso uma vez.
Importante: use o mesmo email que você vai cadastrar no GitHub. Isso garante que seus commits sejam vinculados ao seu perfil. Se os emails forem diferentes, suas contribuições aparecem como de um usuário desconhecido.
Opcional, mas recomendado — definir o VS Code como editor padrão:
git config --global core.editor "code --wait"
Conhecendo o terminal: comandos básicos
Muita gente tem medo do terminal — aquela tela preta com letras. Mas é mais simples do que parece. Para trabalhar com Git, você precisa de apenas 5 comandos de navegação:
| Comando | O que faz | Exemplo |
|---|---|---|
pwd | Mostra em qual pasta você está | pwd → /Users/voce/projetos |
ls | Lista arquivos da pasta atual | ls → pasta1 pasta2 arquivo.txt |
cd pasta | Entra em uma pasta | cd projetos → entra na pasta |
cd .. | Volta uma pasta acima | cd .. → sobe um nível |
mkdir nome | Cria uma pasta nova | mkdir meu-projeto → cria a pasta |
Dica: a tecla Tab autocompleta nomes de pastas e arquivos no terminal. Comece a digitar e pressione Tab. Isso evita erros de digitação e acelera tudo.
No Windows, se você estiver usando o Git Bash (recomendado), esses mesmos comandos funcionam normalmente. Fora do Git Bash, os equivalentes são diferentes (dir no lugar de ls, por exemplo), então use o Git Bash para acompanhar este tutorial.
Criando seu primeiro repositório
Agora vem a parte boa. Vamos criar um repositório Git do zero, direto no terminal.
Passo 1 — Crie uma pasta para o projeto e entre nela:
mkdir meu-primeiro-repo
cd meu-primeiro-repo
Passo 2 — Inicialize o repositório Git:
git init
Esse comando cria uma subpasta oculta chamada .git dentro do seu projeto. É ali que o Git guarda todo o histórico. A partir de agora, essa pasta é um repositório Git — cada alteração pode ser rastreada.
Passo 3 — Crie um arquivo:
echo "# Meu Primeiro Projeto" > README.md
Passo 4 — Verifique o estado do repositório:
git status
Você vai ver que README.md aparece como "untracked" (em vermelho). Isso significa que o Git sabe que o arquivo existe, mas ainda não está rastreando ele.
Seu primeiro commit
Aqui acontece a mágica. O fluxo básico do Git segue três etapas: editar → git add (preparar) → git commit (salvar no histórico).
Passo 5 — Adicione o arquivo ao staging:
git add README.md
O staging area (área de preparação) é onde você seleciona quais alterações quer incluir no próximo commit. Nem tudo que você alterou precisa entrar no mesmo commit — e isso é uma das grandes vantagens do Git.
Passo 6 — Faça o commit:
git commit -m "Primeiro commit: adiciona README"
Pronto. Você acabou de salvar a primeira versão do seu projeto no histórico do Git. O -m permite escrever a mensagem do commit diretamente na linha de comando.
Boas práticas para mensagens de commit: use verbos no imperativo e seja descritivo. "Adiciona validação de email" é muito melhor do que "alterações diversas". Se alguém ler apenas a mensagem, deve entender o que foi feito sem precisar olhar o código.
Para ver o histórico dos seus commits:
git log --oneline
Dica: para sair da tela do git log, pressione a tecla q. Muita gente fica presa nessa tela no começo.
Conectando ao GitHub
Até agora, tudo está no seu computador (local). Para colocar seu projeto no GitHub, siga estes passos:
1. Crie uma conta no GitHub em github.com (se ainda não tiver).
2. Crie um novo repositório clicando em "New repository". Dê o mesmo nome da sua pasta (meu-primeiro-repo). Não marque nenhuma opção de inicialização (sem README, sem .gitignore).
3. Conecte seu repositório local ao GitHub:
git remote add origin https://github.com/seu-usuario/meu-primeiro-repo.git
4. Envie seu código para o GitHub:
git push -u origin main
O -u origin main configura o tracking, ou seja, diz ao Git que a branch main local corresponde à branch main no GitHub. Você só precisa usar -u no primeiro push. Nos próximos, basta git push.
Atualize a página do GitHub e você vai ver seu arquivo lá. Parabéns — seu código está na nuvem.
O fluxo do dia a dia: add, commit, push
Depois que o repositório está configurado, sua rotina com Git se resume a:
# 1. Faça suas alterações nos arquivos
# 2. Veja o que mudou
git status
# 3. Adicione as alterações ao staging
git add arquivo-alterado.txt
# 4. Faça o commit
git commit -m "Descreve o que foi feito"
# 5. Envie para o GitHub
git push
E quando estiver trabalhando em equipe, comece sempre o dia com:
git pull
Isso baixa as alterações que outros membros enviaram para o GitHub. Sempre faça git pull antes de git push — se alguém enviou commits que você não tem, o push vai ser rejeitado.
Regra de ouro: chegou para trabalhar? git pull. Vai encerrar o dia? git push. Commits pequenos e frequentes ao longo do dia. Simples assim.
FAQ
Qual a diferença entre Git e GitHub?
Git é a ferramenta de controle de versão que roda no seu computador. GitHub é uma plataforma online que hospeda repositórios Git e oferece recursos de colaboração (Pull Requests, Issues, etc). Você pode usar Git sem GitHub, mas não GitHub sem Git.
Preciso saber usar o terminal para usar Git?
Tecnicamente, existem interfaces gráficas (como GitHub Desktop e o painel do VS Code). Mas aprender os comandos básicos no terminal te dá mais controle e é o que a maioria das equipes profissionais usa. Os 5 comandos de navegação que mostrei aqui são tudo que você precisa para começar.
O que é um commit, na prática?
Um commit é como tirar uma "foto" do estado atual dos seus arquivos. Ele registra exatamente o que mudou, quando, e quem fez a alteração. Você pode voltar a qualquer commit anterior se precisar. Pense nele como um ponto de salvamento em um jogo.
Errei um commit. Como desfaço?
Se você quer desfazer o último commit mas manter as alterações nos arquivos, use:
git reset --soft HEAD~1
Isso remove o commit do histórico mas mantém seus arquivos intactos. Você pode corrigir e commitar de novo.
Se você quer ir além deste tutorial e dominar Git e GitHub de verdade — com exercícios práticos, quizzes e projetos guiados — confira o curso Git e GitHub Essencial na Rangers League Academy, disponível em /pt-BR/academy. Lá você vai aprender desde os fundamentos até fluxos avançados como branching, merge, resolução de conflitos e Pull Requests. Tudo no ritmo certo para quem está começando.
