📘 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.
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.
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?
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?
- Registrar alterações.
- Recuperar versões anteriores.
- Comparar modificações.
- Trabalhar em equipe.
- Criar ramificações do projeto.
- Manter um histórico do desenvolvimento.
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.
Git funciona como um histórico organizado do seu projeto.
02. O que é GitHub?
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 |
Git é a ferramenta de versionamento.
GitHub é uma plataforma que pode hospedar os repositórios Git e facilitar o trabalho colaborativo.
03. Instalando o Git
Para utilizar os comandos Git no computador, primeiro é necessário instalar o Git.
🌐 Site oficial
https://git-scm.com/
📝 Passo a passo
- Acesse o site oficial do Git.
- Escolha a versão correspondente ao seu sistema operacional.
- Faça o download.
- Execute o instalador.
- Avance pelas etapas da instalação.
- Mantenha as configurações padrão se não souber qual opção escolher.
- Conclua a instalaçã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
Depois da instalação, vamos verificar se o computador reconhece o comando Git.
💻 Abra o terminal
No terminal, digite:
git --version
Depois pressione:
Enter
O terminal deverá apresentar informações indicando a versão instalada do Git.
Verifique se o Git foi instalado corretamente e se o terminal foi reiniciado depois da instalação.
05. Criando uma Conta no GitHub
Para utilizar os recursos online do GitHub, é necessário possuir uma conta na plataforma.
📝 Passo a passo
- Acesse o site do GitHub.
- Escolha a opção para criar uma conta.
- Informe os dados solicitados.
- Confirme seu endereço de e-mail quando solicitado.
- Faça login.
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
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"
Substitua os exemplos pelos seus próprios dados.
🔎 Conferindo a configuração
git config --global user.name
git config --global user.email
Quando você realiza um commit, o Git precisa registrar a identidade associada à alteração.
07. O que é um Repositório?
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.
COMPUTADOR
│
│ Git
▼
Repositório local
│
│ push
▼
GITHUB
│
▼
Repositório remoto
08. Criando um Repositório com Git Init
O comando git init transforma uma pasta em um repositório Git.
📝 Passo a passo
- Abra a pasta do projeto no VS Code.
- Abra o terminal.
- Confira se o terminal está localizado dentro da pasta correta.
- Execute:
git init
O Git criou uma estrutura interna para começar a controlar as versões daquele projeto.
Execute git init na pasta correta do projeto.
09. Verificando o Status do Projeto
O comando git status mostra a situação atual dos arquivos do repositório.
git status
🔎 O que podemos descobrir?
- Arquivos modificados.
- Arquivos novos.
- Arquivos preparados para commit.
- Informações sobre o estado do repositório.
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
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 .
Arquivo alterado
↓
git add
↓
Área de preparação
↓
git commit
↓
Histórico
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
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"
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"
git commit -m "alterações"
git commit -m "teste"
git commit -m "coisas"
12. Consultando o Histórico com Git Log
O comando git log apresenta o histórico de commits do repositório.
git log
- Identificação do commit.
- Autor.
- Data.
- Mensagem utilizada.
Cada commit representa um ponto registrado na história do projeto.
13. Criando um Repositório no GitHub
Agora vamos criar no GitHub o repositório remoto que receberá o projeto.
📝 Passo a passo
- Entre na sua conta do GitHub.
- Procure a opção para criar um novo repositório.
- Informe o nome do repositório.
- Escolha se ele será público ou privado.
- Crie o repositório.
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
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
Projeto no computador
│
│ origin
▼
Projeto no GitHub
15. Entendendo Branch
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
Em projetos maiores, uma equipe pode desenvolver novas funcionalidades sem alterar diretamente a versão principal.
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
O comando git push envia commits do repositório local para o repositório remoto.
💻 Comando comum
git push -u origin main
git push = enviar alterações.
origin = repositório remoto principal.
main = branch utilizada como destino.
COMPUTADOR
│
│ git push
▼
GITHUB
17. Atualizando o Projeto — Pull
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 |
PUSH
Local → GitHub
PULL
GitHub → Local
18. Clonando um Projeto — Git Clone
O comando git clone cria uma cópia local de um repositório remoto.
💻 Comando
git clone URL_DO_REPOSITORIO
📝 Quando utilizar?
- Quando entrar em um projeto existente.
- Quando quiser baixar um repositório para o computador.
- Quando começar a trabalhar em um projeto de outra pessoa.
GITHUB
│
│ git clone
▼
COMPUTADOR
19. O Fluxo Básico de Trabalho com Git
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
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?
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
Projetos publicados no GitHub devem possuir uma documentação mínima para que outras pessoas consigam entender sua finalidade.
21. O que é .gitignore?
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
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. |
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
Agora você deverá realizar sozinho o fluxo básico de Git e GitHub.
📋 Missão
- Instale o Git.
- Verifique a instalação com:
git --version
- Configure seu nome.
- Configure seu e-mail.
- Crie uma pasta chamada: projeto-git
- Abra a pasta no VS Code.
- Crie um arquivo: index.html
- Crie um arquivo: README.md
- Inicialize o Git:
git init
- Verifique o status:
git status
- Adicione os arquivos:
git add .
- Crie o primeiro commit:
git commit -m "Criação do projeto"
- Crie um repositório no GitHub.
- Conecte o repositório local ao remoto.
- Envie o projeto utilizando:
git push
Ao final do exercício, você deverá conseguir visualizar seu projeto no GitHub.
🔄 Segunda etapa do desafio
- Altere o arquivo index.html.
- Salve a alteração.
- Execute:
git status
- Prepare a alteração:
git add .
- Crie um novo commit:
git commit -m "Atualização da página inicial"
- Envie para o GitHub:
git push
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?
🚀 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 |
git status
git add .
git commit -m "Mensagem"
git push
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.