Sommaire > Chapitre 4 > Chapitre 5
5

Premiers pas avec Git en local

🎯 Objectifs de ce chapitre

À la fin de ce chapitre, tu seras capable de :

Rappel important

Git fonctionne sur ton ordinateur, GitHub est en ligne. Dans ce chapitre, nous travaillons uniquement en local !

📥 Cloner un dépôt existant

Récupère l'URL de ton dépôt

Va sur la page de ton repository GitHub (celui créé au chapitre 4) et clique sur le bouton vert "Code". Copie l'URL HTTPS.

https://github.com/ton-username/mon-premier-projet.git

Ouvre ton terminal

Ouvre le terminal sur ton ordinateur et navigue vers le dossier où tu veux stocker ton projet :

# Va dans ton dossier Documents ou Bureau
cd ~/Documents
# Ou crée un dossier spécial pour tes projets
mkdir projets
cd projets

Clone le dépôt

Utilise la commande git clone avec l'URL que tu as copiée :

git clone https://github.com/ton-username/mon-premier-projet.git
Explication : Cette commande crée une copie complète du dépôt GitHub sur ton ordinateur.

Entre ensuite dans le dossier créé :

cd mon-premier-projet

Vérifie que ça a fonctionné

Utilise ls (Linux/macOS) ou dir (Windows) pour voir les fichiers :

ls -la

Tu devrais voir le fichier README.md et le dossier caché .git.

Le dossier .git

Ce dossier caché contient toute l'histoire de ton projet et la configuration Git. Ne le supprime jamais !

🔄 Comprendre le workflow Git

Git fonctionne avec trois zones principales. Visualisons ce concept :

📝 Working Directory

Ton dossier de travail

Où tu modifies tes fichiers normalement

État : Modifié / Non suivi

📦 Staging Area

Zone de préparation

Fichiers prêts à être commités

État : Préparé / Indexé

💾 Repository

Dépôt Git

Historique permanent des commits

État : Commité / Sauvegardé

Le flux de travail visuel

1

Tu modifies des fichiers

Dans ton éditeur de code, tu crées ou modifies des fichiers

Zone : Working Directory

↓
2

Tu ajoutes les fichiers à l'index

git add nom_du_fichier

Zone : Staging Area

↓
3

Tu crées un commit

git commit -m "message"

Zone : Repository

Analogie concrète

Pense à Git comme à la préparation d'un colis :

  • 📝 Working Directory = Tes affaires éparpillées dans ta chambre
  • 📦 Staging Area = Les objets que tu mets dans le carton
  • 💾 Repository = Le colis scellé et étiqueté

🔍 Surveiller l'état avec git status

La commande git status est ton meilleur ami ! Elle te montre ce qui se passe dans ton dépôt.

Teste git status

Dans ton dossier de projet, tape :

git status

Tu devrais voir quelque chose comme :

Sur la branche main
Votre branche est à jour avec 'origin/main'.

rien à valider, la copie de travail est propre

Crée un nouveau fichier

Crée un fichier bonjour.txt dans ton dossier :

echo "Bonjour le monde !" > bonjour.txt

Ou crée-le manuellement avec ton éditeur de texte.

Vérifie à nouveau git status

git status

Maintenant tu devrais voir :

Sur la branche main
Fichiers non suivis:
  (utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)
        bonjour.txt

rien ajouté à la validation mais des fichiers non suivis sont présents
(utilisez "git add" pour les suivre)
Explication : Git te dit qu'il y a un nouveau fichier qu'il ne suit pas encore.

Utilise git status souvent !

Cette commande est tellement utile que la plupart des développeurs la tapent toutes les 2-3 minutes. Elle évite les mauvaises surprises.

📝 Tes premiers commits

Maintenant, passons à l'action avec le cycle add → commit !

Ajoute le fichier à l'index

Utilise git add pour préparer ton fichier :

git add bonjour.txt
Explication : Cette commande déplace le fichier de la Working Directory vers la Staging Area.

Vérifie avec git status :

Sur la branche main
Modifications qui seront validées :
  (utilisez "git restore --staged <fichier>..." pour désindexer)
        nouveau fichier: bonjour.txt

Crée ton premier commit

Maintenant, crée le commit avec un message clair :

git commit -m "Ajoute un fichier de bienvenue"
Explication : Cette commande prend tous les fichiers de la Staging Area et crée un point de sauvegarde permanent dans l'historique.

Tu devrais voir une confirmation comme :

[main 1a2b3c4] Ajoute un fichier de bienvenue
 1 file changed, 1 insertion(+)
 create mode 100644 bonjour.txt

Vérifie l'historique

Regarde ton premier commit dans l'historique :

git log

Tu devrais voir quelque chose comme :

commit 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t
Auteur: Ton Nom <ton@email.com>
Date:   Jeu. 25 jan. 2024 10:30:00 +0100

    Ajoute un fichier de bienvenue

Messages de commit clairs

Toujours écrire des messages de commit qui expliquent POURQUOI tu as fait ces changements, pas seulement quoi. C'est crucial pour toi plus tard !

🎯 Pratique guidée

Prenons 5 minutes pour pratiquer ensemble :

Étape 1 : Modifie le README

Ouvre README.md dans ton éditeur et ajoute une ligne :

# Mon Premier Projet

Ceci est mon premier projet sur GitHub !
J'apprends à utiliser Git et c'est générique.

Étape 2 : Vérifie l'état

git status

Tu devrais voir que README.md est modifié.

Étape 3 : Ajoute le fichier modifié

git add README.md

Étape 4 : Commit avec un bon message

git commit -m "Améliore la documentation du projet"

Étape 5 : Vérifie l'historique

git log --oneline

Tu devrais maintenant voir 2 commits !

🎉 Félicitations !

Tu viens de maîtriser le workflow de base de Git : status → add → commit. C'est 80% de ce que tu feras quotidiennement avec Git !

✅ Résumé du chapitre

Ce que tu as accompli

  • ✅ Cloné un dépôt GitHub sur ton ordinateur
  • ✅ Compris les 3 zones Git (Working, Staging, Repository)
  • ✅ Utilisé git status pour surveiller ton dépôt
  • ✅ Ajouté des fichiers avec git add
  • ✅ Créé tes premiers commits avec git commit
  • ✅ Consulté l'historique avec git log
  • ✅ Pratiqué le workflow complet plusieurs fois

Excellent travail ! Tu maîtrises maintenant les bases essentielles de Git en local. Dans le prochain chapitre, nous allons connecter ton dépôt local à GitHub et apprendre à envoyer tes commits.

Pour t'entraîner

Crée quelques fichiers supplémentaires dans ton projet et fais 2-3 commits de plus. Plus tu pratiques, plus ça deviendra naturel !