LogoLogo
  • Git e GitHub para Humanos
  • Sumário
  • 1. Antes de Começar
    • 1.1 Este livro é para você?
    • 1.2 A razão por trás deste livro
    • 1.3 Visão geral
    • 1.4 Sobre o GitHub
    • 1.5 Sobre a Cumbuca Dev
    • 1.6 O maravilhoso mundo do open source
    • 1.7 Mapa do livro
    • 1.8 Glossário: capítulo 1
  • 2. Fundamentos de Controle de Versão e Git
    • 2.1 Introdução a sistemas de controle de versão
      • 2.1.1 Sistemas de controle de versão centralizados
      • 2.1.2 Sistemas de controle de versão distribuídos
    • 2.2 Introdução ao Git
    • 2.3 Conceitos Fundamentais do Git
      • 2.3.1 Repositório
      • 2.3.2 Commit
      • 2.3.3 Branch
      • 2.3.4 Merge
    • 2.4 Instalando o Git
      • 2.4.1 Instalando no Linux
      • 2.4.2 Instalando no macOS
      • 2.4.3 Instalando no Windows
    • 2.5 Interagindo com o Git
    • 2.6 O Comando Git
    • 2.7 Inicializando de um Repositório Local
    • 2.8 Configurando de um Repositório Local
    • 2.9 Links Úteis: Capítulo 2
    • 2.10 Glossário: Capítulo 2
  • 3. Operações Locais Básicas no Git
    • 3.1 Explorando Operações Locais do Git
    • 3.2 Salvando Alterações Localmente
      • 3.2.1 Adicionando Arquivos ao Controle de Versão via `git add`
      • 3.2.2 Verificando o Estado do Repositório via `git status`
      • 3.2.3 Criando Commits via `git commit`
      • 3.2.4 Visualizando o Histórico do Repositório via `git log`
      • 3.2.5 Comparando Alterações via `git diff`
      • 3.2.6 Unindo os Pontos
      • 3.2.7 Exemplo Prático
    • 3.3 Trabalhando com Branches Localmente
      • 3.3.1 Gerenciando Branches via `git branch`
      • 3.3.2 Alternando Entre Branches via `git switch`
      • 3.3.3 Mesclando Branches via `git merge`
        • 3.3.3.1 Resolvendo Conflitos de Merge
      • 3.3.4 Unindo os Pontos
      • 3.3.5 Exemplo Prático
    • 3.4 Links Úteis: Capítulo 3
    • 3.5 Glossário: Capítulo 3
  • 4. Ajuste de Mudanças Locais no Git
    • 4.1 Desfazendo Alterações Localmente
      • 4.1.1 Desfazendo Alterações Antes do Commit
      • 4.1.2 Desfazendo Commits
      • 4.1.3 Alterando o Último Commit via `git commit --amend`
      • 4.1.4 Unindo os Pontos
      • 4.1.5 Exemplos Práticos
    • 4.2 Ignorando e Removendo Arquivos do Rastreamento Local
      • 4.2.1 Ignorando Arquivos do Rastreamento Utilizando o arquivo .gitignore
      • 4.2.2 Removendo Arquivos do Rastreamento via `git rm`
    • 4.3 Links Úteis: Capítulo 4
    • 4.4 Glossário: Capítulo 4
  • 5. Introdução ao GitHub
    • 5.1 Qual a diferença entre Git e GitHub?
    • 5.2 Grandes Projetos Abertos no GitHub
    • 5.3 Recursos do GitHub
    • 5.4 Idioma Suportado no GitHub
    • 5.5 Contas no GitHub
      • 5.5.1 Conta Pessoal
      • 5.5.2 Conta de Organização
      • 5.5.3 Conta Corporativa
      • 5.5.4 Unindo os Pontos
    • 5.6 Planos do GitHub
    • 5.7 Criando uma Conta Pessoal no GitHub
    • 5.8 Explorando a Interface do GitHub
      • 5.8.1 Página Principal (Home)
      • 5.8.2 Página de Notificações (Notifications)
      • 5.8.3 Página de Configurações (Settings)
    • 5.9 Links Úteis: Capítulo 5
    • 5.10 Glossário: Capítulo 5
  • 6. Repositórios no GitHub
    • 6.1 O quê é um Repositório no GitHub?
    • 6.2 Criando um Repositório no GitHub
    • 6.3 Página Principal de um Repositório: Aba Code
      • 6.3.1 Editando um Arquivo em um Repositório no GitHub
      • 6.3.2 Explorando o Histórico de Commits de um Repositório no GitHub
      • 6.3.3 Editando Detalhes de um Repositório no GitHub
      • 6.3.4 Explorando um Repositório Ativo em Uso
    • 6.4 Página de Configurações de um Repositório: Aba Settings
      • 6.4.1 Gerenciando Configurações Gerais de um Repositório no GitHub: Menu General
      • 6.4.2 Gerenciando Configurações de Colaboração de um Repositório no GitHub: Menu Collaborators
      • 6.4.3 Explorando Configurações de um Repositório no GitHub na Prática
    • 6.5 Links Úteis: Capítulo 6
    • 6.6 Glossário: Capítulo 6
  • 7. Documentação de Projetos
    • 7.1 O quê é Documentação de Projeto?
    • 7.2 Explorando a Linguagem de Marcação Markdown
    • 7.3 Criando uma Página de Apresentação no GitHub
    • 7.4 Links Úteis: Capítulo 7
    • 7.5 Glossário: Capítulo 7
  • 8. Issues no GitHub
    • 8.1 O quê é GitHub Issues?
    • 8.2 Criando uma Issue no GitHub
    • 8.3 Explorando a Página de uma Issue no GitHub
    • 8.4 Atribuindo uma Issue no GitHub
    • 8.5 Categorizando Issues de um Repositório através de Labels no GitHub
      • 8.5.1 Gerenciando Labels de um Repositório no GitHub
    • 8.6 Página de Issues de um Repositório no GitHub: Aba Issues
    • 8.7 Explorando Issues no Mundo Real
    • 8.8 Links Úteis: Capítulo 8
    • 8.9 Glossário: Capítulo 8
  • 9. Git Remoto
    • 9.1 Explorando Operações Remotas do Git
    • 9.2 Interagindo com o Repositório Remoto Central no Git
      • 9.2.1 Clonando um Repositório Remoto via `git clone`
      • 9.2.2 Buscar Atualizações de um Repositório Remoto via `git fetch`
      • 9.2.3 Enviando Mudanças Locais para o Repositório Remoto via `git push`
      • 9.2.4 Sincronizando o Repositório Local com o Remoto via `git pull`
      • 9.2.5 Unindo os Pontos
      • 9.2.6 Exemplo
    • 9.3 Interagindo com o Repositório Remoto hello-world
      • 9.3.1 Conectando-se ao GitHub via SSH
      • 9.3.2 Clonando o Repositório hello-world
      • 9.3.3 Alterando hello-world Localmente
        • 9.3.3.1 Editor de Código
        • 9.3.3.2 Editando README.md
        • 9.3.3.3 Salvando Alterações no Controle de Versão Local
      • 9.3.4 Enviando Alterações para o Repositório Remoto
    • 9.4 Links Úteis: Capítulo 9
    • 9.5 Glossário: Capítulo 9
  • 10. Pull Requests no GitHub
    • 10.1 O quê é um Pull Requests no GitHub?
    • 10.2 Entendendo as Propriedades de um Pull Request no GitHub
      • 10.2.1 Branches de Origem e de Destino de um Pull Request
      • 10.2.2 Título de um Pull Request
      • 10.2.3 Descrição de um Pull Request
      • 10.2.4 Modificações de um Pull Request
      • 10.2.5 Pessoas Revisoras de um Pull Request
      • 10.2.6 Labels de um Pull Request
    • 10.3 Criando um Pull Request no GitHub
    • 10.4 Página de um Pull Request no GitHub
      • 10.4.1 Aba Conversation
      • 10.4.2 Aba Commits
      • 10.4.3 Aba Checks
      • 10.4.4 Aba Files Changed
    • 10.5 Página de Pull Requests de um Repositório no GitHub: Aba Pull Requests
    • 10.6 Recebendo Revisões em um Pull Request no GitHub
      • 10.6.1 Boas Práticas
      • 10.6.2 Exemplo Prático
        • 10.6.2.1 Adicionando Conta Colaboradora
        • 10.6.2.2 Solicitando Revisão de Pull Request
        • 10.6.2.3 Lidando com o Feedback
    • 10.7 Mesclando um Pull Request no GitHub
      • 10.7.1 Exemplo Prático
    • 10.8 Atualizando um Repositório Local Após Mesclagem
    • 10.9 Explorando Pull Requests no Mundo Real
    • 10.10 Links Úteis: Capítulo 10
    • 10.11 Glossário: Capítulo 10
  • 11. Fluxo de Trabalho
    • 11.1 Fork no GitHub
      • Fork
    • 11.2 Forks e Pull Requests
      • 11.2.1 Criando um Fork no GitHub
      • 11.2.2 Clonando um Fork
      • 11.2.3 Realizando Alterações Localmente
      • 11.2.4 Enviando Alterações Locais para o Fork Remoto
      • 11.2.5 Criando um Pull Request a partir de um Fork no GitHub
      • 11.2.6 Sincronizando um Fork no GitHub
      • 11.2.7 Revisão, Mesclagem e Atualizações Pós-mesclagem
    • 11.3 Fluxo de Trabalho
  • 11.4 Links Úteis - Capítulo 11
  • 11.5 Glossário - Capítulo 11
  • 12. O Caminho Continua
    • 12.1 Conhecendo Ferramentas Adicionais
      • 12.1.1 Indicação: Jogo Oh My Git
    • 12.2 Explorando Projetos Open Source
    • 12.3 Crescendo e Colaborando em Comunidades
    • 12.4 Desafio: GitCaos 🔥
    • 12.5 Links Úteis - Capítulo 12
    • 12.6 Glossário Completo: Git e GitHub para Humanos
Fornecido por GitBook
Nesta página
  • Passo a Passo
  • 1. Inicializar um Repositório Vazio
  • 2. Verificar o Status do Repositório
  • 3. Verificar o Histórico de Commits
  • 4. Criar um Arquivo
  • 5. Verificar o Status do Repositório
  • 6. Verificar Diferenças para o Último Commit
  • 7. Preparar o Arquivo para Commit
  • 8. Verificar o Status do Repositório
  • 9. Fazer o Commit
  • 10. Verificar o Status do Repositório
  • 11. Verificar o Histórico de Commits
  • 12. Modificar um Arquivo
  • 13. Verificar o Status do Repositório
  • 14. Verificar Diferenças para o Último Commit
  • 15. Preparar o Arquivo para Novo Commit
  • 16. Verificar o Status do Repositório
  • 17. Fazer Novo Commit
  • 18. Verificar o Status do Repositório
  • 19. Verificar o Histórico de Commits
  • Visão Geral dos Estados do Arquivo

Isto foi útil?

Editar no GitHub
Exportar como PDF
  1. 3. Operações Locais Básicas no Git
  2. 3.2 Salvando Alterações Localmente

3.2.7 Exemplo Prático

Passo a Passo

1. Inicializar um Repositório Vazio

Crie uma pasta no seu computador chamada de meu-repo .

mkdir meu-repo

Confira que a pasta foi criada com sucesso. A pasta meu-repo deve estar listada no resultado do comando.

🔹 Linux/macOS

ls -la

🔹 Windows (CMD/PowerShell)

dir /a

Entre na pasta recém criada.

cd meu-repo

Inicialize essa pasta como um repositório com o comando git init.

git init
▶ Initialized empty Git repository in /.../meu-repo/.git/

Confira que a pasta oculta .git foi criada. A pasta .git deve estar listada no resultado do comando.

🔹 Linux/macOS

ls -la

🔹 Windows (CMD/PowerShell)

dir /a

2. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

O resultado deve mostrar que não consta nada para ser commitado, nada na área de stage e não há nada que não está sendo rastreado.

3. Verificar o Histórico de Commits

Execute o comando git log para verificar o histórico de commits do repositório

git log
▶ fatal: your current branch 'main' does not have any commits yet

Um erro será mostrado, uma vez que nenhum commit foi realizado ainda neste repositório.

4. Criar um Arquivo

Crie um arquivo chamada arquivo.txt contendo a palavra "cumbuca". Você pode fazer isso via comando de terminal ou via um editor de texto. Este é o comando para criar via terminal.

echo cumbuca > arquivo.txt

Liste os arquivos na sua pasta novamente. O arquivo arquivo.txt deve estar listada no resultado do comando.

🔹 Linux/macOS

ls -la

🔹 Windows (CMD/PowerShell)

dir /a

Verifique o conteúdo do arquivo. O resultado deve ser cumbuca.

🔹 Linux/macOS

cat arquivo.txt
▶ cumbuca

🔹 Windows (CMD/PowerShell)

type arquivo.txt
▶ cumbuca

5. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	arquivo.txt

nothing added to commit but untracked files present (use "git add" to track)

Perceba que o arquivo arquivo.txt agora deverá estar sinalizado como "untracked" (não rastreado).

6. Verificar Diferenças para o Último Commit

Execute o comando git diff para ver as diferenças entre o estado atual e o último commit.

git diff

Nada será mostrado, pois o arquivo.txt é um arquivo novo e ainda não foi rastreado pelo Git. Além de não existir commits anteriores.

7. Preparar o Arquivo para Commit

Execute o comando git add arquivo.txt para adicionar o arquivo à área de stage.

git add arquivo.txt

8. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
	new file:   arquivo.txt

O arquivo arquivo.txt deve constar na área de stage agora, pronto para ser commitado. O seu estado atual é "tracked" e "staged" (rastreado e em área de preparação).

9. Fazer o Commit

Use o comando git commit -m "Adicionando arquivo arquivo.txt" para salvar a sua alteração.

git commit -m "Adicionando arquivo arquivo.txt"
▶ [main (root-commit) fc34c35] Adicionando arquivo arquivo.txt
 1 file changed, 1 insertion(+)
 create mode 100644 arquivo.txt

10. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main
nothing to commit, working tree clean

O arquivo arquivo.txt foi salvo no repositório, e o arquivo voltou ao estado "tracked" e "committed" (rastreado e confirmado).

11. Verificar o Histórico de Commits

Execute o comando git log para ver o histórico de commits do repositório.

commit fc34c35c38eb1b4ee19014b82a5572345165affc (HEAD -> main)
Author: Cumbuca Dev <cumbucadev@gmail.com>
Date:   Wed Jun 12 22:03:33 2024 +0200

    Adicionando arquivo arquivo.txt

Agora, o seu primeiro commit no repositório já está sendo listado.

12. Modificar um Arquivo

Adicione uma nova linha ao final do arquivo arquivo.txt contendo a frase "dev". Você pode fazer isso via comando de terminal ou via um editor de texto. Este é o comando para criar via terminal

echo dev >> arquivo.txt

Verifique o conteúdo do arquivo. O resultado deve ser um texto contendo cumbuca na primeira linha e dev na segunda.

🔹 Linux/macOS

cat arquivo.txt
▶ cumbuca
dev

🔹 Windows (CMD/PowerShell)

type arquivo.txt
▶ cumbuca
dev

13. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   arquivo.txt

no changes added to commit (use "git add" and/or "git commit -a")

O arquivo arquivo.txt agora está "tracked" e "modified" (rastreado e modificado).

14. Verificar Diferenças para o Último Commit

Execute o comando git diff para verificar as diferenças entre o estado atual e o último commit.

git diff
diff --git a/arquivo.txt b/arquivo.txt
index 9bbb6ca..cf44cf3 100644
--- a/arquivo.txt
+++ b/arquivo.txt
@@ -1 +1,2 @@
 cumbuca
+dev

15. Preparar o Arquivo para Novo Commit

Execute o comando git add arquivo.txt para adicionar o arquivo novamente à área de stage.

git add arquivo.txt

16. Verificar o Status do Repositório

Execute o comando usa git status para verificar o estado atual do diretório de trabalho e da área de stage.

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	modified:   arquivo.txt

O arquivo arquivo.txt agora está "tracked" e "staged" (rastreado e em área de preparação) novamente.

17. Fazer Novo Commit

Execute o comando git commit -m "Adicionando mais uma linha ao arquivo.txt" para salvar a sua alteração.

git commit -m "Adicionando mais uma linha ao arquivo.txt"
▶ [main 8af53f0] Adicionando mais uma linha ao arquivo.txt
 1 file changed, 1 insertion(+)

18. Verificar o Status do Repositório

Execute o comando git status para verificar o estado atual do diretório de trabalho e da área de stage.

git status
▶ On branch main
nothing to commit, working tree clean

O arquivo arquivo.txt foi salvo no repositório, e o arquivo voltou ao estado "tracked" e "committed" (rastreado e confirmado).

19. Verificar o Histórico de Commits

Execute o comando git log para ver o histórico de commits do repositório. Você deve encontrar dois commits agora.

git log
commit 8af53f08777121067a34aa03269318c103493a79 (HEAD -> main)
Author: Camila Maia <cmaiacd@gmail.com>
Date:   Mon Feb 17 18:54:27 2025 -0300

    Adicionando mais uma linha ao arquivo.txt

commit fc34c35c38eb1b4ee19014b82a5572345165affc
Author: Camila Maia <cmaiacd@gmail.com>
Date:   Mon Feb 17 18:33:17 2025 -0300

    Adicionando arquivo arquivo.txt

Visão Geral dos Estados do Arquivo

Anterior3.2.6 Unindo os PontosPróximo3.3 Trabalhando com Branches Localmente

Atualizado há 3 meses

Isto foi útil?

Inicializando um repositório vazio
Estados do arquivo arquivo.txt