🔄 #29 - Git + GitHub na Prática: Como Versionar, Colaborar e Nunca Mais Perder um Projeto
- #GitHub
- #Git
🌌 Projeto CodeVerse Python - #29/2025 (3/4)
👋 Fala, galera dev! 🚀
Esse é o terceiro de quatro artigos especiais sobre GitHub aqui dentro do projeto CodeVersePython2025. Sei que o foco central do projeto é a reconstrução do nosso querido J.A.R.V.I.S., mas antes de ir para a parte mais "futurista", eu achei essencial parar um pouco e trazer esse conteúdo aqui sobre Git e GitHub.
Mas Por quê falar de GitHub? Porque o GitHub será onde vamos hospedar todas as versões do nosso projeto, divulgar atualizações para a comunidade e organizar o crescimento do Jarvis ao longo do tempo. E para isso, entender controle de versões e colaboração é essencial, tanto para quem está começando, quanto pra quem já está no mercado.
🧠 O que é Controle de Versões (e por que isso existe)?
Vamos lá... Imagina que você está escrevendo um TCC no Word, e a cada vez que edita, salva uma cópia nova: TCC-final-V2-revisado-definitivo-AGORA-VAI.docx. Ficou familiar? 😅
O controle de versões surgiu justamente pra resolver esse tipo de bagunça, mas no mundo da programação. No início dos anos 2000, as empresas e comunidades de software precisavam de uma forma organizada de:
- Saber quem alterou o quê
- Voltar atrás quando algo dava errado
- Trabalhar em grupo, sem sobrescrever o trabalho do outro
Foi aí que nasceu o Git, criado por Linus Torvalds (o mesmo criador do Linux), como uma forma de fazer versionamento de código rápido, seguro e distribuído. E o GitHub? Ele surgiu depois, como uma plataforma visual que usa o Git por baixo dos panos, mas facilita a colaboração e o compartilhamento de projetos.
🧰 Pra que serve o controle de versões na prática?
- Salvar o histórico completo do projeto
- Comparar mudanças entre versões
- Voltar a uma versão anterior se algo quebrar
- Trabalhar em time sem conflito
- Testar ideias em ramificações separadas (branches)
É como se você tivesse um botão mágico de “desfazer” ilimitado, e ainda pudesse criar cópias paralelas do seu projeto pra testar sem estragar o original. Ou novamente levando ao universo Marvel: é como se você fosse o Dr. Estranho com o poder de criar vários multiveros onde voce pode transposrtar seu código e testar suas alterações de forma segura.
💻 Como usar Git e GitHub na prática - Vamos criar um novo respositório no terminal e site:
✅ Pelo terminal (linha de comando ou GitBash)
# 1. Crie um repositório local:🛠️ Quando você digita git init dentro de uma pasta, está dizendo ao Git para começar a rastrear essa pasta como um repositório. É como ativar o modo “salvar histórico” no seu projeto local.
git init
# 2. Adicione os arquivos: 📦 Esse comando prepara os arquivos para serem salvos. O ponto (.) significa “todos os arquivos da pasta”. É como selecionar tudo o que você quer guardar numa caixa antes de fechar.
git add .
# 3. Faça um commit (salvamento com mensagem): 💾 Aqui você fecha a caixa e coloca uma etiqueta dizendo o que mudou. Essa “mensagem” ajuda a lembrar o que você fez naquele momento.
git commit -m "Primeiro commit"
# 4. Conecte ao GitHub: 🌐 Esse comando cria uma ponte entre seu projeto local e o repositório no GitHub. O nome origin é como um apelido pra essa ponte.
git remote add origin https://github.com/seu-usuario/seu-repo.git
# 5. Envie para o repositório online: ☁️ Aqui você envia sua pasta (e o histórico) para o GitHub. É como subir seu projeto para a nuvem, onde outras pessoas (ou você mesmo de outro lugar) poderão acessar.
O -u configura a conexão pra facilitar os próximos envios.
git push -u origin main
✅ Pelo site do GitHub
- Vá em github.com
- Clique no + no canto superior direito → New Repository
- Dê um nome, descrição, marque como public e clique em Create
- Dentro do repositório, clique em Upload files para arrastar seus arquivos
- No final, clique em Commit changes
Ambas as formas funcionam bem — o terminal dá mais controle, mas o site é ótimo pra quem está começando.
🤝 Parte 2 – Como colaborar em projetos de outras pessoas
Agora que você entendeu como versionar seu próprio código, bora falar de colaboração , que é a alma do GitHub.
🚪 Fork: clonando um projeto de outra pessoa:
Imagina que você viu um projeto legal e quer experimentar ou melhorar sem afetar o original. Você faz um fork, ou seja, uma cópia completa do repositório pra sua conta. 📌Basta clicar no botão Fork no topo da página do projeto no GitHub, conforme imagem abaixo:
📥 Como clonar um repositório de terceiro no seu PC
Se você quiser estudar o código de outra pessoa, testar um projeto open source ou até contribuir com melhorias, pode clonar o repositório para a sua máquina. Isso cria uma cópia completa do projeto, com todo o histórico de alterações, exatamente como está no GitHub.
- Acesse o repositório que você quer clonar no GitHub
- Clique no botão verde “Code”
- Copie o link HTTPS ou SSH (ex: https://github.com/usuario/repositorio.git)
# No terminal, digite o (git clone + link copiado): Esse comando vai baixar todo o conteúdo do projeto para uma pasta com o mesmo nome do repositório.
git clone https://github.com/usuario/repositorio.git
#Exemplo prático:
git clone https://github.com/Carlos-CGS/Projeto-JARVIS.git
Isso vai criar uma pasta chamada Projeto-JARVIS no seu computador, com todos os arquivos do projeto e o controle de versão ativo.
🌿 Branch: criando uma nova linha de trabalho
Criando uma nova branch via terminal:
Depois do fork, você pode criar uma branch (um ramo paralelo do projeto). É como testar uma nova receita sem mexer no prato principal.
git checkout -b minha-branch
Se desejar criar uma nova branch no site, também é bem simples:
- Acesse o repositório desejado no GitHub
- No topo da lista de arquivos, procure a caixa onde aparece algo como Branch
- Digite o nome da nova branch que deseja criar (ex: nova-feature)
- Vai aparecer a mensagem: Create branch: nova-feature from 'main'
- Clique nessa opção e... pronto! Sua nova branch foi criada, baseada na branch atual (geralmente main).
🔄 Como fazer uma Pull Request (PR) – passo a passo
Uma Pull Request (ou PR) é como se fosse um pedido educado pra dizer:
“Fiz uma melhoria no seu projeto. Você gostaria de revisar e, se achar válido, adicionar isso ao repositório principal?”
Mas antes de fazer isso, você precisa ter uma cópia do projeto na sua conta, e aí entra o fork.
✅ Etapas para fazer uma Pull Request:
- Acesse o repositório original no GitHub Exemplo: https://github.com/usuario-original/repositorio.git
- Clique no botão “Fork” no canto superior direito Isso vai criar uma cópia exata desse repositório na sua conta
- Com o fork criado, clique no botão verde "Code" e clone o projeto no seu computador:
git clone https://github.com/seu-usuario/repositorio.git cd repositorio
4. Crie uma nova branch pra sua alteração:
git checkout -b minha-sugestao
5. Faça as alterações no código, salve e envie pro seu repositório:
git add .
git commit -m "Melhoria X no projeto"
git push origin minha-sugestao
6. Agora volte ao GitHub (na sua versão do repositório). Você verá um botão amarelo com a opção:
"Compare & pull request"
7. Clique nele, escreva uma mensagem clara explicando o que você mudou e por quê. Depois, clique em "Create pull request".
💬 Issues: relatando bugs ou sugerindo melhorias
Outra forma de contribuir é abrindo issues — que são registros de problemas ou sugestões no projeto. É como dizer: “Ei, encontrei um erro aqui” ou “Que tal adicionar esse recurso?”. Você ajuda mesmo sem escrever código.
Afinal nem toda colaboração precisa ser feita com código. Às vezes, só de apontar um erro, sugerir uma melhoria ou deixar um feedback construtivo, você já está ajudando muito um projeto. E é exatamente pra isso que servem as issues no GitHub.
❌ Como desfazer um commit (sem pânico!)
Errar um commit é mais comum do que parece — e o Git tem várias formas de corrigir isso. Aqui vão as mais práticas:
💻 Pelo terminal (Bash)
# 🔄 1. Desfazer o último commit mas manter as alterações (como se fosse um “voltar”): Isso desfaz o commit, mas mantém os arquivos prontos para você corrigir e fazer um novo commit.
git reset --soft HEAD~1
# 🧹 2. Desfazer o último commit e apagar tudo que foi feito: ⚠️ Cuidado: essa opção apaga de verdade — só use se tiver certeza!
git reset --hard HEAD~1
# ✏️ 3. Corrigir a mensagem do commit (sem mudar o conteúdo): Isso reabre o último commit para você editar a mensagem.
git commit --amend
# 🔙 4. Desfazer um commit que já foi enviado (sem quebrar nada no GitHub): Esse comando cria um novo commit que anula o anterior. Mais seguro quando você já fez push.
git revert <hash-do-commit>
# Para encontrar o hash, use:
git log
🌐 Pelo site do GitHub
O GitHub não tem um botão “desfazer commit”, mas dá pra reverter um commit via Pull Request, caso esteja colaborando em equipe:
- Vá até o commit que você quer desfazer (em Commits)
- Clique nele → botão “Revert”
- O GitHub vai criar uma nova pull request com a reversão
- É só revisar e confirmar!
⚠️ Essa opção só aparece em repositórios com mais de uma branch ou colaboração ativa.
🧠 Conclusão
Se você chegou até aqui, já entendeu que o Git e o GitHub vão muito além de subir arquivos em um site para voce guardar seus códigos. Eles são, juntos, a espinha dorsal do desenvolvimento atualmente, principalmente se você quer crescer, colaborar e construir algo que evolua com o tempo, e se posicionar como Dev, pois em muitas entrevistas seu github é visitado e avaliado.
A gente pode até estar desenvolvendo o Jarvis aqui no projeto CodeVerse, mas não faria sentido seguir com ele sem saber como cuidar do código, acompanhar a evolução e divulgar com clareza. Com versionamento e colaboração, você mostra que está pronto pra trabalhar em equipe, corrigir seus próprios erros e aprender com os outros.
E o melhor: você começa de forma simples, com um git init, e aos poucos vai ganhando confiança, desbloqueando conquistas e se conectando com devs do mundo todo. É como dirigir um carro, você começa meio recioso, mas com o tempo e prática, voce se habitua com a ferramenta e ela se torna algo tão simples quanto ir ao mercado fazer compras em seu carro.
📣 Curtiu esse conteúdo?
Compartilha aqui nos comentários o seu primeiro repositório colaborativo! Se ainda não fez, que tal começar hoje?
🔁 Marque este artigo com a hashtag #CodeVersePython2025 no LinkedIn, ou envie pra aquele amigo que ainda salva projeto como “versão-final-agora-vai.zip”. rs!
Nos vemos no próximo (e último) artigo da série GitHub, onde vou te mostrar como escrever um README de respeito e escolher a melhor licença pro seu projeto.
Segue lá no LinkedIn para mais conteúdos como este: https://www.linkedin.com/in/carlos-cgs/
