Bienvenue dans le monde de Git ! 🚀

Que tu développes seul ou en équipe, Git est un outil indispensable. Il te permet de suivre l'évolution de ton code, revenir en arrière en cas d'erreur, collaborer efficacement et publier tes projets sur GitHub.

---

Pourquoi apprendre Git ?

Git est un système de gestion de versions (Version Control System).

Grâce à lui, tu peux :

• 📂 Sauvegarder ton code à chaque étape
• ⏪ Revenir à une version précédente
• 👥 Collaborer avec plusieurs développeurs
• 🌿 Travailler sur plusieurs fonctionnalités en parallèle
• ☁️ Synchroniser ton projet avec GitHub

Aujourd'hui, Git est devenu un standard dans le développement logiciel.

---

🧠 Les 3 zones de Git

Avant d'utiliser Git, il est important de comprendre son fonctionnement.

Fichiers
    │
    ▼
Working Directory
    │ git add
    ▼
Staging Area
    │ git commit
    ▼
Historique Git
    │ git push
    ▼
GitHub

Chaque commande déplace tes modifications d'une étape à l'autre.

---

📂 Cloner un dépôt

Pour récupérer un projet existant :

git clone [email protected]:Utilisateur/Projet.git

Exemple

git clone [email protected]:KoS-aka-NiX/NovaStream.git

Puis :

cd NovaStream

---

📄 Vérifier l'état du dépôt

La commande que tu utiliseras probablement le plus :

git status

Elle affiche :

• les fichiers modifiés
• les nouveaux fichiers
• les fichiers supprimés
• les fichiers déjà ajoutés au prochain commit

---

👀 Voir les différences

Pour afficher les modifications :

git diff

Si le résultat est très long :

git diff | cat

---

➕ Ajouter des fichiers

Ajouter un seul fichier :

git add fichier.py

Ajouter tous les fichiers :

git add .

Les fichiers sont alors placés dans la Staging Area.

---

💾 Créer un commit

Une fois les modifications prêtes :

git commit -m "Ajout du système de connexion"

Quelques exemples de bons messages :

Fix login bug
Ajout authentification Discord
Correction CSS navbar
Ajout documentation

💡 Un bon commit décrit clairement ce qui a été réalisé.

---

🚀 Envoyer les modifications sur GitHub

git push

Cette commande envoie tous les commits locaux vers le dépôt distant.

---

🔄 Récupérer les dernières modifications

Avant de commencer une nouvelle session de développement :

git pull

Toujours récupérer les dernières modifications avant de coder évite de nombreux conflits.

---

🌿 Voir les branches

git branch

Exemple :

* main
develop
feat/login

L'astérisque indique la branche actuellement utilisée.

---

🌱 Créer une nouvelle branche

Ancienne méthode :

git checkout -b feat/nouvelle-fonction

Nouvelle méthode recommandée :

git switch -c feat/nouvelle-fonction

---

🔀 Changer de branche

Ancienne commande :

git checkout main

Nouvelle commande :

git switch main

---

📥 Récupérer les branches distantes

git fetch

Cette commande met à jour les informations provenant du dépôt distant sans modifier ta branche actuelle.

---

📜 Consulter l'historique

Historique simple :

git log

Historique plus lisible :

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

Cette vue permet de mieux comprendre l'évolution du projet.

---

🗑 Annuler des modifications locales

Annuler un fichier :

git restore fichier.py

Annuler toutes les modifications :

git restore .

⚠️ Les modifications seront définitivement perdues.

---

❌ Retirer un fichier du staging

git restore --staged fichier.py

Pratique lorsqu'un fichier a été ajouté par erreur.

---

📁 Supprimer un fichier

git rm fichier.py

Puis :

git commit -m "Suppression fichier inutile"

---

🏷 Vérifier les remotes

git remote -v

Exemple :

origin [email protected]:KoS-aka-NiX/Projet.git

---

🔑 Tester sa clé SSH

ssh -T [email protected]

Réponse attendue :

Hi votre_pseudo!
You've successfully authenticated...

---

⚙ Configurer Git

Nom :

git config --global user.name "Slayzi"

Email :

git config --global user.email "[email protected]"

Afficher la configuration :

git config --global --list

---

🧹 Ignorer certains fichiers

Créer un fichier .gitignore.

Exemple :

.env
node_modules/
__pycache__/
*.log
.vscode/
.idea/

Ces fichiers ne seront jamais envoyés sur GitHub.

---

🏗 Workflow recommandé

git pull
    ↓
Coder
    ↓
git status
    ↓
git diff
    ↓
git add .
    ↓
git commit -m "Description"
    ↓
git push

En suivant toujours cet ordre, tu limites les erreurs et les conflits.

---

🛠 Les commandes du quotidien

git status
git diff
git add .
git commit -m "Message"
git push
git pull

Ce sont les commandes que tu utiliseras presque tous les jours.

---

🚨 Résoudre un conflit Git

Pas de panique.

Commence par :

git status

Ouvre ensuite les fichiers concernés.

Tu verras des marqueurs comme :

<<<<<<< HEAD

=======

>>>>>>>

Choisis le bon contenu, puis termine avec :

git add .

git commit

git push

---

⭐ Récapitulatif rapide

git status
git diff | cat
git add .
git commit -m "Message"
git push

---

🧠 Les bonnes habitudes

✅ Toujours faire un git pull avant de commencer.

✅ Faire des commits petits et fréquents.

✅ Écrire des messages de commit explicites.

✅ Utiliser une branche par fonctionnalité (feat/...).

✅ Vérifier git status avant chaque commit.

❌ Ne jamais envoyer :

• mots de passe
• clés SSH
• fichiers .env
• données sensibles

❌ Éviter de développer directement sur main si le projet utilise des branches de développement.

---

💡 La philosophie KoS Labs

Commit souvent. Commit proprement.

Un commit raconte une histoire.

Dans six mois, quelqu'un doit pouvoir comprendre l'évolution du projet simplement en lisant l'historique Git.

Avant chaque git push, pose-toi toujours ces trois questions :

• ✔️ Est-ce que mon projet compile ?
• ✔️ Est-ce que j'ai testé mes modifications ?
• ✔️ Mon message de commit décrit-il réellement ce que j'ai changé ?

Prendre ces bonnes habitudes dès le début te fera gagner un temps précieux et facilitera la collaboration sur tous tes projets.

---

Conclusion

Git est bien plus qu'un simple outil de sauvegarde : c'est la colonne vertébrale de tout projet de développement moderne.

En maîtrisant les commandes essentielles présentées dans ce guide et en adoptant de bonnes pratiques, tu seras capable de travailler plus sereinement, de collaborer efficacement et de maintenir un historique clair de ton code.

Que tu développes un projet personnel ou une application professionnelle, des commits fréquents, des branches bien organisées et un workflow rigoureux feront toute la différence.

Bon code ! 🚀