Como Trabalhar com GitHub: Guia Completo para Iniciantes (Passo a Passo)

Trabalhar com GitHub é essencial para qualquer desenvolvedor que deseja organizar seu código, colaborar com outros programadores ou participar de projetos open source. Neste guia completo, você vai aprender desde a instalação do Git até os comandos mais importantes, como criar branches, fazer commits, visualizar logs, retornar a um commit anterior e muito mais.

Se você está começando agora, este conteúdo foi otimizado para facilitar sua compreensão e ranquear bem no Google. Vamos lá!

Instalar o Git no Windows, Mac e Linux

Antes de trabalhar com GitHub, você precisa instalar o Git, uma ferramenta de controle de versão local.

Passo a passo:

1. Acesse git-scm.com e baixe a versão compatível com o seu sistema operacional.
2. Siga as etapas do instalador.
3. Após a instalação, abra o terminal (Linux/macOS) ou Prompt de Comando (Windows) e digite:

   git --version

Se aparecer algo como git version 2.xx.x, a instalação foi concluída com sucesso.

Configurações Iniciais do Git

Para começar a usar Git, configure seu nome de usuário e e-mail:

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

Essas informações são vinculadas aos seus commits, ajudando a identificar quem fez cada alteração no projeto.

Criar um Projeto no GitHub

Criar um repositório no GitHub é o primeiro passo para publicar seu projeto online.

Como criar:

1. Acesse github.com.
2. Clique em “New repository”.
3. Preencha:

• Nome do repositório
• Descrição (opcional)
• Escolha entre público ou privado

1. Marque “Initialize this repository with a README” (recomendado).
2. Clique em “Create repository”.

Agora você tem um repositório criado no GitHub e pode começar a trabalhar nele.

Clonar Repositório Localmente

Para trabalhar no projeto na sua máquina, use o comando:

git clone https://github.com/seu-usuario/nome-do-repositorio.git

Isso cria uma cópia local do repositório no seu computador, permitindo que você edite arquivos e envie atualizações.

Verificar o Status do Projeto com git status

O comando git status é essencial para entender o estado atual dos seus arquivos.

git status

Ele mostra:

• Quais arquivos foram modificados
• Quais estão prontos para commit
• Quais são novos e ainda não rastreados

Use-o sempre antes de adicionar ou enviar alterações.

Adicionar Alterações com git add

Depois de modificar arquivos, adicione-os ao próximo commit:

git add .

(O ponto adiciona todos os arquivos. Você também pode substituir por um nome específico.)

Fazer Commit das Alterações

Um commit no GitHub registra suas mudanças no histórico do projeto.

git commit -m "Descrição clara das alterações"

Escreva mensagens claras e objetivas para facilitar a revisão futura.

Visualizar Histórico com git log

Para ver todos os commits realizados:

git log

Esse comando exibe:

• Hash do commit
• Autor
• Data
• Mensagem

É útil para entender a evolução do projeto e encontrar commits específicos.

Retornar a um Commit Anterior

Se precisar voltar a uma versão anterior do projeto:

git checkout hash-do-commit

Substitua hash-do-commit pelo ID mostrado no git log.

Dica: Se quiser manter o trabalho atual, crie uma nova branch antes de retornar.

Trabalhar com Branches no GitHub

Branches permitem que você crie versões separadas do projeto para testar funcionalidades sem afetar a principal.

Criar e acessar uma nova branch:

git checkout -b nome-da-branch

Listar branches:

git branch

Alternar entre branches:

git checkout nome-da-branch

Enviar Alterações para o GitHub com git push

Após o commit, envie suas alterações para o repositório remoto:

git push origin nome-da-branch

Assim, suas modificações ficam disponíveis online e podem ser revisadas por outros colaboradores.

Criar uma Pull Request no GitHub

Uma Pull Request (PR) é uma solicitação para integrar suas alterações à branch principal do projeto.

Como criar:

1. No GitHub, clique em “Compare & pull request” na página da sua branch.
2. Adicione título e descrição explicando as alterações.
3. Clique em “Create pull request”.

Os mantenedores do projeto poderão revisar, comentar e aprovar suas mudanças.

Conclusão: Comece a Trabalhar com GitHub Hoje

Trabalhar com GitHub é fundamental para qualquer pessoa envolvida com desenvolvimento de software. Desde o versionamento de código até a colaboração em equipes, o GitHub oferece ferramentas poderosas e intuitivas.

Com os comandos aprendidos neste guia — como git status, git add, git commit, git log, git checkout, branches e Pull Requests — você já pode começar a usar o GitHub com confiança.

Comece com projetos pequenos, pratique com frequência e compartilhe seus repositórios com a comunidade. O GitHub é muito mais do que uma plataforma de código: é uma rede social de desenvolvedores.