Minha Jornada com Git e GitHub: Erros, Desafios e Aprendizados

Se você está começando com Git e GitHub, saiba que não está sozinho! Eu também passei por vários desafios e cometi muitos erros antes de entender melhor essas ferramentas essenciais para o desenvolvimento. Neste artigo, vou compartilhar minha jornada, os obstáculos que enfrentei e como os superei. Espero que isso ajude você a evitar os mesmos tropeços!

Primeiros Passos com Git e GitHub

Quando comecei a estudar Git e GitHub, achei que seria simples. Afinal, são apenas comandos, certo? Errado! 😅

Aqui estão alguns desafios que enfrentei:

1. Configuração Inicial

Meu primeiro erro foi não configurar corretamente o Git no meu sistema. Eu tentava fazer commits e nada parecia funcionar.

Solução:

# Configurar nome e e-mail globais
 git config --global user.name "Seu Nome"
 git config --global user.email "seuemail@example.com"

Isso garantiu que meus commits tivessem uma identidade correta.

2. Clonando e Inicializando Repositórios

Outro erro foi me confundir entre git clone e git init. Acabei criando repositórios desnecessários ou tentando clonar de forma errada.

Dica:

• Use git init apenas quando quiser iniciar um repositório do zero.
• Use git clone URL quando quiser copiar um repositório já existente do GitHub.

3. Branches e Merge

Quando tentei trabalhar com branches pela primeira vez, acabei criando conflitos que não sabia resolver.

Solução:

• Sempre verificar em qual branch estou com git branch
• Criar novas branches com git checkout -b nome-da-branch
• Fazer merges conscientes e resolver conflitos com calma, utilizando git status e git diff.

4. Autenticação e Token de Acesso

Quando o GitHub mudou para autenticação por token, passei um bom tempo tentando fazer push sem sucesso, pois usava minha senha direto no terminal.

Solução:

• Criar um Personal Access Token (PAT) em github.com/settings/tokens e usá-lo no lugar da senha ao clonar ou fazer push.

5. Commits e Mensagens

Cometi o erro clássico de fazer commits sem mensagens descritivas. Depois de um tempo, não fazia ideia do que cada commit representava.

Boa Prática:

git commit -m "feat: adiciona funcionalidade X"

Use mensagens curtas e explicativas seguindo um padrão como:

• feat: (nova funcionalidade)
• fix: (correção de bug)
• docs: (alterações na documentação)

6. Erro no Pull Request

Um erro que me confundiu bastante foi ao tentar criar um Pull Request (PR) para um repositório que havia feito fork. Em vez de criar o PR na nova branch do fork, eu tentava enviá-lo diretamente para a main, o que causava conflitos e bloqueios.

Solução:

• Criar uma nova branch antes de fazer alterações: git checkout -b minha-nova-branch
• Enviar as mudanças para essa branch: git push origin minha-nova-branch
• No GitHub, ao criar o Pull Request, garantir que estou enviando da minha branch no fork para a branch correta do repositório original.

Lições Aprendidas e Dicas Finais

• Pratique muito: Quanto mais você usa o Git, mais natural ele se torna.
• Não tenha medo de errar: Cometer erros faz parte do aprendizado. O importante é entender como corrigir.
• Leia a documentação: O site oficial do Git (git-scm.com) tem tudo o que você precisa saber.
• Use plataformas como a DIO: Elas oferecem cursos e desafios práticos que ajudam a reforçar o conhecimento.

Conclusão

Aprender Git e GitHub pode ser desafiador no início, mas não desista! Espero que este artigo tenha ajudado a esclarecer alguns dos problemas comuns que enfrentei. Se você também passou por dificuldades, compartilhe nos comentários sua experiência!