Alias Git : accélérer votre workflow quotidien

Les alias Git remplacent une commande longue par un raccourci de 2 à 4 lettres. Au lieu de taper git log --oneline --graph --all --decorate, vous tapez git lg. Ce guide vous donne les alias essentiels puis vous montre comment créer les vôtres.

Prérequis : Git installé et configuré.

Ce que vous allez apprendre

Créer vos premiers alias pour les commandes du quotidien (co, st, lg)
Utiliser des alias avancés avec formatage de log personnalisé
Intégrer des commandes shell dans vos alias avec le préfixe !
Partager et versionner vos alias via .gitconfig

Créer un alias

La commande git config crée un alias en une ligne :

git config --global alias.st status

Désormais, git st est équivalent à git status.

Le --global enregistre l'alias dans votre fichier ~/.gitconfig, disponible dans tous vos projets. Sans --global, l'alias n'existe que dans le dépôt courant.

Les alias essentiels

Si vous ne deviez en retenir que cinq, copiez ceux-ci dans ~/.gitconfig (sous la section [alias]) :

[alias]
    st = status
    sw = switch
    lg = log --oneline --graph --all --decorate
    ds = diff --staged
    last = log -1 HEAD --stat

Ces alias couvrent 90 % du workflow quotidien :

# Navigation rapide
git config --global alias.st "status"
git config --global alias.co "checkout"
git config --global alias.sw "switch"
git config --global alias.br "branch"

# Commits
git config --global alias.ci "commit"
git config --global alias.ca "commit --amend --no-edit"
git config --global alias.cm "commit -m"

# Historique
git config --global alias.lg "log --oneline --graph --all --decorate"
git config --global alias.ll "log --oneline -15"
git config --global alias.last "log -1 HEAD --stat"

# Diff
git config --global alias.df "diff"
git config --global alias.ds "diff --staged"

# Stash
git config --global alias.ss "stash"
git config --global alias.sp "stash pop"

Résultat dans `~/.gitconfig`

Si vous ouvrez votre fichier ~/.gitconfig, vous verrez une section [alias] :

[alias]
    st = status
    co = checkout
    sw = switch
    br = branch
    ci = commit
    ca = commit --amend --no-edit
    cm = commit -m
    lg = log --oneline --graph --all --decorate
    ll = log --oneline -15
    last = log -1 HEAD --stat
    df = diff
    ds = diff --staged
    ss = stash
    sp = stash pop

Vous pouvez éditer ~/.gitconfig avec votre éditeur de texte au lieu d'utiliser git config. C'est souvent plus rapide pour ajouter plusieurs alias d'un coup.

git config --global --edit

Alias avec des commandes shell

En préfixant avec !, vous pouvez exécuter n'importe quelle commande shell :

git config --global alias.aliases "! git config --get-regexp alias | sed 's/alias\.\([^ ]*\)/\1\t=/' | sort"

git aliases affiche maintenant la liste de tous vos alias, triée par ordre alphabétique.

Autres exemples utiles :

# Ouvrir le dépôt distant dans le navigateur
git config --global alias.open "! git remote get-url origin | xargs xdg-open"

# Nombre de commits par auteur
git config --global alias.who "! git shortlog -sn --no-merges"

# Branches triées par dernier commit
git config --global alias.recent "! git branch --sort=-committerdate --format='%(committerdate:relative)%09%(refname:short)'"

Lister et supprimer des alias

Lister tous les alias

git config --global --get-regexp alias

Supprimer un alias

git config --global --unset alias.st

Alias vs aliases shell (zsh/bash)

Vous pouvez aussi créer des alias dans votre shell (.bashrc, .zshrc). Quelle approche choisir ?

Critère	Alias Git (`git config`)	Alias shell (`~/.zshrc`)
Préfixe `git`	Toujours requis (`git lg`)	Optionnel (`glog`)
Portabilité	Fonctionne partout (fichier `.gitconfig`)	Dépend du shell
Auto-complétion	Fonctionne nativement	Configuration supplémentaire
Commandes non-git	Impossible (sauf `!`)	Oui

La recommandation : utilisez les alias Git pour les commandes Git (auto-complétion garantie) et les alias shell pour les raccourcis très courts ou les commandes combinées.

Exemples d'alias shell courants (zsh)

# Dans ~/.zshrc
alias g="git"
alias gst="git status"
alias gco="git checkout"
alias gcm="git commit -m"
alias gp="git push"
alias gl="git pull"

Si vous utilisez Oh My Zsh, le plugin git fournit plus de 150 alias prédéfinis. Activez-le dans votre .zshrc :

plugins=(git)

Tapez alias | grep git pour voir la liste complète.

Dépannage : problèmes courants

Symptôme	Cause probable	Solution
`git: 'lg' is not a git command`	Alias non enregistré	Vérifiez avec `git config --global alias.lg`
L'alias avec `!` ne fonctionne pas	Guillemets mal échappés	Éditez `~/.gitconfig` directement
Auto-complétion ne fonctionne pas sur un alias	Alias shell, pas Git	Convertissez en alias Git pour l'auto-complétion

À retenir

git config --global alias.xx "commande" crée un raccourci réutilisable partout
Les alias essentiels : st, co, br, ci, lg, ds, last
Le préfixe ! permet d'exécuter des commandes shell dans un alias
Les alias Git gardent l'auto-complétion native
Éditez directement ~/.gitconfig pour aller plus vite

Prochaines étapes

Les branches Git en bref Passez au Module 3 : le cœur de Git.

Tags et versions Marqueur vos releases avec les tags Git.

Consulter l'historique Maîtrisez git log avant de créer des alias dessus.