Introduction

La plupart des gens apprennent Git à la dure, à travers de petits désastres. Cette page rassemble les erreurs de débutant les plus fréquentes et comment les éviter (ou s'en remettre). Lisez-la une fois maintenant et de nouveau après un mois d'utilisation ; la deuxième lecture aura plus de sens.

Commiter avec la mauvaise identité

Oublier de définir user.email par dépôt expose des adresses personnelles dans les commits professionnels. Définissez toujours une identité par dépôt dans les clones de travail :

Introduction

Git est livré avec une documentation intégrée extensive. Savoir l'invoquer rapidement vous épargnera des heures de tâtonnement. Cette page parcourt le système d'aide depuis les one-liners jusqu'aux manuels complets.

Trois façons de demander

Chaque commande supporte trois formes d'aide :

git help <command>     # page man complète dans votre pager
git <command> --help    # même chose
git <command> -h        # résumé court d'utilisation

Exemple :

Introduction

Un fichier .gitignore liste les motifs que Git doit traiter comme non suivis et ne jamais proposer d'ajouter. Il garde les artefacts de build, les secrets, les métadonnées de l'OS et les fichiers temporaires d'éditeur hors de votre dépôt.

Introduction

git log parcourt le graphe de commits depuis un point de départ (par défaut : HEAD) en remontant les parents, et affiche chaque commit. C'est l'outil principal pour explorer l'historique du projet.

Utilisation de base

git log
git log --oneline
git log --oneline --graph --decorate --all

La dernière forme est la vue couteau-suisse : un graphe compact de chaque branche avec les refs décorées.

Introduction

L'index, aussi appelé staging area ou cache, est l'une des caractéristiques distinctives de Git. C'est un fichier binaire situé à .git/index qui contient l'arbre que vous comptez commiter ensuite. Comprendre l'index dissipe l'essentiel du mystère de la sortie de git status.

Introduction

Presque chaque session Git suit le même rythme en trois étapes : éditer les fichiers dans votre arborescence de travail, stager les changements que vous voulez enregistrer et les commiter dans l'historique. Maîtriser cette boucle est la base de tout le reste.

Introduction

git init transforme un répertoire ordinaire en dépôt Git. Il crée un répertoire caché .git contenant toute la comptabilité de Git : objets, refs, configuration et hooks. L'arborescence de travail (vos fichiers normaux) est inchangée.

Initialiser un projet

mkdir my-project
cd my-project
git init
# Initialized empty Git repository in /home/ada/my-project/.git/

Depuis Git 2.28, vous pouvez définir le nom de la branche initiale en ligne de commande :

Introduction

Avant votre premier commit, Git doit savoir qui vous êtes. git config stocke des paires clé-valeur dans trois portées : system (tous les utilisateurs), global (votre compte utilisateur) et local (un dépôt unique). La portée globale est dans ~/.gitconfig sous Unix et %USERPROFILE%\.gitconfig sous Windows.

Identité

Définissez votre nom et votre adresse e-mail ; ils sont gravés dans chaque commit que vous faites :

Introduction

Installer Git est simple sur toutes les plateformes majeures. Cette page parcourt la méthode d'installation recommandée pour Linux, macOS et Windows, et montre comment vérifier l'installation.

Linux

La plupart des distributions Linux fournissent Git dans leurs dépôts de paquets par défaut. Utilisez votre gestionnaire de paquets :

Introduction

Git est un système de contrôle de version distribué créé à l'origine par Linus Torvalds en 2005 pour le développement du noyau Linux. Il suit l'évolution des fichiers dans le temps, permet à plusieurs personnes de collaborer et donne à chaque développeur une copie complète de l'historique du projet. Aujourd'hui, Git propulse la majorité du développement logiciel open source et en entreprise.