Git GitHub tutorial: guia completo passo a passo para iniciantes

Você já deve ter ouvido que Git e GitHub são indispensáveis para programar em equipe, ou mesmo para não perder o próprio trabalho. Mas entre ouvir e usar de verdade existe um abismo de comandos abstratos. Neste guia, eu vou direto ao ponto: instalar o Git, criar um repositório, fazer commits, criar branches e enviar tudo para o GitHub. Sem rodeios, só o que você precisa para sair do zero e começar a versionar seus projetos hoje.

Pré-requisitos

Antes de começar, tenha certeza de que você tem:

• Um computador com Windows, macOS ou Linux.
• Uma conta gratuita no GitHub (crie em github.com).
• Vontade de abrir o terminal, sim, você vai digitar comandos, mas são poucos e repetitivos.

Nada de conhecimento prévio em Git é exigido. Se você já editou um arquivo de texto, está pronto.

Passo 1: Instalar o Git

O primeiro passo é instalar o Git na sua máquina. Acesse o site oficial (git-scm.com) e baixe a versão para seu sistema operacional. No Windows, o instalador inclui o Git Bash, um terminal que simula comandos Unix. No macOS, você pode usar o Homebrew: brew install git. No Linux, via apt: sudo apt install git.

Dica: Durante a instalação no Windows, escolha a opção "Git from the command line and also from 3rd-party software", isso evita conflitos de PATH depois.

Erro comum: Pular a instalação do Git Bash e tentar usar o CMD padrão. Use o Git Bash, ele lida melhor com os comandos.

Passo 2: Configurar o Git com seu nome e e-mail

Depois de instalado, abra o terminal (Git Bash no Windows) e configure seu nome de usuário e e-mail. Essas informações vão aparecer em cada commit que você fizer.

git config --global user.name "Seu Nome" git config --global user.email "[email protected]"

Dica: Use o mesmo e-mail que você cadastrou no GitHub, isso associa seus commits à sua conta.

Erro comum: Esquecer de configurar. Se pular essa etapa, o Git pode bloquear seus commits ou mostrar um nome genérico.

Passo 3: Criar um repositório local

Um repositório é a pasta que o Git vai monitorar. Navegue até a pasta do seu projeto (ou crie uma nova) e inicialize o Git:

cd ~/Documentos/meu-projeto git init

Pronto. Uma subpasta .git foi criada, é ali que o Git guarda todo o histórico. Não mexa nela manualmente.

Dica: Crie um arquivo README.md dentro da pasta antes de continuar. Escreva algo como "# Meu Projeto".

Erro comum: Executar git init dentro de uma pasta que já tem um repositório Git. Verifique se já existe uma pasta .git antes.

Passo 4: Fazer o primeiro commit

Commit é um instantâneo do estado atual dos seus arquivos. Primeiro, adicione os arquivos que você quer versionar à "área de preparação" (staging area):

git add README.md

Depois, crie o commit com uma mensagem descritiva:

git commit -m "Primeiro commit: adiciona README"

Dica: Use git add . para adicionar todos os arquivos da pasta de uma vez, mas só faça isso se tiver certeza de que não há arquivos temporários ou de sistema.

Erro comum: Mensagens de commit vagas como "atualização" ou "commit". Seja específico: "Corrige bug no cálculo de imposto" é muito melhor.

Passo 5: Criar e navegar entre branches

Branches são linhas paralelas de desenvolvimento. A branch padrão se chama main (ou master em versões antigas). Crie uma nova branch para trabalhar em uma funcionalidade:

git branch minha-feature git checkout minha-feature

Ou, em um comando só:

git checkout -b minha-feature

Agora você pode alterar arquivos e fazer commits sem afetar a branch main.

Dica: Para voltar à branch principal, use git checkout main.

Erro comum: Fazer alterações na branch errada. Sempre verifique em qual branch você está com git branch (a branch atual aparece com um asterisco).

Passo 6: Conectar o repositório local ao GitHub

Agora vamos levar seu código para a nuvem. No GitHub, clique em "New repository" (ou "Novo repositório"), dê um nome (pode ser o mesmo da pasta local) e não marque nenhuma opção extra, você já tem um repositório local.

Copie a URL do repositório recém-criado. No terminal, dentro da pasta do projeto, execute:

git remote add origin https://github.com/seu-usuario/meu-projeto.git

Dica: Substitua seu-usuario e meu-projeto pelo seu nome de usuário e nome do repositório.

Erro comum: Tentar adicionar um remote que já existe. Se errar a URL, use git remote remove origin e repita.

Passo 7: Enviar (push) o código para o GitHub

Com o remote configurado, envie seus commits para o GitHub:

git push -u origin main

O parâmetro -u define que a branch local main vai acompanhar a branch remota de mesmo nome. Nas próximas vezes, basta digitar git push.

Dica: Se for a primeira vez, o Git vai pedir suas credenciais do GitHub. Prefira usar um token de acesso pessoal (em vez de senha), você gera ele em github.com/settings/tokens.

Erro comum: Push rejeitado porque o repositório remoto tem commits que você não tem localmente. Nesse caso, faça git pull origin main antes de tentar novamente.

Passo 8: Puxar (pull) atualizações do GitHub

Quando outra pessoa (ou você em outra máquina) enviar alterações, você precisa puxá-las:

git pull origin main

Isso baixa os commits novos e mescla com sua branch local.

Dica: Sempre faça git pull antes de começar a trabalhar, para evitar conflitos grandes.

Erro comum: Ignorar o pull e sobrescrever o trabalho de outra pessoa com git push --force. Só use force se tiver absoluta certeza do que está fazendo.

Fechamento: checklist do que você aprendeu

• [ ] Git instalado e configurado com nome e e-mail.
• [ ] Repositório local criado com git init.
• [ ] Primeiro commit feito com git add e git commit.
• [ ] Branch criada e navegação entre branches.
• [ ] Repositório remoto no GitHub conectado com git remote add.
• [ ] Código enviado ao GitHub com git push.
• [ ] Atualizações puxadas com git pull.

Se você marcou todos, já domina o fluxo básico de Git e GitHub. O próximo passo natural é aprender a resolver conflitos de merge e trabalhar com pull requests, mas isso fica para um próximo guia.

Perguntas frequentes (FAQ)

Qual a diferença entre Git e GitHub?

Git é o sistema de controle de versão que roda no seu computador. GitHub é uma plataforma online que hospeda repositórios Git e oferece ferramentas de colaboração, como pull requests e issues. Você pode usar Git sem GitHub, mas o GitHub sem Git não faz sentido.

Preciso decorar todos os comandos Git?

Não. Com o tempo, você memoriza os mais comuns (add, commit, push, pull). Para o resto, existe o git --help e a documentação oficial. O importante é entender o conceito de commits, branches e remotos.

O que fazer se meu push for rejeitado?

Geralmente significa que o repositório remoto tem commits que você não tem. Execute git pull origin main para baixar as alterações, resolva possíveis conflitos e tente o push novamente.

Como desfazer um commit?

Use git revert HEAD para criar um novo commit que desfaz as alterações do último commit. Isso mantém o histórico limpo. Evite git reset se você já tiver enviado o commit para o GitHub.

Posso usar Git apenas com interface gráfica?

Sim, existem clientes como GitKraken, SourceTree e o próprio GitHub Desktop. Eles facilitam a visualização do histórico e das branches. Mas conhecer os comandos básicos ajuda a entender o que a interface está fazendo.

O que é um arquivo .gitignore?

É um arquivo de texto que lista pastas e arquivos que o Git deve ignorar, como node_modules, .env e pastas de build. Crie um na raiz do projeto e adicione padrões como *.log ou build/.