Git Manuel de référence conçu par Claude.ai pour NetDTL

Permet de lire et d'écrire les variables de configuration qui contrôlent tous les aspects du comportement de Git. Les variables peuvent être stockées à trois niveaux distincts et hiérarchiques : système, utilisateur global et dépôt local. Chaque niveau surcharge le précédent. Les variables définies sans niveau explicite sont écrites dans le fichier local .git/config.

Affiche la page de manuel (man page) de la commande Git spécifiée. Disponible hors connexion. Chaque commande Git accepte aussi l'option --help pour obtenir le même résultat, et l'option -h pour un résumé court des options disponibles.

Crée un nouveau dépôt Git en initialisant le sous-répertoire .git dans le répertoire courant ou dans le répertoire spécifié. Ce répertoire contient tous les objets, références et métadonnées du dépôt. Si aucun fichier n'est présent, la copie de travail est vide et aucun commit n'existe encore.

Récupère une copie complète d'un dépôt Git existant, y compris l'intégralité de son historique. Le dépôt distant est automatiquement enregistré sous le nom court origin. Une branche de suivi locale est créée pour chaque branche distante, et la branche principale est extraite dans la copie de travail. Les protocoles supportés incluent https://, ssh://, git:// et les chemins locaux.

Place des modifications dans la zone d'index (staging area) pour les inclure dans le prochain commit. Son effet s'approche de « ajouter ce contenu pour la prochaine validation » plutôt que d'un simple ajout au projet. Elle sert à la fois à placer de nouveaux fichiers sous suivi de version, à indexer des fichiers modifiés, et à marquer des conflits de fusion comme résolus. Si un répertoire est spécifié, la commande indexe récursivement tous les fichiers qu'il contient.

Affiche l'état de la copie de travail et de la zone d'index par rapport au dernier commit. Identifie les fichiers modifiés, indexés ou non suivis, et rappelle les commandes permettant d'agir sur chaque catégorie. Indique également la branche courante et son avance ou son retard par rapport à la branche distante suivie.

Affiche les différences ligne par ligne (patch) entre différents états du dépôt. Sans argument, compare la copie de travail avec l'index (modifications non indexées). Avec --staged ou --cached, compare l'index avec le dernier commit (modifications indexées qui feront partie du prochain commit). Peut aussi comparer deux commits arbitraires ou un commit avec la copie de travail.

Enregistre l'état actuel de l'index sous forme d'un nouvel objet commit dans le dépôt local. Chaque commit contient un instantané du contenu indexé, les métadonnées de l'auteur et du validateur, la date, le message de validation, et un pointeur vers le ou les commits parents. Sans option de message, ouvre l'éditeur configuré pour la saisie du message.

Supprime des fichiers de l'index et de la copie de travail en une seule opération, en enregistrant la suppression pour le prochain commit. Contrairement à une simple suppression système, la suppression est indexée et sera incluse dans la prochaine validation.

Renomme ou déplace un fichier et indexe cette modification pour le prochain commit. Équivalent à exécuter mv, git rm et git add en séquence. Git détecte de toute façon les renommages de façon implicite ; cette commande simplifie simplement l'opération en une étape.

Affiche l'historique des commits du dépôt en ordre chronologique inverse. Pour chaque commit, indique la somme de contrôle SHA-1, le nom et l'e-mail de l'auteur, la date et le message de validation. Offre de très nombreuses options de filtrage et de formatage de sortie.

Affiche les informations détaillées d'un objet Git : commit (métadonnées et diff), tag annoté (informations du créateur et du commit associé), arbre ou blob. Sans argument, montre le dernier commit de la branche courante.

Introduit à partir de Git 2.25, commande dédiée à la réinitialisation des fichiers. Sans option, réinitialise un fichier dans la copie de travail à son état du dernier commit, en écrasant les modifications locales non indexées. Avec --staged, désindexe un fichier (le retire de la zone d'index) sans toucher à la copie de travail.

Commande polyvalente permettant de déplacer le pointeur HEAD et/ou de modifier l'état de l'index et de la copie de travail. Avec un chemin de fichier, désindexe le fichier spécifié (équivalent à git restore --staged). Avec un commit comme cible, repositionne HEAD et agit selon le mode choisi sur l'index et la copie de travail. Elle est le fondement des opérations d'annulation et de réécriture d'historique dans Git.

Crée un nouveau commit qui inverse exactement les modifications introduites par le commit spécifié. Contrairement à git reset, ne réécrit pas l'historique : le commit annulé reste dans le graphe. Méthode sûre pour annuler des commits déjà partagés sur un dépôt public.

Commande de gestion des branches locales. Sans argument, liste les branches locales en marquant la branche courante d'un astérisque. Une branche Git est simplement un pointeur léger sur un commit ; les créer et les supprimer ne coûte quasiment rien.

Commande historique à double usage : bascule sur une branche existante (déplace HEAD et met à jour la copie de travail) ou restaure des fichiers de la copie de travail. Depuis Git 2.23, ses deux fonctions sont mieux séparées par git switch et git restore. Lors du basculement de branche, Git réinitialise la copie de travail à l'état du dernier commit de la branche cible.

Introduit dans Git 2.23 pour séparer clairement la fonction de basculement de branche de la restauration de fichiers. Permet de changer de branche, d'en créer une nouvelle et d'y basculer, ou de revenir à la branche précédemment extraite.

Intègre l'historique et les modifications d'une branche dans la branche courante. Si la branche cible est un ancêtre direct de la branche à fusionner, Git effectue une avance rapide (fast-forward) en déplaçant simplement le pointeur. Sinon, Git réalise une fusion à trois sources en créant un nouveau commit de fusion avec deux parents. En cas de conflit, la fusion est interrompue et les fichiers conflictuels sont marqués pour résolution manuelle.

Lance un outil graphique de résolution de conflits de fusion. Git détecte et propose les outils disponibles sur le système (opendiff, kdiff3, vimdiff, emerge, etc.). Après résolution de chaque conflit dans l'outil, le fichier est marqué comme résolu dans l'index.

Rejoue les commits d'une branche sur une nouvelle base, produisant un historique linéaire. Identifie l'ancêtre commun entre la branche courante et la cible, extrait les diffs de chaque commit, réinitialise la branche sur la cible, puis réapplique chaque diff dans l'ordre. Contrairement à la fusion, ne crée pas de commit de fusion ; l'historique résultant est plus lisible mais réécrit les identifiants SHA-1.

Gère les références vers les dépôts distants (noms courts et URL associées). Sans argument, liste les noms courts des dépôts distants enregistrés. Les dépôts distants sont des versions de votre projet hébergées ailleurs (internet, réseau local ou même chemin local).

Récupère depuis le dépôt distant toutes les nouvelles données (commits, branches, tags) qui ne sont pas encore présentes localement. Met à jour uniquement les branches de suivi à distance (ex. origin/master), sans toucher aux branches locales ni à la copie de travail. La fusion des données distantes dans le travail local doit être effectuée manuellement avec git merge.

Combine git fetch suivi immédiatement de git merge (ou git rebase selon la configuration). Récupère les modifications distantes depuis la branche de suivi configurée et les intègre dans la branche locale courante. Si la variable pull.rebase est définie à true, effectue un rebasage au lieu d'une fusion.

Transfère les commits de la branche locale vers le dépôt distant spécifié. La poussée est refusée si l'historique distant a divergé (quelqu'un a poussé entre-temps) : il faut d'abord récupérer et fusionner les modifications distantes. Les étiquettes ne sont pas poussées automatiquement ; elles doivent être spécifiées explicitement.

Crée, liste ou supprime des étiquettes (tags) pour marquer des points importants de l'historique (versions publiées, jalons). Git distingue deux types d'étiquettes : légères (simple pointeur sur un commit) et annotées (objets à part entière avec métadonnées, message et possibilité de signature GPG). Les étiquettes annotées sont recommandées pour les publications officielles. Les étiquettes ne sont pas poussées automatiquement avec git push.

Sauvegarde temporairement les modifications de la copie de travail et de l'index dans une pile, sans créer de commit. La copie de travail est ramenée à l'état du dernier commit, permettant de changer de contexte sans valider un travail inachevé. Les remisages peuvent être réappliqués ultérieurement, y compris sur d'autres branches.

Recherche un motif (expression régulière ou littéral) dans les fichiers du dépôt, avec la possibilité de cibler un commit ou une arborescence particulière plutôt que la copie de travail. Plus rapide que grep classique sur les grands dépôts car il n'examine que les fichiers suivis.

Outil de recherche binaire dans l'historique pour localiser le commit qui a introduit un bug. Git navigue automatiquement dans l'historique par dichotomie, réduisant la recherche à O(log n) commits à tester. Chaque commit est marqué comme bon ou mauvais jusqu'à isoler le premier commit défectueux. Peut être entièrement automatisé avec un script de test.

Affiche chaque ligne d'un fichier annoté du commit qui l'a introduite en dernier, ainsi que l'auteur et la date. Permet d'identifier rapidement qui a modifié une ligne de code particulière et dans quel commit.

Réécrit l'intégralité de l'historique en appliquant des filtres scriptés à chaque commit. Permet de supprimer un fichier de tout l'historique, de modifier les métadonnées d'auteur, de changer des messages de commit en masse, ou de découper un sous-répertoire en dépôt indépendant. Opération lente et irréversible ; préférer l'outil git-filter-repo pour les versions récentes.

Réapplique les modifications introduites par un ou plusieurs commits spécifiques sur la branche courante, en créant de nouveaux commits équivalents. Utile pour importer une correction de bug d'une branche vers une autre sans fusionner l'intégralité de la branche source.

« Reuse recorded resolution » : mémorise les résolutions de conflits de fusion déjà effectuées et les réapplique automatiquement lorsque le même conflit se reproduit. Particulièrement utile sur les branches thématiques qui sont régulièrement rebasées sur master. Doit être activé avec git config rerere.enabled true.

Gère les sous-modules : des dépôts Git imbriqués dans un dépôt parent, enregistrés à un commit spécifique. Permet d'inclure et de gérer des dépendances externes (bibliothèques, outils) tout en maintenant leurs historiques séparés. Le dépôt parent enregistre uniquement l'URL et le SHA-1 du commit utilisé pour chaque sous-module.

Exécute les tâches de maintenance du dépôt : compresse les objets isolés en fichiers groupés (packfiles), supprime les objets inaccessibles (orphelins, réfs supprimées), et optimise les structures internes de Git pour de meilleures performances. Git peut lancer cette commande automatiquement en arrière-plan.

Vérifie l'intégrité de la base de données d'objets Git et détecte les données corrompues ou les objets orphelins (dangling objects). Les objets orphelins sont des commits, arbres ou blobs non référencés par aucune branche ou étiquette ; ils peuvent représenter du travail perdu récupérable.

Empaquette des objets Git et des références dans un fichier binaire portable (bundle), permettant de transférer de l'historique Git via des médias sans connexion réseau (clé USB, pièce jointe courriel). Un bundle peut être utilisé comme un dépôt distant pour git fetch ou git clone.

Crée une référence de remplacement qui fait en sorte que Git traite un objet comme si c'était un autre, sans réécrire l'historique. Utile pour greffer des historiques distincts ou corriger des erreurs dans des commits anciens sans modifier les SHA-1. Les remplacements sont stockés dans refs/replace/.

Affiche le contenu d'un objet arbre Git (liste des fichiers et sous-répertoires avec leurs modes, types et SHA-1 associés). Commande de plomberie utilisée pour inspecter directement les objets internes du dépôt.

Affiche le contenu, le type ou la taille d'un objet Git (blob, arbre, commit, tag) identifié par son SHA-1 ou une référence symbolique. Commande fondamentale pour inspecter les objets internes du dépôt.

Calcule le SHA-1 d'un fichier selon le format d'objet Git et optionnellement le stocke dans la base d'objets. Commande de plomberie illustrant la manière dont Git génère les identifiants de ses objets.

Crée un objet arbre dans la base de données Git à partir du contenu actuel de l'index et retourne son SHA-1. Commande de plomberie utilisée dans les scripts bas niveau pour construire des commits manuellement.

Met à jour une référence Git (branche, tag ou toute refs/) pour pointer vers le SHA-1 spécifié. Méthode de plomberie sûre pour manipuler les références, préférable à l'édition directe des fichiers dans .git/refs/.

Affiche la liste complète des références (branches, tags, HEAD) d'un dépôt distant avec les SHA-1 correspondants, sans télécharger aucun objet. Commande de plomberie pour interroger l'état d'un dépôt distant sans fetch.