Prédisez ce que contiendra votre prochain commit

• Distinguer l'arbre de travail, l'index et le dernier commit enregistré.
• Prévoyez ce que la mise en scène, l'édition et un commit normal changent.
• Lisez les deux colonnes de statut court sans supposer que la mise en scène signifie sauvegardée pour toujours.
• Utilisez des comparaisons distinctes pour les modifications non planifiées et planifiées.

Lisez d’abord la leçon 1 ; la leçon 2 prépare Git et votre identité de commit. Vous commencez avec no course repository et vous terminez sans : c'est une leçon conceptuelle. La première initialisation pratique est la leçon 4, à l'intérieur de GitTree.

Cette leçon présente quatre états que vous créerez vous-même dans la leçon 5. Les sorties du terminal ci-dessous et les écrans GitTree dans la vidéo proviennent d'une copie jetable du futur projet : les commandes et les écrans ont été enregistrés avec Git 2.52.0 et GitTree 2.0 sur Ubuntu 24.04. Ils n'ont pas été exécutés sur macOS. Chacune de ces scènes dans la vidéo est intitulée « Aperçu de la future leçon 5 ». N'exécutez pas les commandes de l'état futur dans un référentiel de travail non lié et n'initialisez pas un référentiel de pratique supplémentaire maintenant ; regardez et lisez l'aperçu, puis répétez les requêtes lorsque la leçon 5 atteint ces états.

Le minimum inspecté de GitTree est Git 2.39.0. Sur macOS, appuyez sur Commande où Windows et Linux utilisent Ctrl. Les commandes n'ont pas été exécutées sur Windows. Aucun fournisseur, compte, Pro ou essai n'est nécessaire pour le modèle local.

Votre working tree correspond aux fichiers du projet sur le disque. La modification et l'enregistrement d'un fichier modifient ces octets. Git ne les a pas nécessairement sélectionnés pour un commit.

Le index, également appelé staging area, décrit le prochain instantané que vous préparez. La mise en scène d'un fichier met à jour son entrée d'index à partir de son contenu actuel. Il ne s'agit pas d'un abonnement permanent aux modifications ultérieures.

Un commit enregistre un arbre ainsi que des métadonnées et des relations parentales. HEAD identifie votre position actuelle, généralement via la branche extraite. Avant le premier commit, HEAD peut nommer une branche à naître même si aucun commit de branche n'existe.

Une analogie utile est une ébauche de travail, une édition préparée et une édition enregistrée. Ne prenez pas l’analogie au pied de la lettre : la mise en scène ne déplace ni ne supprime le fichier de travail. Dans un chemin suivi normal, les trois versions peuvent s'accorder ou différer indépendamment.

Nous utilisons une validation normale de l'index préparé, without -a, des arguments de chemin explicites, une mise en scène ou une modification automatique. Les autres modes de validation ne sont pas interchangeables avec cet exemple. Référence d'ajout de Git explique le comportement de l'instantané lors de la mise en scène ; la référence diff distingue les comparaisons.

L'exemple futur exact

Le fichier est index.html. Son titre reste Understand every change. Sa ligne de support a deux versions :

<p id="hero-copy">A clear view of Git history.</p>

Modification de travail ultérieure :

<p id="hero-copy">Choose one change, then check what Git saved.</p>

Il s'agit d'extraits de lignes de la page originale complète et de la page entièrement modifiée du projet, et non de fichiers de remplacement à coller sur la page entière.

Le projet complet contient également un README. Les deux fichiers sont préparés avant la première validation ; les exemples de statut sont limités à index.html. En D, le README est propre et index.html conserve sa modification délibérée et non mise en scène.

Pour les lignes normales sans conflit ici, la première colonne du statut court compare l'index à HEAD ; la seconde compare l'arbre de travail à l'index. ?? est le marqueur spécial non suivi, et non deux colonnes de modification ordinaires. Un espace leader dans les domaines M.

Quels changements

• Stage: met à jour le contenu de l'index ; pas de validation ou de mouvement de branche, pas de réécriture du fichier de travail.
• Edit after staging: met à jour uniquement les octets de travail ; l'index préparé reste la version antérieure.
• Normal commit: enregistre l'instantané préparé et met à jour la branche locale actuelle. L'index reste cet instantané ; les modifications de travail ultérieures sans rapport demeurent.
• Remote: aucune de ces étapes locales ne pousse, ne récupère ou ne crée une référence de suivi à distance. Cet exemple n'a pas de télécommande.

L'index est plus qu'une liste de noms. Les conflits avancés peuvent contenir plusieurs étapes d'indexation ; nous modélisons ici des entrées de fichiers ordinaires au stade zéro, et non des fusions non résolues.

Do not execute these in the still-uninitialized learner project. Ils ont été exécutés dans une copie jetable contenant le README complet et les deux versions de la page. La leçon 5 fournit les véritables étapes de création et de mise en scène.

À l'état futur C, inspectez les deux versions

git status --short -- index.html

Observé :

AM index.html

Lisez directement le fichier préparé :

git show :index.html

Observé full output :

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>GitTree Features — course demo</title>
</head>
<body>
  <header class="site-header">
    <a href="#main">GitTree Features</a>
  </header>
  <main id="main">
    <section class="hero" aria-labelledby="hero-title">
      <p class="eyebrow">GitTree Learn demo project</p>
      <h1 id="hero-title">Understand every change.</h1>
      <p id="hero-copy">A clear view of Git history.</p>
    </section>
  </main>
  <footer><p>Built by a fictional team for GitTree Learn.</p></footer>
</body>
</html>

Comparez l'arbre de travail avec l'index :

git diff -- index.html

Observé :

diff --git a/index.html b/index.html
index 5470374..27f8718 100644
--- a/index.html
+++ b/index.html
@@ -13,7 +13,7 @@
     <section class="hero" aria-labelledby="hero-title">
       <p class="eyebrow">GitTree Learn demo project</p>
       <h1 id="hero-title">Understand every change.</h1>
-      <p id="hero-copy">A clear view of Git history.</p>
+      <p id="hero-copy">Choose one change, then check what Git saved.</p>
     </section>
   </main>
   <footer><p>Built by a fictional team for GitTree Learn.</p></footer>

Les abréviations d'objet ci-dessus sont de véritables ID de fichiers blob provenant de ces corps de fichiers LF exacts, et non des SHA de validation inventés. La longueur/sortie de votre abréviation peut différer selon la configuration.

Inspectez l'ajout par étapes, par rapport à l'historique vide avant la première validation :

git diff --cached --stat -- index.html

Observé :

 index.html | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

--stat résume ; il ne s'agit pas d'une révision de contenu. L'instantané intermédiaire complet est le fichier précédent affiché par git show :index.html.

À l'état futur D, vérifiez ce qui a été enregistré

Après la validation normale de l'index préparé par la leçon 5 :

git log -1 --format=%s
git status --short -- index.html
git diff --cached -- index.html

Deux premières sorties observées, dans l'ordre :

feat: add the GitTree Features hero
 M index.html

La troisième commande imprime no output et se termine avec succès : index et HEAD sont d'accord pour ce chemin. Cela ne signifie pas que l’arbre en activité est propre. Le diff de travail montre toujours la modification de la ligne de support ci-dessus. C'est une raison courante pour laquelle « le commit a manqué ma dernière modification » est en fait un comportement correct de Git.

Dans votre contexte actuel sans référentiel

1. Gardez New Tab ouvert, en utilisant Command+T / Ctrl+T (tab.new) si nécessaire.
2. Ouvrez Feature Guide avec Option+H sur macOS ou Alt+H ailleurs, ou ouvrez Command Palette… avec Command+Shift+P/Ctrl+Shift+P et choisissez Feature Guide.
3. Dans Features, tapez stage dans Search features et lisez Stage and commit. N'exécutez pas d'action d'initialisation. La carte est une orientation et non la preuve d'un dossier mis en scène.
4. Appuyez sur Escape pour fermer le guide. Votre référentiel de cours n'existe toujours pas.

Les mêmes états dans GitTree (affichés dans la vidéo)

La vidéo ouvre une copie jetable du futur projet dans GitTree, intitulée « Aperçu de la leçon 5 du futur ». Il ne s'agit pas de votre projet ni d'un enregistrement de votre travail.

1. En C, ouvrez Command Palette…, tapez Show Working Changes et choisissez cette commande exacte (wip.show). Aucun raccourci par défaut n'est défini pour cette commande.
2. Inspectez les Unstaged Files et Staged Files du panneau de droite. index.html apparaît dans les deux car il comporte deux comparaisons différentes ; ce ne sont pas deux fichiers physiques.
3. Cliquez sur sa ligne dans Unstaged Files. Attendez-vous à ce que la différence centrale affiche la page d'origine modifiée en page modifiée, y compris le changement de ligne de support.
4. Cliquez sur sa ligne dans Staged Files. Attendez-vous à l'ajout par étapes, contenant la ligne de support précédente. Le simple fait d’inspecter l’une ou l’autre des lignes ne met en scène ni ne désactive quoi que ce soit.
5. En D, après la validation normale, le graphe a la première validation ; Staged Files dit Nothing is staged. A commit contains only staged changes. La modification de travail reste sous Unstaged Files.
6. Faites not cliquez sur Stage File, Unstage File, Stage All Changes ou Discard Changes… dans cet aperçu du concept. Des instructions dédiées à la création et à la validation suivent dans les leçons 4 et 5.

Vous pouvez prédire D à partir de C : le premier commit enregistre la ligne de support précédente, tandis que la modification de travail ultérieure reste. Votre propre projet reste dans l'état sans référentiel. Le graphique du futur projet est un aperçu explicitement étiqueté, et non votre travail terminé.

• “Staged means all future edits are included.” Cela signifie que l'index contient une version sélectionnée à ce stade.
• “Empty cached diff means no edits.” Il indique que index et HEAD sont d'accord pour le chemin sélectionné ; inspectez également le différentiel de travail.
• “Two lists mean two files.” Il s'agit de deux comparaisons pour le même chemin.
• “A staged file is safely committed.” L'index est mutable ; il ne s'agit pas d'un historique durable ou d'une sauvegarde.
• “Commit means remote update.” Il n'y a pas de télécommande dans cet exemple et aucun push ne se produit.

Si vous exécutez une requête de dépôt maintenant et obtenez « pas un référentiel git », gardez le point de contrôle de la leçon intact et lisez l'aperçu. Ne créez pas un deuxième référentiel pour faire réussir un exemple de commande.

Si votre propre projet affiche ultérieurement un statut différent, inspectez le chemin sélectionné avant d'essayer de le réparer. Avez-vous repris la scène après le montage ? Cela modifie l'instantané préparé et donc la validation prévue. Avez-vous utilisé une commande de scène automatique ? Il s’agit d’une opération différente de la validation normale d’index uniquement ici.

À ce stade, nous récupérons en identifiant la bonne comparaison, sans détruire le contenu. La leçon 5 montre des décisions de mise en scène sûres, et le chemin de récupération enseigne l'annulation et le reflog dont la portée est vérifiée. Les instantanés de la corbeille GitTree ne garantissent pas que chaque sauvegarde arbitraire de l'éditeur est récupérable.

Répondez à chaque question, puis lisez pourquoi. Les questions marquées « Obligatoire » comptent pour terminer la leçon.

1. Question 1 de 6

   Question 1 de 6

   Quel instantané fournit le commit normal modélisé ici ?

   Choisissez une réponse.

   Toujours le dernier tampon de l'éditeur

   Le fournisseur distant

   L'index préparé

   Vérifier la réponse
2. Question 2 de 6

   Question 2 de 6

   Chez C, qu'est-ce qui a changé à cause du montage post-mise en scène ?

   Choisissez chaque réponse qui s'applique.

   Aucun changement de référence à distance

   Le fichier index.html de travail a maintenant la ligne la plus récente

   Les principales avancées locales vers un commit

   L'index gagne automatiquement la ligne la plus récente

   Vérifier la réponse
3. Question 3 de 6

   Question 3 de 6Obligatoire

   En C, validez l’index sans effectuer de nouvelle mise en scène. Quelle ligne est enregistrée ?

   Choisissez une réponse.

   Une vue claire de l’historique de Git.

   Choisissez une modification, puis vérifiez ce que Git a enregistré.

   Les deux lignes dans deux fichiers physiques

   Vérifier la réponse
4. Question 4 de 6

   Question 4 de 6Obligatoire

   Commencez par C, préparez la version éditée, puis validez. Quels changements ?

   Choisissez une réponse.

   Une poussée à distance se produit automatiquement

   L'ancienne ligne enregistre toujours car la première étape est permanente

   Une ligne plus récente est enregistrée ; aucune différence restante pour ce chemin

   Vérifier la réponse
5. Question 5 de 6

   Question 5 de 6

   En D, le diff mis en cache est vide mais le statut est espace puis M. Pourquoi ?

   Choisissez une réponse.

   Git a perdu la modification de travail

   Chaque fichier est propre

   HEAD et index sont d’accord ; l'arbre de travail diffère

   Vérifier la réponse
6. Question 6 de 6

   Question 6 de 6Obligatoire

   suivez A → B → C, puis effectuez la validation normale de l'index. Quelles observations prouvent D ?

   Choisissez chaque réponse qui s'applique.

   Le commit et l'index contiennent la page d'origine

   Le statut court du fichier est espace puis M

   Le fichier de travail contient la page modifiée

   L’apprenant dispose désormais d’un véritable référentiel initialisé

   Vérifier la réponse

Avant la leçon 5, prédisez sur papier : stagez un fichier, éditez-le après le staging, puis validez normalement. Quelle ligne de support est enregistrée et où reste la modification ultérieure ? Modifiez ensuite la séquence : remettez en scène le fichier modifié avant de le valider. Maintenant, la ligne enregistrée devrait être la plus récente, sans aucune différence de fonctionnement restante. La vidéo montre les deux itinéraires avec un résultat réel ; vous vérifierez les deux vous-même dans la leçon 5.

• Les fichiers de travail, l'index et l'historique enregistré sont des instantanés différents.
• La mise en scène capture les contenus choisis ; les modifications ultérieures ne le mettent pas à jour automatiquement.
• Inspectez les deux comparaisons et ne confondez pas une validation locale avec une action à distance.

• Installez Git et prévisualisez votre identité de commit (leçon 2)
• Distinguez Git, GitTree et votre fournisseur d'hébergement (leçon 1)
• Télécharger GitTree

Arbre de travail — مجلد العمل; zone de transit / index — منطقة التجهيز / الفهرس ; commettre — إيداع; réf — مرجع; non suivi — غير مُتتبَّع ; mis en scène — مُجهَّز. HEAD reste l’identifiant technique littéral.