Recherche de commandes Git

Comment fonctionne la référence des commandes Git

Ce que fait l’outil

La référence des commandes Git fournit un répertoire consultable et catégorisé des commandes git courantes, organisé par workflow : annulation de modifications, branches, stash, rebase, tags, opérations distantes, et plus encore. Chaque entrée affiche la syntaxe de la commande, une brève explication de ce qu’elle fait et des notes d’utilisation pratiques. La recherche filtre les entrées en temps réel au fur et à mesure de votre saisie, afin que vous puissiez trouver la bonne incantation sans parcourir des pages de man.

Cas d’usage courants pour les développeurs

Les développeurs utilisent cette référence lorsqu’ils savent ce qu’ils veulent accomplir (p. ex., annuler le dernier commit tout en gardant les modifications indexées) mais ne se souviennent plus des options ou de la commande exacte. Elle est particulièrement utile pour des opérations moins fréquentes comme le rebase interactif, le cherry-pick de plages, la récupération de branches supprimées via le reflog, ou la configuration de sparse checkouts. Les développeurs juniors l’utilisent comme aide à l’apprentissage pour découvrir des commandes dont ils ignoraient l’existence.

Formats de données, types ou variantes

Les commandes sont organisées en catégories logiques : opérations de base (add, commit, push, pull), branches et fusion, annulation de modifications (reset, revert, checkout), stash, rebase, tags, gestion des remotes, journal et inspection, et opérations avancées (bisect, worktree, submodule). Chaque entrée inclut le modèle de commande avec des arguments fictifs, une description en une ligne et les options pertinentes avec leurs effets.

Pièges courants et cas limites

Les commandes Git peuvent avoir des effets destructeurs difficiles à annuler — des commandes comme 'git reset --hard' et 'git clean -fd' suppriment définitivement le travail non enregistré dans le reflog. La référence présente des schémas d’utilisation courants, mais le comportement de git peut varier selon la configuration (merge.ff, pull.rebase) et la version de git. Certaines commandes se comportent différemment avec et sans le séparateur '--', notamment lorsque des noms de fichiers entrent en collision avec des noms de branches.

Quand utiliser cet outil plutôt que du code

Utilisez cette référence pour retrouver rapidement une commande pendant le développement au quotidien, en particulier pour des opérations que vous effectuez rarement. Pour des workflows git complexes en production (releases automatisées, gestion de merge queue, opérations sur monorepo), utilisez des outils dédiés comme des alias git, des hooks Husky ou des scripts CI qui encodent la stratégie de branches propre à votre équipe et réduisent le risque d’erreur humaine.