Git e GitHub

Aprenda a instalar, configurar e utilizar o Git e o GitHub para controlar versões, organizar projetos e compartilhar seu código de maneira profissional.


🔎 Ctrl + K

📘 Bem-vindo ao Manual Digital

Git e GitHub são ferramentas muito utilizadas no desenvolvimento de sistemas. Elas ajudam programadores a controlar alterações, organizar versões, recuperar arquivos e trabalhar em equipe. Neste manual você aprenderá desde os conceitos básicos até a criação de um projeto versionado e seu envio para o GitHub.

💡 Antes de começar

Não tente decorar todos os comandos de uma vez. Primeiro entenda o que cada etapa representa.

Depois pratique os comandos em um projeto simples.

🎯 O objetivo

Ao terminar este manual, você deverá conseguir criar um repositório, registrar alterações, criar commits e enviar seu projeto para o GitHub.

01. O que é Git?

Definição

Git é um sistema de controle de versão distribuído.

Ele permite registrar alterações realizadas nos arquivos de um projeto ao longo do tempo.

📖 Para que serve?

💻 Exemplo

Imagine que você criou hoje:

index.html

Amanhã você alterou o arquivo.

Depois percebeu que a alteração causou um problema.

Com o Git, o projeto possui um histórico que permite acompanhar as alterações realizadas.

💡 Pense assim

Git funciona como um histórico organizado do seu projeto.

02. O que é GitHub?

Definição

GitHub é uma plataforma utilizada para hospedar e colaborar em projetos que utilizam Git.

Ele permite armazenar repositórios remotamente e facilitar o trabalho colaborativo entre desenvolvedores.

🌐 Git x GitHub

Git GitHub
Sistema de controle de versão Plataforma de hospedagem e colaboração
Pode funcionar localmente Funciona como serviço online
Controla versões Hospeda e compartilha repositórios
Utiliza comandos Possui interface web e recursos colaborativos
🎯 Resumindo

Git é a ferramenta de versionamento.

GitHub é uma plataforma que pode hospedar os repositórios Git e facilitar o trabalho colaborativo.

03. Instalando o Git

Definição

Para utilizar os comandos Git no computador, primeiro é necessário instalar o Git.

🌐 Site oficial

Site:

https://git-scm.com/

📝 Passo a passo

  1. Acesse o site oficial do Git.
  2. Escolha a versão correspondente ao seu sistema operacional.
  3. Faça o download.
  4. Execute o instalador.
  5. Avance pelas etapas da instalação.
  6. Mantenha as configurações padrão se não souber qual opção escolher.
  7. Conclua a instalação.
⚠️ Atenção

Git e GitHub não são a mesma coisa.

Instalar o Git no computador não significa que você criou uma conta no GitHub.

04. Verificando se o Git foi Instalado

Objetivo

Depois da instalação, vamos verificar se o computador reconhece o comando Git.

💻 Abra o terminal

No terminal, digite:

git --version

Depois pressione:

Enter
Resultado esperado

O terminal deverá apresentar informações indicando a versão instalada do Git.

⚠️ Se aparecer que o comando não foi encontrado

Verifique se o Git foi instalado corretamente e se o terminal foi reiniciado depois da instalação.

05. Criando uma Conta no GitHub

Definição

Para utilizar os recursos online do GitHub, é necessário possuir uma conta na plataforma.

📝 Passo a passo

  1. Acesse o site do GitHub.
  2. Escolha a opção para criar uma conta.
  3. Informe os dados solicitados.
  4. Confirme seu endereço de e-mail quando solicitado.
  5. Faça login.
💡 Dica

Utilize um e-mail ao qual você tenha acesso.

O e-mail também será importante para configurar a identidade dos commits realizados pelo Git.

06. Configurando seu Nome e E-mail no Git

Definição

O Git registra quem realizou os commits.

Por isso, é necessário configurar um nome e um endereço de e-mail.

👤 Configurando o nome

git config --global user.name "Seu Nome"

📧 Configurando o e-mail

git config --global user.email "seuemail@exemplo.com"
⚠️ Atenção

Substitua os exemplos pelos seus próprios dados.

🔎 Conferindo a configuração

git config --global user.name


git config --global user.email
📖 Por que isso existe?

Quando você realiza um commit, o Git precisa registrar a identidade associada à alteração.

07. O que é um Repositório?

Definição

Um repositório é um projeto que possui controle de versão utilizando Git.

📦 Repositório local

É o repositório armazenado no seu computador.

☁️ Repositório remoto

É o repositório armazenado em um serviço remoto, como o GitHub.

🎯 Visualize desta forma

COMPUTADOR
│
│ Git
▼
Repositório local
│
│ push
▼
GITHUB
│
▼
Repositório remoto 

08. Criando um Repositório com Git Init

Definição

O comando git init transforma uma pasta em um repositório Git.

📝 Passo a passo

  1. Abra a pasta do projeto no VS Code.
  2. Abra o terminal.
  3. Confira se o terminal está localizado dentro da pasta correta.
  4. Execute:
git init
📖 O que aconteceu?

O Git criou uma estrutura interna para começar a controlar as versões daquele projeto.

⚠️ Atenção

Execute git init na pasta correta do projeto.

09. Verificando o Status do Projeto

Definição

O comando git status mostra a situação atual dos arquivos do repositório.

git status

🔎 O que podemos descobrir?

💡 Comando muito importante

Antes de realizar um commit, acostume-se a executar:

git status

Ele ajuda você a entender o que está acontecendo no projeto.

10. Preparando Arquivos com Git Add

Definição

O comando git add coloca alterações na área de preparação do Git, conhecida como staging area.

📄 Adicionar um arquivo específico

git add index.html

📦 Adicionar todos os arquivos

git add .
📖 Pense em três etapas

Arquivo alterado
↓
git add
↓
Área de preparação
↓
git commit
↓
Histórico 
⚠️ Atenção

O comando git add . adiciona as alterações encontradas na pasta atual ao staging.

Antes de utilizá-lo, confira o projeto e o resultado do git status.

11. Criando um Commit

Definição

Commit é um registro de uma alteração realizada no histórico do projeto.

💻 Comando

git commit -m "Mensagem do commit"

📝 Exemplo

git commit -m "Criação da página inicial"
📖 O que significa a mensagem?

A mensagem deve explicar de maneira curta o que foi realizado naquela versão.

✅ Bons exemplos

git commit -m "Criação do formulário de cadastro"

git commit -m "Correção do menu principal"

git commit -m "Adição da página de contato"
⚠️ Evite mensagens vagas
git commit -m "alterações"

git commit -m "teste"

git commit -m "coisas"

12. Consultando o Histórico com Git Log

Definição

O comando git log apresenta o histórico de commits do repositório.

git log
📖 O que você encontrará?
  • Identificação do commit.
  • Autor.
  • Data.
  • Mensagem utilizada.
💡 Conceito importante

Cada commit representa um ponto registrado na história do projeto.

13. Criando um Repositório no GitHub

Definição

Agora vamos criar no GitHub o repositório remoto que receberá o projeto.

📝 Passo a passo

  1. Entre na sua conta do GitHub.
  2. Procure a opção para criar um novo repositório.
  3. Informe o nome do repositório.
  4. Escolha se ele será público ou privado.
  5. Crie o repositório.
⚠️ Atenção para iniciantes

Se você já possui um projeto local e pretende conectá-lo ao novo repositório, tome cuidado para não criar arquivos iniciais desnecessários que possam gerar conflitos durante a primeira sincronização.

14. Conectando o Projeto Local ao GitHub

Definição

O comando git remote permite configurar a conexão entre o repositório local e um repositório remoto.

💻 Comando

git remote add origin URL_DO_REPOSITORIO

📌 O que é origin?

origin é um nome convencional utilizado para identificar o repositório remoto principal.

🔎 Conferindo

git remote -v
💡 Pense assim

Projeto no computador
│
│ origin
▼
Projeto no GitHub 

15. Entendendo Branch

Definição

Branch é uma ramificação do histórico do projeto.

Ela permite trabalhar em uma linha de desenvolvimento separada.

🌳 Exemplo visual


main
│
├── desenvolvimento
│
└── nova-funcionalidade 

🔎 Descobrindo a branch atual

git branch
📖 Por que utilizar branches?

Em projetos maiores, uma equipe pode desenvolver novas funcionalidades sem alterar diretamente a versão principal.

💡 Para começar

Primeiro domine os conceitos de repositório, commit, push e pull. Depois aprofunde seus conhecimentos em branches.

16. Enviando o Projeto para o GitHub — Push

Definição

O comando git push envia commits do repositório local para o repositório remoto.

💻 Comando comum

git push -u origin main
📖 Entendendo o comando

git push = enviar alterações.

origin = repositório remoto principal.

main = branch utilizada como destino.

🎯 Fluxo

COMPUTADOR
│
│ git push
▼
GITHUB 

17. Atualizando o Projeto — Pull

Definição

O comando git pull busca alterações do repositório remoto e integra essas alterações ao projeto local.

git pull

🔄 Push x Pull

Comando Direção Ideia
git push Local → Remoto Enviar
git pull Remoto → Local Atualizar
💡 Memorize

PUSH
Local → GitHub

PULL
GitHub → Local 

18. Clonando um Projeto — Git Clone

Definição

O comando git clone cria uma cópia local de um repositório remoto.

💻 Comando

git clone URL_DO_REPOSITORIO

📝 Quando utilizar?

🎯 Fluxo

GITHUB
│
│ git clone
▼
COMPUTADOR 

19. O Fluxo Básico de Trabalho com Git

Definição

O fluxo representa a sequência normalmente utilizada para registrar e enviar alterações de um projeto.

🔄 Fluxo básico


1. Alterar arquivos
   ↓
2. git status
   ↓
3. git add .
   ↓
4. git commit -m "Mensagem"
   ↓
5. git push 
📖 Entendendo cada etapa

1. Alterar arquivos: você desenvolve o projeto.

2. git status: verifica o que mudou.

3. git add: prepara as alterações.

4. git commit: registra uma versão no histórico.

5. git push: envia os commits para o GitHub.

20. O que é README.md?

Definição

O arquivo README.md é utilizado para apresentar informações sobre o projeto.

📄 Exemplo de conteúdo

# Meu Projeto
   
Projeto desenvolvido durante as aulas.

## Tecnologias

* HTML
* CSS
* JavaScript

## Autor

Nome do aluno
💡 Boa prática

Projetos publicados no GitHub devem possuir uma documentação mínima para que outras pessoas consigam entender sua finalidade.

21. O que é .gitignore?

Definição

O arquivo .gitignore informa ao Git quais arquivos ou pastas não devem ser incluídos no controle de versão.

📄 Exemplo

node_modules/
.env
*.log
⚠️ Atenção

Arquivos que contêm senhas, chaves ou informações privadas não devem ser publicados acidentalmente em um repositório.

Nunca coloque senhas diretamente no código de um projeto destinado a ser compartilhado.

22. Git, GitHub, Commit, Push, Pull e Clone

Termo Significado
Git Sistema de controle de versão.
GitHub Plataforma para hospedar e colaborar em repositórios.
Repository Projeto controlado pelo Git.
git status Mostra o estado atual do projeto.
git add Prepara alterações.
git commit Registra alterações no histórico.
git push Envia commits para o remoto.
git pull Atualiza o projeto local com alterações remotas.
git clone Copia um repositório remoto para o computador.
🎯 Se você lembrar de apenas uma sequência...

git status
git add .
git commit -m "Mensagem"
git push 

23. Erros Comuns de Iniciantes

❌ "git não é reconhecido"

Normalmente indica que o Git não está instalado corretamente ou não está disponível no PATH do sistema.

❌ Fiz alterações mas o Git não mostra nada

Confira se você está dentro da pasta correta do projeto.

Execute:

git status

❌ Fiz commit mas não apareceu no GitHub

O commit é criado localmente.

Para enviar o commit ao GitHub, normalmente será necessário utilizar:

git push

❌ Fiz push e deu erro

Leia a mensagem apresentada pelo Git.

Ela normalmente fornece informações sobre o problema.

Não apague o projeto ou execute comandos aleatórios sem entender o que está acontecendo.

🏆 Desafio Final — Publique seu Primeiro Projeto

🎯 Objetivo

Agora você deverá realizar sozinho o fluxo básico de Git e GitHub.

📋 Missão

  1. Instale o Git.
  2. Verifique a instalação com:
git --version
  1. Configure seu nome.
  2. Configure seu e-mail.
  3. Crie uma pasta chamada: projeto-git
  4. Abra a pasta no VS Code.
  5. Crie um arquivo: index.html
  6. Crie um arquivo: README.md
  7. Inicialize o Git:
git init
  1. Verifique o status:
git status
  1. Adicione os arquivos:
git add .
  1. Crie o primeiro commit:
git commit -m "Criação do projeto"
  1. Crie um repositório no GitHub.
  2. Conecte o repositório local ao remoto.
  3. Envie o projeto utilizando:
git push
🎯 Resultado esperado

Ao final do exercício, você deverá conseguir visualizar seu projeto no GitHub.

🔄 Segunda etapa do desafio

  1. Altere o arquivo index.html.
  2. Salve a alteração.
  3. Execute:
git status
  1. Prepare a alteração:
git add .
  1. Crie um novo commit:
git commit -m "Atualização da página inicial"
  1. Envie para o GitHub:
git push
🧠 O que você acabou de fazer?

Você criou uma nova versão do projeto e enviou essa alteração para o repositório remoto.

Esse é um dos principais fundamentos do controle de versão.

✅ Checklist — Eu Aprendi Git e GitHub?

🎯 Marque cada item depois de praticar

🚀 Resumo dos Principais Comandos

Comando Função
git --version Verificar a versão do Git
git init Criar repositório Git
git status Verificar alterações
git add . Preparar alterações
git commit -m "mensagem" Registrar alteração
git log Visualizar histórico
git remote -v Visualizar repositórios remotos
git push Enviar alterações
git pull Atualizar projeto
git clone Clonar repositório
git branch Visualizar branches
🧠 A sequência que você deve praticar

git status
git add .
git commit -m "Mensagem"
git push 
🎓 Próximo nível

Depois de dominar esse fluxo, você estará preparado para estudar branches, merge, pull requests, resolução de conflitos, GitHub Pages, colaboração em equipe e fluxos profissionais de desenvolvimento.