Quem nunca salvou um arquivo com o nome `trabalho_final_v2_agora_vai.zip` que atire a primeira pedra. Em algum momento da vida, todo mundo já tentou criar um sistema caseiro de versões copiando pastas, colando em pendrives ou mandando e-mails para si mesmo com anexos desesperados. Se você está dando os primeiros passos na programação, precisa abandonar esse hábito hoje. Este guia de git e github para iniciantes no desenvolvimento de software existe para tirar o peso desse medo e colocar ordem na sua rotina de estudos e trabalho.
Aprender a programar envolve lidar com lógica, sintaxe e dezenas de bibliotecas novas. Quando colocam uma tela preta cheia de comandos no meio desse caminho, o cérebro trava. Parece que você precisa memorizar dezenas de termos em inglês apenas para não apagar o projeto que levou três semanas para construir. A boa notícia é que você só precisa entender a mecânica básica para nunca mais perder uma única linha de código.
Qual é a diferença real entre Git e GitHub?
Essa é a confusão clássica de quem chega agora na área. Muita gente acha que Git e GitHub são a mesma coisa ou que um não funciona sem o outro. A analogia mais simples para separar os dois conceitos é pensar em texto e internet: o Git é o editor de texto instalado na sua máquina, enquanto o GitHub é a rede onde você compartilha esse texto com o público.
O que o Git faz dentro da sua máquina
O Git é um sistema de controle de versão distribuído, criado por Linus Torvalds em 2005 para gerenciar o desenvolvimento do kernel do Linux. Ele roda localmente, direto no seu sistema operacional, sem precisar de internet. O papel dele é registrar a linha do tempo do seu projeto.
Toda vez que você avisa ao Git que terminou uma etapa importante, ele tira uma espécie de fotografia de todos os arquivos. Se no dia seguinte uma alteração quebrar o sistema inteiro, o Git permite voltar no tempo e restaurar o código para o momento exato em que tudo funcionava perfeitamente.
O papel do GitHub na nuvem e no mercado de trabalho
O GitHub, por outro lado, é uma plataforma online que hospeda repositórios Git na nuvem. Ele pertence à Microsoft e funciona como um ponto de encontro para programadores do mundo inteiro. É lá que você guarda cópias de segurança do seu trabalho e compartilha projetos com outras pessoas.
Além do backup, o GitHub virou o portfólio padrão da indústria de tecnologia. Recrutadores e líderes técnicos olham o seu perfil para avaliar a frequência dos seus estudos, a clareza da sua documentação e a forma como você organiza suas ideias. Ter familiaridade com a plataforma não é um diferencial estético, mas um requisito para trabalhar em equipe.
Como instalar e configurar o Git no seu computador pela primeira vez?
Antes de digitar qualquer comando sofisticado, o Git precisa saber quem é você. Essa etapa é fundamental porque todo registro de alteração carrega a assinatura de quem escreveu o código. Sem essa identificação, o trabalho em grupo vira uma bagunça de autorias anônimas.
No Windows, você baixa o instalador oficial diretamente no site do Git (git-scm.com) e segue o assistente de instalação padrão. No macOS, o próprio sistema sugere a instalação das ferramentas de linha de comando na primeira vez em que você digita `git` no Terminal. Se você usa Linux, uma simples linha com o gerenciador de pacotes da sua distribuição resolve tudo em dez segundos.
Com o programa instalado, abra o seu terminal de preferência e execute apenas duas linhas para configurar seu nome e seu endereço de e-mail:
git config --global user.name "Seu Nome Completo"
git config --global user.email "seuemail@exemplo.com"
Use o mesmo e-mail que você pretende cadastrar na sua conta do GitHub. Essa correspondência garante que os envios feitos do seu computador apareçam vinculados à sua foto e ao seu histórico na plataforma web.
Primeiros passos práticos: os comandos que você vai usar todo santo dia
O vocabulário do Git assusta no começo, mas oitenta por cento do trabalho diário se resume a menos de dez comandos. Não tente decorar o manual inteiro com centenas de parâmetros obscuros. O segredo está em entender a sequência lógica entre o arquivo que você edita no seu editor de código e o registro definitivo daquela mudança.
O ciclo de vida do arquivo: da modificação ao commit
Imagine que você está montando uma caixa de encomendas para enviar pelo correio. Você compra itens em lojas diferentes (modifica arquivos no VS Code), coloca os itens selecionados dentro da caixa aberta (área de preparação ou staging area) e, por fim, fecha a caixa com fita adesiva e cola uma etiqueta explicando o conteúdo (faz o commit).
Na prática, a rotina segue estes passos fundamentais:
* `git init`: transforma uma pasta comum do seu computador em um repositório rastreado pelo Git. Você só roda isso uma vez por projeto.
* `git status`: funciona como um raio-x. Ele mostra quais arquivos foram criados, alterados ou excluídos desde a última fotografia. Use sem moderação.
* `git add .`: coloca todas as alterações recentes na área de preparação, prontas para serem empacotadas.
* `git commit -m "Mensagem explicativa"`: lacra o pacote e grava a fotografia na linha do tempo. A mensagem deve ser direta, dizendo exatamente o que foi feito ali.
* `git log`: exibe a lista histórica de todos os commits realizados no projeto, com data, autor e código identificador único.
O hábito de criar mensagens de commit claras salva vidas. Em vez de escrever frases genéricas como "ajustes" ou "corrigindo bugs", prefira descrições objetivas como "adiciona validação de e-mail no formulário de cadastro". Meses depois, quando precisar encontrar onde uma regra de negócio mudou, seu eu do futuro vai agradecer.
Como conectar seu repositório local ao GitHub sem passar raiva
Criar o código no computador é apenas metade do caminho. A mágica acontece quando você sobe esse histórico para a internet, permitindo que colegas revisem seu trabalho ou que você continue programando de outra máquina.
Primeiro, acesse sua conta no GitHub e clique no botão verde para criar um novo repositório (New Repository). Dê um nome simples, sem espaços ou caracteres especiais, e evite marcar as opções de inicialização com README se você já tiver arquivos criados na sua máquina. A própria interface do GitHub vai exibir uma tela com as instruções exatas de conexão.
No terminal da pasta do seu projeto, você precisa apenas associar o endereço remoto e enviar o conteúdo:
git remote add origin https://github.com/seu-usuario/nome-do-repositorio.git
git branch -M main
git push -u origin main
O comando `git push` envia os pacotes fechados do seu computador para o servidor do GitHub. A partir da segunda vez que você for atualizar o repositório remoto, basta rodar um curto `git push` no terminal. Se outra pessoa fez alterações no projeto enquanto você estava fora, você usa o caminho inverso: o comando `git pull` baixa as novidades da nuvem e sincroniza sua pasta local em segundos.
O que são branches e por que você nunca deve codar direto na main?
Quando você inicia um repositório, o Git cria automaticamente uma linha do tempo principal, hoje chamada universalmente de `main`. Essa linha representa a versão estável do seu software, aquela que teoricamente está pronta para os usuários finais utilizarem sem falhas graves.
Agora imagine que você quer testar uma funcionalidade arriscada, como um sistema novo de pagamentos. Se você alterar os arquivos direto na `main` e o código quebrar pela metade, o projeto inteiro fica inutilizável até você consertar o estrago. É exatamente aqui que entram as ramificações, conhecidas como branches.
Uma branch é uma cópia paralela da linha do tempo. Você cria uma ramificação com o comando `git checkout -b nova-funcionalidade`, faz todas as loucuras que quiser, testa exaustivamente e, se der errado, simplesmente deleta a branch sem encostar no código principal. Se tudo der certo, você junta essa linha paralela de volta à `main` por meio de uma operação chamada merge.
Nas empresas de tecnologia, o fluxo padrão proíbe qualquer pessoa de enviar commits diretos para a `main`. Todo mundo trabalha em branches isoladas e abre um Pull Request (PR) no GitHub. O Pull Request é um pedido formal para integrar seu código: outros programadores leem suas linhas, comentam melhorias, aprovam a mudança e só então a integração acontece.
Guia de sobrevivência do Git e GitHub: como desfazer erros comuns
O medo de estragar o projeto é a principal barreira psicológica de quem começa. A tela fica vermelha com um aviso em inglês e a primeira reação de muitos estudantes é apagar a pasta inteira e começar do zero. Quase tudo no Git tem volta, desde que você não entre em pânico.
Se você alterou um arquivo por engano e ainda não adicionou a mudança na fila do commit, o comando `git restore nome-do-arquivo.js` descarta as alterações e devolve o arquivo ao estado exato do último commit. Se você já rodou o `git add`, mas desistiu de incluir aquele arquivo no pacote, basta rodar `git restore --staged nome-do-arquivo.js`.
Outro terror comum entre iniciantes é o temido Merge Conflict. Ele acontece quando duas pessoas (ou duas branches suas) alteram exatamente a mesma linha do mesmo arquivo de formas diferentes. O Git não tem como adivinhar qual das duas versões está certa e interrompe a mesclagem.
Em vez de se desesperar, abra o arquivo no editor. O Git vai destacar o trecho com marcadores visuais (`<<<<<<<`, `=======`, `>>>>>>>`). Sua única tarefa é apagar as marcações, escolher o código correto manualmente, salvar o arquivo e fazer um novo commit. Conflitos fazem parte da rotina de qualquer equipe e resolvem-se com leitura calma, não com magia.
Como transformar seu perfil no GitHub em uma vitrine profissional
Muitos novatos cometem o erro de tratar o GitHub como um mero depósito de arquivos zipados desorganizados. Ter vinte repositórios sem descrição, chamados `teste1`, `aula3` ou `projeto-angular`, transmite desleixo para quem visita seu perfil em busca de novos talentos.
Para se destacar, cuide do arquivo `README.md` de cada projeto relevante. O README é a porta de entrada: ele deve explicar o que o projeto faz, quais tecnologias foram utilizadas, como rodar a aplicação no computador e, idealmente, trazer imagens ou links de demonstração funcionando online. Um projeto pequeno com uma documentação impecável chama muito mais atenção do que um sistema complexo que ninguém consegue entender como funciona.
Mantenha também uma consistência nos seus estudos. O famoso gráfico de quadradinhos verdes do GitHub não precisa estar preenchido todos os dias, mas ele mostra se você programa com regularidade ou se estuda apenas uma vez a cada três meses. Essa constância visual conta histórias reais sobre o seu comprometimento com o aprendizado.
A intimidade com o terminal vem com a repetição. Nos primeiros dias, mantenha uma colinha com os comandos básicos aberta ao lado do teclado. Com algumas semanas de prática, seus dedos vão digitar a sequência de status, add, commit e push de forma automática, e você vai se concentrar apenas naquilo que realmente importa: escrever um software que resolve problemas de verdade.
Perguntas frequentes sobre Git e GitHub
Preciso pagar para usar o GitHub em projetos pessoais?
Não. O GitHub oferece contas gratuitas com repositórios públicos e privados ilimitados para qualquer usuário. Os planos pagos são voltados para grandes empresas que necessitam de controles avançados de segurança, suporte corporativo e horas adicionais de automação em servidores na nuvem.
É obrigatório usar a linha de comando ou posso usar interface gráfica?
Não é obrigatório, mas é altamente recomendado para quem está aprendendo. Programas visuais como o GitHub Desktop e extensões do VS Code facilitam tarefas diárias, mas mascaram o funcionamento real do Git. Entender o terminal dá a você a base necessária para resolver problemas complexos em qualquer ambiente de trabalho.
O que acontece se duas pessoas mexerem na mesma linha de código?
O Git acusa um conflito de integração (merge conflict). Ele pausa o processo e insere marcadores no próprio arquivo mostrando o código da primeira pessoa e o da segunda. O programador precisa revisar as duas versões, decidir qual delas fica e concluir a mesclagem com um novo commit.