Repositório Local (Localhost)

Prévia do material em texto

🌳 Anotações de Git: Repositório Local (Localhost)
Aqui está a organização dos seus comandos e conceitos básicos para trabalhar com o Git em um repositório local, utilizando o Git Bash (terminal local).
	Conceito
	Definição
	Git
	Software de versionamento de código distribuído. Ele rastreia e gerencia as mudanças no seu código.
	Git Bash
	Um terminal para Windows que fornece uma interface de linha de comando para interagir com o Git.
	GitHub
	Um serviço de hospedagem remoto para repositórios Git (o "servidor").
1. 🖥️ Comandos Básicos de Terminal (Bash)
Estes comandos ajudam você a navegar e gerenciar seu ambiente local antes mesmo de usar o Git.
	Comando
	Descrição
	pwd
	Print Working Directory. Mostra o caminho completo do diretório (pasta) onde você está atualmente.
	ls
	List. Mostra os arquivos e subdiretórios no local atual.
	cd + nome_pasta
	Change Directory. Move você para a pasta especificada. Dica: Use a tecla Tab para autocompletar o nome da pasta.
	clear ou Ctrl + L
	Limpa a tela do terminal, tornando a visualização mais organizada.
📚 Documentação (Help)
	Comando
	Descrição
	pwd --help
	Mostra os argumentos e opções possíveis para o comando pwd.
	ls --help
	Mostra os argumentos e opções possíveis para o comando ls.
	git --help
	Exibe a lista completa de comandos e opções disponíveis no Git.
2. 📁 Configuração e Inicialização do Repositório
A. Criação de Diretório e Arquivos
	Comando
	Descrição
	mkdir + nome
	Cria um novo diretório (pasta) no seu local atual.
	cd + nome/
	Move para o diretório recém-criado.
	ls -a
	Lista todos os arquivos, incluindo arquivos ocultos (começados por .), como a pasta .git após a inicialização.
	touch + nome.extensão
	Cria um novo arquivo vazio com a extensão especificada (ex: index.html, style.css).
	ls ou ls -l
	Verifica os arquivos criados. (-l mostra detalhes como permissões e data de alteração).
B. Configuração Inicial do Git (Uma Única Vez)
Essas configurações identificam você como o autor dos commits globalmente em sua máquina.
	Comando
	Descrição
	git config --global user.name "Seu Nome"
	Define seu nome de usuário global para ser usado nos commits.
	git config --global user.email "seu.email@exemplo.com"
	Define seu e-mail global para ser usado nos commits.
	git config -l
	Verifica todas as configurações atuais do Git.
C. Inicialização do Repositório Git
	Comando
	Descrição
	git init .
	Inicializa o Git na pasta atual. O ponto (.) significa o diretório principal atual. Cria a pasta oculta .git/.
	ls -a
	Usado para confirmar a criação da pasta oculta .git.
	ls .git/
	Verifica o conteúdo da pasta .git para confirmar a inicialização.
D. Configuração do Branch Principal
	Passo
	Comando
	Descrição
	1. (Global/Uma Vez)
	git config --global init.defaultBranch main
	Configura o Git para que novos repositórios sejam criados com o branch padrão chamado main.
	2. (Neste Repositório)
	git branch -m main
	Renomeia o branch atual (que geralmente é master por padrão) para main.
3. 💾 O Ciclo de Commit (Salvamento de Versão)
O commit é a ação de salvar uma "fotografia" (versão) do seu projeto.
	Conceito
	Descrição
	Commit
	Ponto de salvamento ou "checkpoint" que registra as alterações feitas até aquele momento.
	Untracked
	Arquivos novos que o Git ainda não está rastreando.
	Changes to be committed
	Arquivos que foram modificados ou adicionados (staged) e estão prontos para serem incluídos no próximo commit.
	Passo
	Comando
	Descrição
	1. Verificação
	git status
	Verifica o estado atual do repositório: quais arquivos são untracked, quais estão modificados e quais estão prontos (staged).
	2. Preparação (Stage)
	git add nome_arquivo.extensao
	Adiciona o arquivo específico para a área de staging (preparando-o para o commit).
	Opções:
	git add .
	Adiciona TUDO (arquivos untracked e modificados) de uma vez.
	
	git add *.extensao
	Adiciona todos os arquivos que têm a extensão especificada (ex: *.css).
	3. Salvamento (Commit)
	git commit -m "Mensagem de identificação"
	Salva a versão atual do código com as alterações preparadas (staged). A mensagem deve ser objetiva.
	4. Histórico
	git log
	Mostra o histórico detalhado de todos os commits (ID, autor, data e mensagem).
	
	git log --oneline
	Mostra um histórico de commits de forma resumida (ID curto e mensagem).
	Desfazer:
	git reset
	Desfaz alterações (uso avançado e com diferentes opções, dependendo do que se deseja desfazer).
4. 🌿 Branches (Ramificações)
Branches permitem desenvolver novas funcionalidades ou corrigir erros isoladamente, sem afetar o código principal (main).
	Comando
	Descrição
	git checkout -b nome_branch
	Cria uma nova branch e, em seguida, muda para ela (checkout).
	git branch
	Lista todas as branches locais. A branch atual é marcada com um asterisco (*).
	git checkout main ou git checkout nome_branch
	Muda para a branch especificada.
	git diff nome_arquivo.extensao
	Mostra as diferenças linha por linha entre a versão atual do arquivo e a última versão commitada ou staged.
	git merge nome_branch
	Combina as alterações da nome_branch na branch atual. Deve ser executado na branch de destino (ex: faça checkout para main e depois git merge nome_branch).
	git branch -d nome_branch
	Deleta a branch local, mas somente se as alterações já tiverem sido mergeadas (combinadas).