Premiers pas : dépôt, staging et commits

Qui n’a jamais eu un dossier rempli de rapport_v2.docx, rapport_final.docx, rapport_final_VRAI.docx ? Git résout ce problème : c’est un système de gestion de versions qui enregistre l’historique complet d’un projet. Vous pouvez revenir en arrière, comprendre qui a changé quoi et pourquoi, et travailler à plusieurs sans écraser le travail des autres. Git est aujourd’hui l’outil standard, du site vitrine aux projets de data science.

Configurer Git (une seule fois)

git --version                                   # vérifie l'installation
git config --global user.name "Léa Martin"
git config --global user.email "lea@example.com"
git config --global init.defaultBranch main     # nom de la branche initiale

Le nom et l’e-mail sont inscrits dans chaque commit : ils identifient l’auteur.

Créer un dépôt

mkdir mon-projet && cd mon-projet
git init            # crée le dépôt : un dossier caché .git qui contient tout l'historique
git status          # la commande à taper sans modération

Ne supprimez jamais le dossier .git : c’est lui qui contient l’historique.

Les trois zones

C’est la notion centrale de Git :

1. le répertoire de travail : vos fichiers tels que vous les modifiez ;
2. la zone de préparation (staging area ou index) : ce que vous avez choisi d’inclure dans le prochain enregistrement ;
3. l’historique : la suite des commits enregistrés.

 fichiers modifiés --git add--> zone de préparation --git commit--> historique

Un commit est un instantané du projet à un moment donné, accompagné d’un message, d’un auteur, d’une date et d’un identifiant unique (un hash comme a1b2c3d).

Le cycle de base

echo "# Mon projet" > README.md
git status                 # README.md apparaît en « Untracked files » (non suivi)
git add README.md          # on le place dans la zone de préparation
git status                 # il apparaît en « Changes to be committed »
git commit -m "Ajoute le README"   # on enregistre l'instantané

Puis, à chaque évolution :

# ... vous modifiez index.html et style.css ...
git status                 # fichiers « modified »
git add index.html style.css   # ou git add . pour tout le dossier courant
git commit -m "Ajoute la page d'accueil et sa mise en forme"

Pourquoi une étape intermédiaire ? Parce qu’elle permet de choisir : si vous avez corrigé un bug et commencé une nouvelle fonctionnalité, vous pouvez les enregistrer dans deux commits distincts. git add -p permet même de sélectionner des morceaux d’un fichier.

De bons commits

• Petits et cohérents : un commit = une modification logique.
• Bien nommés : un message court à l’impératif qui dit ce que fait le commit (« Corrige le calcul de la TVA »), pas « modifs » ou « wip ».
• Fréquents : committer souvent, c’est multiplier les points de retour possibles.

Prenez le réflexe git status avant chaque add et chaque commit : Git vous dit toujours où vous en êtes et suggère souvent la commande suivante.