Download do código: LearnGit.txt
Git é um sistema distribuido de gestão para código fonte e controlo de versões.
Funciona através de uma série de registos de estado do projecto e usa esse registo para permitir funcionalidades de versionamento e gestão de código fonte.
Controlo de versões (source control) é um processo de registo de alterações a um ficheiro ou conjunto de ficheiros ao longo do tempo.
Um conjunto de ficheiros, directórios, registos históricos, commits e referências. Pode ser imaginado como uma estrutura de dados de código fonte com a particularidade de cada elemento do código fonte permitir acesso ao histórico das suas alterações, entre outras coisas.
Um repositório git é constituido pelo directório .git e a working tree
O repositório .git contém todas as configurações, logs, branches, referências e outros.
Isto é basicamente os directórios e ficheiros do repositório. É frequentemente referido como o directório do projecto.
O Index é a camada de interface no git. Consistente num elemento que separa o directório do projecto do repositório git. Isto permite aos programadores um maior controlo sobre o que é registado no repositório git.
Um commit* de git é um registo de um cojunto de alterações ou manipulações nos ficheiros do projecto. Por exemplo, ao adicionar cinco ficheiros e remover outros 2, estas alterações serão gravadas num commit (ou registo). Este commit pode então ser enviado para outros repositórios ou não!
Um branch é essencialmente uma referência que aponta para o último commit efetuado. À medida que são feitos novos commits, esta referência é atualizada automaticamente e passa a apontar para o commit mais recente.
HEAD é a referência que aponta para o branch em uso. Um repositório só tem uma HEAD activa. head é uma referência que aponta para qualquer commit. Um repositório pode ter um número indefinido de heads
Cria um repositório Git vazio. As definições, informação guardada e outros do repositório git são guardados num directório (pasta) denominado ".git".
$ git init
Permite configurar as definições, sejam as definições do repositório, sistema ou configurações globais.
# Imprime e define algumas variáveis de configuração básicas (global)
$ git config --global user.email
$ git config --global user.name
$ git config --global user.email "[email protected]"
$ git config --global user.name "My Name"
Aprenda mais sobre git config. (EN)
Para aceder rapidamente a um guia extremamente detalhada sobre cada comando. Ou para dar apenas uma lembraça rápida de alguma semântica.
# Ver rapidamente os comandos disponiveis
$ git help
# Ver todos os comandos disponiveis
$ git help -a
# Requerer *help* sobre um comando especifico - manual de utilizador
# git help <command_here>
$ git help add
$ git help commit
$ git help init
Apresenta as diferenças entre o ficheiro index (no fundo a versão corrente do repositório) e o commit da HEAD atual.
# Apresenta o *branch*, ficheiros não monitorizados, alterações e outras
# difereças
$ git status
# Para aprender mais detalhes sobre git *status*
$ git help status
Adiciona ficheiros ao repositório corrente. Se os ficheiros novos não forem
adicionados através de git add ao repositório, então eles não serão
incluidos nos commits!
# adiciona um ficheiro no directório do projecto atual
$ git add HelloWorld.java
# adiciona um ficheiro num sub-directório
$ git add /path/to/file/HelloWorld.c
# permite usar expressões regulares!
$ git add ./*.java
Gere os branches. É possível ver, editar, criar e apagar branches com este comando.
# listar *branches* existentes e remotos
$ git branch -a
# criar um novo *branch*
$ git branch myNewBranch
# apagar um *branch*
$ git branch -d myBranch
# alterar o nome de um *branch*
# git branch -m <oldname> <newname>
$ git branch -m myBranchName myNewBranchName
# editar a descrição de um *branch*
$ git branch myBranchName --edit-description
Atualiza todos os ficheiros no directório do projecto de forma a ficarem iguais à versão do index ou do branch especificado.
# Checkout de um repositório - por predefinição para o branch master
$ git checkout
# Checkout de um branch especifico
$ git checkout branchName
# Cria um novo branch e faz checkout para ele.
# Equivalente a: "git branch <name>; git checkout <name>"
$ git checkout -b newBranch
Clona ou copia um repositório existente para um novo directório. Também adiciona branches de monitorização remota para cada branch no repositório clonado o que permite enviar alterações para um branch remoto.
# Clona learnxinyminutes-docs
$ git clone https://github.com/adambard/learnxinyminutes-docs.git
Guarda o conteudo atual do index num novo commit. Este commit contém as alterações feitas e a mensagem criada pelo utilizador.
# commit com uma mensagem
$ git commit -m "Added multiplyNumbers() function to HelloWorld.c"
Apresenta as diferenças entre um ficheiro no repositório do projecto, index e commits
# Apresenta a diferença entre o directório atual e o index
$ git diff
# Apresenta a diferença entre o index e os commits mais recentes
$ git diff --cached
# Apresenta a diferença entre o directório atual e o commit mais recente
$ git diff HEAD
Permite procurar facilmente num repositório
Configurações opcionais:
# Obrigado a Travis Jeffery por estas
# Define a apresentação de números de linha nos resultados do grep
$ git config --global grep.lineNumber true
# Torna os resultados da pesquisa mais fáceis de ler, agrupando-os
$ git config --global alias.g "grep --break --heading --line-number"
# Pesquisa por "variableName" em todos os ficheiros de java
$ git grep 'variableName' -- '*.java'
# Pesquisa por uma linha que contém "arrayListName" e "add" ou "remove"
$ git grep -e 'arrayListName' --and \( -e add -e remove \)
Google é teu amigo; para mais exemplos: Git Grep Ninja (EN)
Apresenta commits do repositório.
# Apresenta todos os commits
$ git log
# Apresenta X commits
$ git log -n 10
# Apresenta apenas commits de merge
$ git log --merges
"Merge" (junta) as alterações de commits externos com o branch atual.
# Junta o branch especificado com o atual
$ git merge branchName
# Para gerar sempre um commit ao juntar os branches
$ git merge --no-ff branchName
Alterar o nome ou mover um ficheiro.
# Alterar o nome de um ficheiro
$ git mv HelloWorld.c HelloNewWorld.c
# Mover um ficheiro
$ git mv HelloWorld.c ./new/path/HelloWorld.c
# Forçar a alteração de nome ou mudança local
# "existingFile" já existe no directório, será sobre-escrito.
$ git mv -f myFile existingFile
Puxa alterações de um repositório e junta-as com outro branch
# Atualiza o repositório local, juntando as novas alterações
# do repositório remoto 'origin' e branch 'master'
# git pull <remote> <branch>
# git pull => aplica a predefinição => git pull origin master
$ git pull origin master
# Juntar alterações do branch remote e fazer rebase commits do branch
# no repositório local, como: "git pull <remote> <branch>, git rebase <branch>"
$ git pull origin master --rebase
Enviar e juntar alterações de um branch para o seu branch correspondente num repositório remoto.
# Envia e junta as alterações de um repositório local
# para um remoto denominado "origin" no branch "master".
# git push <remote> <branch>
# git push => aplica a predefinição => git push origin master
$ git push origin master
Pega em todas as alterações que foram registadas num branch e volta a aplicá-las em outro branch. Não deve ser feito rebase de commits que foram enviados para um repositório público
# Faz Rebase de experimentBranch para master
# git rebase <basebranch> <topicbranch>
$ git rebase master experimentBranch
Restabelece a HEAD atual ao estado definido. Isto permite reverter merges, pulls, commits, adds e outros. É um comando muito poderoso mas também perigoso se não há certeza quanto ao que se está a fazer.
# Restabelece a camada intermediária de registo para o último
# commit (o directório fica sem alterações)
$ git reset
# Restabelece a camada intermediária de registo para o último commit, e
# sobre-escreve o projecto atual
$ git reset --hard
# Move a head do branch atual para o commit especificado, sem alterar o projecto.
# todas as alterações ainda existem no projecto
$ git reset 31f2bb1
# Inverte a head do branch atual para o commit especificado
# fazendo com que este esteja em sintonia com o directório do projecto
# Remove alterações não registadas e todos os commits após o commit especificado
$ git reset --hard 31f2bb1
O oposto de git add, git rm remove ficheiros do branch atual.
# remove HelloWorld.c
$ git rm HelloWorld.c
# Remove um ficheiro de um sub-directório
$ git rm /pather/to/the/file/HelloWorld.c
Tens alguma sugestão? Uma correção, talvez? Abre um Issue no repositório do GitHub, or faz um pull request tu mesmo!
Originalmente contribuido por Jake Prather, e atualizado por 5 contribuidores.