Todo mundo já ouviu: "Git é essencial para programar." É mito? Não. Git é o sistema de controle de versão mais usado, e GitHub é onde os projetos vivem online. A boa notícia: configurar Git e GitHub do zero leva menos de 15 minutos. Este guia mostra o passo a passo, com os comandos exatos e os erros que todo iniciante comete.
Passo 1: Instalar o Git
O Git não vem instalado no Windows nem no macOS. Baixe o instalador em [git-scm.com](https://git-scm.com), a versão mais recente é sempre a recomendada. Durante a instalação, aceite as opções padrão, mas preste atenção na tela "Choosing the default editor": escolha um editor que você conheça (VS Code ou Nano).
Dica: No Linux (Ubuntu/Debian), use sudo apt install git. No macOS, pode usar o Homebrew: brew install git.
Erro comum: Pular a instalação do Git Bash. No Windows, o Git Bash é o terminal que permite rodar comandos Unix. Use-o, não o CMD.
Passo 2: Criar uma conta no GitHub
Acesse [github.com](https://github.com) e clique em "Sign up". Escolha um nome de usuário profissional, algo como seunome-dev. Use um e-mail que você verifica com frequência. Após o cadastro, confirme o e-mail clicando no link enviado.
Dica: Ative a autenticação de dois fatores (2FA) nas configurações de segurança. É rápido e evita dores de cabeça.
Erro comum: Usar o mesmo e-mail do trabalho para conta pessoal. Separe contas profissional e pessoal para evitar conflitos de acesso.
Passo 3: Configurar nome de usuário e e-mail no Git
Abra o Git Bash (ou terminal) e rode:
git config --global user.name "Seu Nome" git config --global user.email "[email protected]"
Use o mesmo nome e e-mail da sua conta GitHub. O --global aplica a configuração para todos os repositórios do seu computador. Se quiser configurar apenas um repositório, remova --global.
Dica: Para verificar se deu certo: git config --list. Isso mostra todas as configurações ativas.
Erro comum: Digitar o e-mail errado. O Git associa cada commit ao e-mail configurado. Um erro aqui e seus commits aparecem sem foto no GitHub.
Passo 4: Configurar chave SSH (autenticação sem senha)
A chave SSH evita digitar senha toda vez que você faz push ou pull. No terminal, rode:
ssh-keygen -t ed25519 -C "[email protected]"
Pressione Enter para aceitar o local padrão (~/.ssh/id_ed25519). Quando pedir uma passphrase, você pode deixar vazia (menos seguro) ou criar uma (mais seguro). Depois, exiba a chave pública:
cat ~/.ssh/id_ed25519.pub
Copie o conteúdo (começa com ssh-ed25519 e termina com seu e-mail). Vá no GitHub, clique na sua foto > Settings > SSH and GPG keys > New SSH key. Cole a chave e salve.
Dica: Teste a conexão com ssh -T [email protected]. Se aparecer "Hi seu-usuario! You've successfully authenticated", pronto.
Erro comum: Copiar a chave privada (id_ed25519) em vez da pública (id_ed25519.pub). A chave privada nunca deve ser compartilhada.
Passo 5: Criar e enviar o primeiro repositório
No GitHub, clique no botão "+" > New repository. Dê um nome (ex: meu-primeiro-repo), deixe público e não marque "Initialize this repository with a README", você vai criar o README local.
No terminal, crie uma pasta e inicialize:
mkdir meu-primeiro-repo cd meu-primeiro-repo git init echo "# Meu primeiro repositório" > README.md git add README.md git commit -m "Primeiro commit" git branch -M main git remote add origin [email protected]:seu-usuario/meu-primeiro-repo.git git push -u origin main
Dica: O -u do último comando define o branch main como padrão. Nos próximos pushes, basta git push.
Erro comum: Usar master em vez de main. Desde 2020, o GitHub usa main como branch padrão. Se der erro, verifique o nome do branch com git branch.
Checklist: o que você fez até aqui
- [ ] Git instalado e funcionando
- [ ] Conta no GitHub criada e e-mail confirmado
- [ ] Nome de usuário e e-mail configurados no Git
- [ ] Chave SSH gerada e adicionada ao GitHub
- [ ] Primeiro repositório criado e enviado com sucesso
Próximo passo prático: clone um repositório existente com git clone [email protected]:usuario/repositorio.git e comece a contribuir.
FAQ
Como dar Git config?
Use git config seguido da opção. Exemplos: git config --global user.name "Seu Nome" para configurar nome global, ou git config user.email para ver o e-mail atual. O comando git config --list exibe todas as configurações.
Como configurar a conta do Git?
Configure nome e e-mail com git config --global user.name e git config --global user.email. Depois, gere uma chave SSH com ssh-keygen e adicione ao GitHub em Settings > SSH and GPG keys. Teste com ssh -T [email protected].
Como usar o Git e o GitHub?
Git gerencia versões localmente (commits, branches). GitHub hospeda repositórios remotos. O fluxo básico: git add (prepara), git commit (salva local), git push (envia ao GitHub), git pull (traz atualizações).
Como ver as configs do Git?
git config --list mostra todas as configurações ativas. Para ver apenas uma específica, use git config user.name ou git config --global user.email. O arquivo de configuração global fica em ~/.gitconfig.