En ligne de commande

git config --global user.name "Nom et prénom de l'utilisateur" # Nom de l'utilisateur
git config --global user.email "Adresse email de l'utilisateur" # Adresse email de l'utilisateur
git config --global color.ui "auto" # Colorisation des résultats
git config --global core.editor vim # Choix de l'éditeur par défaut
git config --global help.autocorrect 1 # Auto-correction des commandes
git config --global core.autocrlf false # Non conversion du caractère de fin de ligne
git config --global commit.template <filename> # Utilisation d'un modèle de message pour la validation
git config --global alias.st 'status' # Création d'un alias de la fonction "status"

git config --global --unset user.name

Avec un fichier de configuration

Le fichier a modifier est le fichier .gitconfig à la racine du répertoire de l'utilisateur. Il est généré automatiquement lors de l'utilisation des commandes de configuration.

[user]
        email = Adresse email de l'utilisateur
        name = Nom et prénom de l'utilisateur
[core]
        editor = vim 
        autocrlf = false
[color]
        ui = auto
[help]
        autocorrect = 1
[alias]
        st = status
[commit]
        template = <filename>

Des alias pour gagner du temps

En plus de raccourcir certaines commandes, les alias permettent aussi de combiner des actions répétitives en une seule commande. Voici les alias que j'utilise actuellement.

.gitconfig

[alias]
        ; List aliases
        alias = !git config --get-regexp '^alias\\.' | sed --expression s/^alias\\.// --expression s/\\ /\\\\t\\ / | sort
        ; Amend content to the last commit
	amend = commit --amend --no-edit
        ; Check for whitespace errors
        check = diff --check HEAD
        ; Fixup a commit into another
        fixup = !sh -c 'git stash --keep-index && SHA=$(git rev-parse $1) && git commit --fixup $SHA && GIT_SEQUENCE_EDITOR=: git rebase --interactive --autosquash $SHA~ && git stash pop' -
	; Show branch ordered by last working time
	last-work = branch --sort='-committerdate' --format='%(color:green)%(committerdate:relative)%(color:reset) %(refname:short) --color=always'
        ; Show log on oneline
        oneline = log --oneline --abbrev-commit --graph
        ; Retrieve a PR locally
        pr = !sh -c 'git fetch ${2:-origin} pull/$1/head:pr/$1 && git checkout pr/$1' -
        ; Prune local tags that don't exist on remote
        pt = !git tag -l | xargs git tag -d && git fetch -t

Logs

L'ensemble de ces commandes sont utilisables pour un fichier particulier en ajoutant -- <file_path> à la fin de la commande.

# Afficher les logs
git log
 
# Afficher les logs avec les statistiques
git log --stat
 
# Afficher les logs des n dernières révisions
git log -n
 
# Afficher les logs sur une ligne
git log --oneline
 
# Afficher les logs entre 2 révisions
git log <commit>..<commit>
 
# Afficher l'historique condensé des révisions
git log --pretty=oneline --abbrev-commit --graph --decorate
 
# Afficher la liste des tags par date
git log --date-order --graph --tags --simplify-by-decoration --pretty=format:'%ai %h %d'

Commits

• Révisionner du code

# Ajouter les fichiers à révisionner
git add <file1> <file2>
# Révisionner les modifications
git commit
# À ce moment, l'éditeur de texte par défaut va s'ouvrir pour ajouter un message à la révision
 
# Il est aussi possible de faire tout ça automatiquement
git commit -a -m <message>

• Annuler l'ajout d'un fichier dans l'index

git reset HEAD <file>

• Modifier le nom de l'utilisateur de la dernière révision

# Attention, l'utilisation de cette commande est déconseillée si le code a été partagé.
git commit --amend --reset-author

• Modifier la dernière révision ²⁾

# Attention, l'utilisation de cette commande est déconseillée si le code a été partagé.
git commit --amend

• Modifier une ancienne révision ³⁾

# Pour modifier la révision bbc643cd
git rebase --interactive bbc643cd^
# À ce moment, l'éditeur de texte par défaut va s'ouvrir pour sélectionner les révisions à modifier.
# Changer pick pour edit en face des révisions à modifier.
 
# Faire les changements nécessaire et ajouter les fichiers.
git add <file1> <file2>
 
# Appliquer les changements
git commit --amend
 
# Poursuivre l'application des changements
git rebase --continue

• Supprimer la dernière révision

# Si la révision n'a pas été partagée et que l'on veut conserver les modifications
git reset --soft HEAD~1
 
# Si la révision n'a pas été partagée et que l'on veut supprimer les modifications
git reset --hard HEAD~1
 
# Si la révision a été partagée
git revert HEAD

• Pour aller plus loin
  • Squashing commits with rebase
  • Faire une révision sous une autre identité
  • Antidater une révision
  • How can I split up a Git commit buried in history?

Branches

• Afficher les branches

# Locales
git branch
# Distantes
git branch -r
# Toutes
git branch -a
# Déjà disponibles dans la branche courante
git branch --merged
# Pas encore disponibles dans la branche courante
git branch --no-merged

• Créer une branche locale

# La manière rapide
git checkout -b <branch>
 
# La manière détaillée
git branch <branch>
git checkout <branch>

• Récupérer une branche distante

# Récupérer la liste des branches distantes disponibles
git fetch origin
# Récupérer la liste des branches distantes disponibles en supprimant les branches supprimées - version longue
git fetch --prune origin
# Récupérer la liste des branches distantes disponibles en supprimant les branches supprimées - version courte
git fetch -p origin
 
# Création d'une branche locale à partir de la branche distante
git checkout -b <branch> origin/<branch>

• Changer le nom d'une branche locale

git branch -m <old-branch> <new-branch>

• Supprimer une branche locale

# Supprimer une branche qui a été fusionnée
git branch -d <branch>
# Forcer la suppression d'une branche
git branch -D <branch>

• Supprimer une branche distante

# La manière compréhensible
git push --delete origin <branch>
# La manière moins compréhensible au premier abord
git push origin :refs/remote/origin/<branch>
# et son raccourci
git push origin :<branch>

• Lier une branche existante à une branche distante

# Syntaxe courte
git branch -u <remote_branch> <local_branch>
 
# Syntaxe longue
git branch --set-upstream-to <remote_branch> <local_branch>

• Supprimer les branches locales obsolètes

git remote prune origin

• Comparer un fichier entre 2 branches

git diff <branch_1> <branch_2> -- <fichier>
 
# Avec cette syntaxe, la référence peut être une branche, un tag, un commit, ...
git diff <reference_1>..<reference_2> <fichier>

• Pousser une branche

# Quand les références des branches sont identiques
git push <remote> <branch>
 
# Quand les références des branches sont différentes
git push <remote> <src/branch>:<dst/branch>

• Afficher le point d'origine d'une branche

git merge-base HEAD <branch>

• Revenir à la branche précédente

git checkout -

• Pour aller plus loin
  1. How to recover a git branch you accidentally deleted
  2. How to unmerge a Git merge?

Tags

• Lister les tags

git tag

• Créer un tag à usage privé ou temporaire (tag léger)

git tag <tagname>

• Créer un tag à usage public (tag annoté)

git tag -a <tagname>

• Créer un tag distant

Il faut que le tag existe déjà localement pour pouvoir le créer sur un repository distant.

# Pour créer un seul tag
git push origin <tagname>
# Pour créer tous les tags
git push --tags

• Supprimer un tag distant ⁴⁾

# La manière compréhensible
git push --delete origin <tagname>
# La manière moins compréhensible au premier abord
git push origin :refs/tags/<tagname>
# et son raccourci
git push origin :<tagname>

• Remplacer un tag léger par un tag annoté ⁵⁾

# Récupérer le code associé au tag
git checkout <tagname>
 
# Supprimer le tag local
git tag -d <tagname>
 
# Créer le tag annoté antidaté à la date de la révision
GIT_COMMITTER_DATE="$(git show --format=%aD | head -1)" git tag -a <tagname>
 
# Supprimer le tag distant
git push origin :refs/tags/<tagname>
 
# Créer le tag distant
git push --tags

Notes

• Ajouter une note sur un commit

# Sans espace de nom
git notes add -m <message> <commit>
 
# Avec espace de nom
git notes --ref=<namespace> add -m <message> <commit>

• Voir une note

# Sans espace de nom
git log
 
# Avec espace de nom (les caractères de remplacement sont supportés)
git log --show-notes=<namespace>

• Éditer une note

# Sans espace de nom
git notes edit <commit>
 
# Avec espace de nom
git notes --ref=<namespace> edit <commit>

• Pour aller plus loin
  1. Note to Self
  2. Git Tip of the Week: Git Notes

Divers

• Créer et appliquer un patch ⁶⁾

# Création d'un fichier patch
git format-patch <commit.1>..<commit.2> --stdout > <file.patch>
 
# Création d'un fichier patch en changeant le chemin d'accès aux fichiers
git format-patch <commit.1>..<commit.2> --src-prefix="a/new/path/" --dst-prefix="b/new/path/" --stdout > <file.patch>
 
# Vérification du patch
git apply --check <file.patch>
 
# Application des modifications apportées par le patch
git apply <file.patch>
 
# Application des commits apportés par le patch
git am <file.patch>

• Modifier l'historique

git rebase -i <commit>

• Ajouter des fichiers à l'index

git add -i

• Récupérer un fichier d'un révision particulière

git checkout <treeish> -- <path>

• Afficher un fichier d'un révision particulière

git show <treeish>:<file>

• Voir les modifications effectuées

# Modifications des fichiers du répertoire de travail
git diff
# Modification des fichiers de la zone de transit
git diff --staged
git diff --cached
# Vérification des erreurs de caractères blancs
git diff --check
 
# Modification entre deux branches
git diff <branch>..<branch>
# Modification entre deux branches (nom et statut)
git diff --name-status <branch>..<branch>
# Modification entre deux branches (nom seulement)
git diff --name-only <branch>..<branch>

• Mettre de côté des modifications (documentation officielle)

# Mettre de côté toutes les modifications
git stash
# Mettre de côté toutes les modifications à l'exception de celles présentent dans l'index
git stash --keep-index
# Lister les réserves de code
git stash list
# Appliquer la dernière réserve de code
git stash apply
# Supprimer la dernière réserve de code
git stash drop
# Afficher les modifications contenues dans le "stash"
git stash show -p stash@{0}

• Afficher la liste des fichiers d'un commit

git diff-tree --no-commit-id --name-only -r <treeish>

• Dupliquer un projet

# Duplique un projet dans un répertoire éponyme créé automatiquement
git clone <project>
 
# Duplique un projet dans un répertoire sélectionné
git clone <project> <folder>

• Créer une archive d'un projet

git archive --format=tar.gz <treeish> > <file>

• Dupliquer un repository ⁷⁾

# Faire un clone brut du projet
git clone --bare <old-repository>
 
# Faire un miroir du projet
cd old-repository
git push --mirror <new-repository>
 
# Suppression du clone brut
cd -
rm -rf old-repository

• Afficher la liste des branches actives

# Sans filtre
git ls-remote --heads origin
 
# Avec un filtre simple
git ls-remote --heads origin master
 
# Avec un filtre complexe
git ls-remote --heads origin master develop release\*

Aide mémoire

1. Index des commandes
2. Aide mémoire Git
3. Aide mémoire Git
4. Version en ligne et complète du livre «Pro Git»

Pour commencer

1. A git Primer
2. Git How To
3. Git - Tutorial
4. Ce que j’aurais aimé savoir quand j’ai commencé Git
5. Git commit good practice
6. Un cours étape par étape pour apprendre à se servir de Git
7. Git it, article pour commencer avec Git
8. Git immersion
9. Learn Enough Git to Be Dangerous
10. Learn git concepts, not commands - DEV Community 👩‍💻👨‍💻
11. Git from the Bottom Up

Pour aller plus loin

1. Working with dates in Git
2. Git commit hooks using PHP
3. Customizing Git - Git Hooks
4. PHP syntax checker for Git repository changes
5. Composer.phar, composer.lock and git
6. Managing large binary files with git
7. Git pour les (futurs) barbus
8. Think Like (a) Git
9. Un prompt Git qui déchire
10. Bien utiliser Git merge et rebase
11. Une explication détaillée pour un système de branches efficace
12. Apprendre git un commit à la fois
13. Pour arrêter de galérer avec Git
14. Git - tutorial
15. 19 Tips For Everyday Git Use
16. Local git repository with composer
17. GitHub Flow Like a Pro with these 13 Git Aliases
18. Git Flow cheatsheet
19. Test Any Open Source Pull Request in Seconds
20. Débugger avec Git
21. Git magic
22. How to recover a dropped stash in Git?
23. Git dammit!

Humour

1. sur angriestprogrammer.com
2. sur xkcd.com
3. sur commitstrip.com
4. En cas d'incendie et le script qui va avec.
5. sur xkcd.com encore