Vue d’ensemble

02Comprendre un dépôt

Enregistrer un fichier, préparer un commit, créer un commit et partager ce commit sont quatre opérations différentes.

Git est local et distribué : un commit est créé sur votre machine avant d’être poussé vers GitHub. Un dépôt peut contenir du code, de la documentation, des configurations, des scripts, des sites ou certains assets — mais Git n’est pas idéal pour tous les fichiers.

03Inspecter, indexer, committer et pousser

Le cycle quotidien commence par une inspection : vous choisissez le contenu du prochain commit au lieu de tout envoyer par réflexe.

git init                         # or: git clone <url>
git status
git diff
git add src/app.js README.md
git diff --staged
git restore --staged README.md
git commit -m "Fix empty task rendering"
git log --oneline
git push

git init transforme un dossier existant en dépôt local. git clone crée une nouvelle copie locale d’un dépôt existant et configure généralement son distant origin.

git status

Résume les fichiers modifiés, indexés et non suivis.

git diff

Montre les changements non indexés ; --staged montre le contenu proposé pour le commit.

git add <path>

Place le contenu choisi dans la zone d’index.

git commit

Crée un point d’historique local précis et cohérent.

git push

Transfère des commits locaux vers le dépôt distant.

Un bon message de débutant est concis, spécifique et décrit une seule intention logique. Sauvegarder n’est pas committer ; committer n’est pas pousser.

04Fetch, pull et stash sans perdre son travail

Distinguez les informations du serveur, leur intégration dans votre branche et votre travail local inachevé.

git fetch
git status
git log --oneline --graph --decorate --all
git stash push -m "WIP: validation message"
git pull
git stash list
git stash pop

git fetch met à jour les références de suivi distant sans intégrer directement les changements dans la branche courante. git pull effectue un fetch puis une intégration, généralement une fusion sauf configuration ou option différente.

Le stash conserve temporairement des modifications locales. Ce n’est ni une sauvegarde, ni une fonction distante, ni un remplacement des commits. git stash apply garde l’entrée ; git stash pop tente de l’appliquer et la retire en cas de succès. Les fichiers non suivis exigent une option explicite.

1. Inspectez l’état courant.
2. Décidez si le travail mérite un commit ou un stash.
3. Fetch ou pull selon le besoin, puis inspectez à nouveau.
4. Réappliquez le travail temporaire et vérifiez le résultat.

05Les branches et leur emplacement

Une branche est un nom mobile qui pointe vers un commit. Ce n’est ni un dossier, ni une copie complète, ni automatiquement un objet publié.

git branch
git switch -c feature/login-message
# edit, stage, commit
git push -u origin feature/login-message
git switch main
git merge feature/login-message

Créer une branche locale ne la publie pas. Le premier push avec -u crée la branche distante et configure une relation de suivi pratique. origin/main n’est pas une vue réseau en direct : il reflète le dernier fetch connu.

06Résoudre un conflit de fusion

Un conflit signifie que Git ne peut pas choisir seul le contenu final. Il ne prouve pas qu’une personne s’est trompée.

<<<<<<< HEAD
const releaseChannel = "stable";
=======
const releaseChannel = "preview";
>>>>>>> feature/release-channel

1. Reproduisez le conflit et lisez git status.
2. Ouvrez le fichier dans l’éditeur de fusion de VS Code.
3. Comparez base, version courante, version entrante et résultat.
4. Écrivez volontairement le résultat final : un côté, l’autre, les deux ou une nouvelle combinaison.
5. Sauvegardez, indexez le fichier résolu, terminez le commit puis vérifiez l’application.

Si vous n’êtes pas prêt à poursuivre une fusion inachevée, git merge --abort restaure le point de départ quand Git peut le faire proprement. « Accepter les deux » n’est jamais une règle universelle.

07.gitignore et hygiène du dépôt

Le dépôt doit décrire le projet, pas accumuler les dépendances restaurables, les caches, les sorties de build ou les secrets locaux.

# Dependencies and reproducible output
node_modules/
dist/
build/
.cache/

# Local configuration and secrets
.env

# Keep the documented shape
!.env.example

.gitignore définit des chemins qui doivent rester non suivis. Il n’arrête pas rétroactivement le suivi d’un fichier déjà commité. Un secret commité doit être considéré comme exposé : retirez-le, faites-le tourner, puis traitez le nettoyage d’historique comme une réponse à incident distincte.

git status
git check-ignore -v .env

08Workflow complet et suite du parcours

Terminez un changement depuis un espace de travail sale jusqu’à une branche de fonctionnalité intégrée et synchronisée.

git status
git diff
git switch -c feature/clear-empty-state
git add src/empty-state.js tests/empty-state.test.js
git diff --staged
git commit -m "Clarify the empty task state"
git fetch
git push -u origin feature/clear-empty-state
# review, merge, verify, synchronise