Guide pratique : Git et GitHub pour débutants

Git et GitHub : comprendre la différence

Installer Git

# Windows : téléchargez git-scm.com puis vérifiez
git --version

# Configurer votre identité (une seule fois)
git config --global user.name "Mamadou Diallo"
git config --global user.email "mamadou@email.com"

Les 10 commandes essentielles

1. Initialiser un projet

# Créer un nouveau dépôt Git dans un dossier
mkdir mon-projet
cd mon-projet
git init
# Résultat : un dossier caché .git est créé

2. Voir l’état des fichiers

git status
# Rouge = fichiers modifiés non suivis
# Vert = fichiers prêts à être committé

3. Ajouter des fichiers au suivi

# Ajouter un fichier spécifique
git add index.html

# Ajouter tous les fichiers modifiés
git add .

# Ajouter tous les fichiers d'un type
git add *.css

4. Créer un commit (point de sauvegarde)

git commit -m "Ajout de la page d'accueil"

# Bonnes pratiques pour les messages :
# ✅ "Ajout du formulaire de contact"
# ✅ "Correction du bug d'affichage mobile"
# ❌ "mise à jour"
# ❌ "fix"

5. Voir l’historique

# Historique complet
git log

# Historique compact (1 ligne par commit)
git log --oneline

# Historique avec graphe des branches
git log --oneline --graph --all

6. Créer et changer de branche

# Créer une nouvelle branche
git branch nouvelle-fonctionnalite

# Changer de branche
git checkout nouvelle-fonctionnalite

# Créer ET changer en une commande
git checkout -b correction-bug

# Voir toutes les branches
git branch

7. Fusionner des branches

# Retourner sur main
git checkout main

# Fusionner la branche dans main
git merge nouvelle-fonctionnalite

# Supprimer la branche fusionnée
git branch -d nouvelle-fonctionnalite

8. Connecter à GitHub

# Ajouter le dépôt distant (remote)
git remote add origin https://github.com/votrenom/mon-projet.git

# Envoyer votre code sur GitHub
git push -u origin main

# Les prochaines fois, juste :
git push

9. Récupérer du code depuis GitHub

# Cloner un dépôt existant
git clone https://github.com/votrenom/mon-projet.git

# Récupérer les dernières modifications
git pull

10. Le fichier .gitignore

# Créez un fichier .gitignore pour exclure des fichiers
node_modules/
.env
*.log
.DS_Store
.vscode/
dist/

Workflow quotidien typique

# 1. Récupérer les dernières modifications
git pull

# 2. Créer une branche pour votre travail
git checkout -b ajout-page-contact

# 3. Coder... puis sauvegarder
git add .
git commit -m "Ajout du formulaire de contact avec validation"

# 4. Pousser sur GitHub
git push -u origin ajout-page-contact

# 5. Créer une Pull Request sur GitHub
# 6. Après validation, fusionner dans main

Résoudre un conflit de fusion

# Quand Git ne sait pas quelle version garder :
<<<<<<< HEAD
<h1>Bienvenue sur mon site</h1>     ← Votre version
=======
<h1>Bienvenue chez ITSkillsCenter</h1>  ← L'autre version
>>>>>>> branche-collegue

# Solution : choisissez la bonne version, supprimez les marqueurs
<h1>Bienvenue chez ITSkillsCenter</h1>

# Puis commitez la résolution
git add .
git commit -m "Résolution du conflit sur le titre"

Aide-mémoire rapide

Exercice pratique