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+Espaco) 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 instalacao:
Depois de instalar, abra o terminal e confirme:
git --version
Se aparecer algo como git version 2.43.0 (qualquer versao 2+), esta tudo certo.
Dica: se o comando git nao for reconhecido no Windows, reinicie o terminal ou o computador. A instalacao pode precisar que o terminal seja reaberto.
Configuracao inicial: sua identidade
Antes de usar o Git, voce precisa configurar seu nome e email. Essas informacoes aparecem em cada commit que voce fizer — sao 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 configuracoes valem para todos os repositorios do seu computador. Voce so precisa fazer isso uma vez.
Importante: use o mesmo email que voce vai cadastrar no GitHub. Isso garante que seus commits sejam vinculados ao seu perfil. Se os emails forem diferentes, suas contribuicoes aparecem como de um usuario desconhecido.
Opcional, mas recomendado — definir o VS Code como editor padrao:
git config --global core.editor "code --wait"
Conhecendo o terminal: comandos basicos
Muita gente tem medo do terminal — aquela tela preta com letras. Mas e mais simples do que parece. Para trabalhar com Git, voce precisa de apenas 5 comandos de navegacao:
| Comando | O que faz | Exemplo |
|---|---|---|
pwd | Mostra em qual pasta voce esta | 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 nivel |
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 digitacao e acelera tudo.
No Windows, se voce estiver usando o Git Bash (recomendado), esses mesmos comandos funcionam normalmente. Fora do Git Bash, os equivalentes sao diferentes (dir no lugar de ls, por exemplo), entao use o Git Bash para acompanhar este tutorial.
Criando seu primeiro repositorio
Agora vem a parte boa. Vamos criar um repositorio 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 repositorio Git:
git init
Esse comando cria uma subpasta oculta chamada .git dentro do seu projeto. E ali que o Git guarda todo o historico. A partir de agora, essa pasta e um repositorio Git — cada alteracao pode ser rastreada.
Passo 3 — Crie um arquivo:
echo "# Meu Primeiro Projeto" > README.md
Passo 4 — Verifique o estado do repositorio:
git status
Voce vai ver que README.md aparece como "untracked" (em vermelho). Isso significa que o Git sabe que o arquivo existe, mas ainda nao esta rastreando ele.
Seu primeiro commit
Aqui acontece a magica. O fluxo basico do Git segue tres etapas: editar → git add (preparar) → git commit (salvar no historico).
Passo 5 — Adicione o arquivo ao staging:
git add README.md
O staging area (area de preparacao) e onde voce seleciona quais alteracoes quer incluir no proximo commit. Nem tudo que voce alterou precisa entrar no mesmo commit — e isso e uma das grandes vantagens do Git.
Passo 6 — Faca o commit:
git commit -m "Primeiro commit: adiciona README"
Pronto. Voce acabou de salvar a primeira versao do seu projeto no historico do Git. O -m permite escrever a mensagem do commit diretamente na linha de comando.
Boas praticas para mensagens de commit: use verbos no imperativo e seja descritivo. "Adiciona validacao de email" e muito melhor do que "alteracoes diversas". Se alguem ler apenas a mensagem, deve entender o que foi feito sem precisar olhar o codigo.
Para ver o historico 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 comeco.
Conectando ao GitHub
Ate agora, tudo esta no seu computador (local). Para colocar seu projeto no GitHub, siga estes passos:
1. Crie uma conta no GitHub em github.com (se ainda nao tiver).
2. Crie um novo repositorio clicando em "New repository". De o mesmo nome da sua pasta (meu-primeiro-repo). Nao marque nenhuma opcao de inicializacao (sem README, sem .gitignore).
3. Conecte seu repositorio local ao GitHub:
git remote add origin https://github.com/seu-usuario/meu-primeiro-repo.git
4. Envie seu codigo 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 a branch main no GitHub. Voce so precisa usar -u no primeiro push. Nos proximos, basta git push.
Atualize a pagina do GitHub e voce vai ver seu arquivo la. Parabens — seu codigo esta na nuvem.
O fluxo do dia a dia: add, commit, push
Depois que o repositorio esta configurado, sua rotina com Git se resume a:
# 1. Faca suas alteracoes nos arquivos
# 2. Veja o que mudou
git status
# 3. Adicione as alteracoes ao staging
git add arquivo-alterado.txt
# 4. Faca 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 alteracoes que outros membros enviaram para o GitHub. Sempre faca git pull antes de git push — se alguem enviou commits que voce nao 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 diferenca entre Git e GitHub?
Git e a ferramenta de controle de versao que roda no seu computador. GitHub e uma plataforma online que hospeda repositorios Git e oferece recursos de colaboracao (Pull Requests, Issues, etc). Voce pode usar Git sem GitHub, mas nao GitHub sem Git.
Preciso saber usar o terminal para usar Git?
Tecnicamente, existem interfaces graficas (como GitHub Desktop e o painel do VS Code). Mas aprender os comandos basicos no terminal te da mais controle e e o que a maioria das equipes profissionais usa. Os 5 comandos de navegacao que mostrei aqui sao tudo que voce precisa para comecar.
O que e um commit, na pratica?
Um commit e como tirar uma "foto" do estado atual dos seus arquivos. Ele registra exatamente o que mudou, quando, e quem fez a alteracao. Voce pode voltar a qualquer commit anterior se precisar. Pense nele como um ponto de salvamento em um jogo.
Errei um commit. Como desfaco?
Se voce quer desfazer o ultimo commit mas manter as alteracoes nos arquivos, use:
git reset --soft HEAD~1
Isso remove o commit do historico mas mantem seus arquivos intactos. Voce pode corrigir e commitar de novo.
Se voce quer ir alem deste tutorial e dominar Git e GitHub de verdade — com exercicios praticos, quizzes e projetos guiados — confira o curso Git e GitHub Essencial na Rangers League Academy, disponivel em /pt-BR/academy. La voce vai aprender desde os fundamentos ate fluxos avancados como branching, merge, resolucao de conflitos e Pull Requests. Tudo no ritmo certo para quem esta comecando.
