FRENES

Glossaire · Agents de code

Commit

Un commit est un enregistrement dans l’historique d’un dépôt Git qui représente un état du projet et le relie à son évolution. Il possède un identifiant et des informations associées, comme un message descriptif, pour vous aider à retrouver et comprendre les modifications enregistrées.

Commit : l'explication

Dans un usage courant de Git, vous modifiez des fichiers, sélectionnez le contenu à enregistrer, puis créez un commit. La [documentation Git](https://git-scm.com/book/id/v2/Git-Basics-Recording-Changes-to-the-Repository) décrit cette préparation avant l’enregistrement. Le commit correspond au contenu sélectionné, pas nécessairement à tous les fichiers présents sur votre ordinateur. Vous pouvez ainsi séparer une correction et une modification de documentation. Cette organisation rend l’historique plus facile à lire et vous permet d’examiner chaque changement avec son contexte plutôt qu’un ensemble de modifications sans rapport.

Les commits servent à suivre l’évolution du code, des instructions et des configurations. Vous pouvez comparer deux états pour voir ce qui a changé dans un agent ou identifier l’ajout d’une fonctionnalité. Un message clair explique l’intention de la modification, tandis que la comparaison montre les différences effectives. L’identifiant vous permet de désigner un état précis lors d’un signalement de problème. Il est alors plus facile de discuter du même code que de parler simplement de la version actuelle.

Créer un commit ne signifie pas automatiquement publier les changements sur un serveur, réussir les tests ou mettre le logiciel en service. Ces opérations sont distinctes, même si un projet peut les relier par des automatismes. Un commit ne garantit pas non plus la qualité de ce qu’il contient. Enfin, retirer une information sensible du fichier actuel ne la fait pas forcément disparaître des commits précédents. L’historique doit donc être pris en compte lorsque vous examinez le contenu partagé.

Un exemple concret

Un agent vous aide à corriger le calcul d’une date dans votre site. Vous examinez les fichiers modifiés et vérifiez le résultat. Vous créez ensuite un commit consacré à cette correction, avec un message qui décrit le problème résolu. Si une difficulté apparaît plus tard, vous pouvez retrouver cet état et comparer les changements, sans mélanger cette correction avec une autre modification de la présentation.

Pourquoi c'est important

Les commits rendent les changements d’un agent ou d’un outil plus faciles à suivre et à discuter. Quand vous examinez un projet, leur contenu vous renseigne davantage que leur nombre. Des enregistrements nombreux peuvent être minuscules ou automatiques. Pour votre propre travail, des commits cohérents facilitent la relecture et le retour sur une modification, mais ils ne remplacent ni les tests ni une sauvegarde adaptée.

Idées reçues

  • Un commit ne publie pas automatiquement votre travail sur Internet, car l’enregistrement dans l’historique local et l’envoi vers un dépôt distant sont des opérations distinctes, même si une interface peut vous proposer de les enchaîner.
  • Un grand nombre de commits ne prouve pas qu’un projet progresse rapidement ou reste fiable, puisque leur taille, leur contenu et leur utilité varient et que la qualité des changements doit être examinée séparément.

Autres termes : agents de code

étoiles GitHub
Les étoiles GitHub sont des marques qu’un utilisateur peut attribuer à un dépôt sur la plateforme GitHub pour le retrouver ou manifester son intérêt.
fork
Un fork est une version d’un projet logiciel développée séparément à partir d’un projet existant.
licence logicielle
Une licence logicielle définit les autorisations et les conditions applicables à l’utilisation d’un logiciel.
interface en ligne de commande
Une interface en ligne de commande est un moyen de piloter un programme en saisissant des instructions textuelles, souvent dans un terminal.
IDE
Un IDE est un environnement de développement intégré, c’est-à-dire une application qui rassemble plusieurs outils pour créer et examiner des logiciels.

Où le site en parle

Le terme apparaît dans 3 588 pages du site. Quelques-unes :

Questions fréquentes

Commit ou sauvegarde de fichier ?

Enregistrer un fichier met à jour son contenu sur votre support de stockage. Créer un commit ajoute un état sélectionné à l’historique Git. Un fichier peut donc être enregistré et modifié sans que son nouveau contenu figure dans un commit.

Peut-on annuler un commit ?

Git propose plusieurs façons de revenir sur des changements, notamment en créant un commit qui inverse leurs effets. La méthode dépend du contexte et du partage de l’historique. Sur un projet collectif, évitez de modifier cet historique sans coordination.

Le message décrit-il tous les changements ?

Le message est rédigé par une personne ou un outil et peut être incomplet. Pour savoir ce qu’un commit modifie réellement, examinez aussi la comparaison des fichiers concernés et, si nécessaire, les résultats des vérifications associées.

Neutralité. Aucun lien d'affiliation. Aucun éditeur ne paie pour être évalué, noté ou classé. Les évaluations sont dirigées par François Chollet, neutres et factuelles, et chaque donnée est datée et sourcée. Comment nous notons