Git pour débutants : apprenez les bases avec une interface

Git pour les débutants se résume à cinq idées. Un dépôt contient votre projet et son historique, un commit est un instantané enregistré de vos fichiers, une branche est une ligne de travail distincte, une fusion joint deux branches et une distant est une copie du référentiel sur un serveur tel que GitHub. Apprenez ces cinq tutoriels et chaque didacticiel Git commence à avoir un sens. Une interface graphique Git est utile car elle les dessine pour vous : chaque commit est un point sur un graphique et chaque branche est une ligne colorée, vous voyez donc ce qui se passe au lieu de l'imaginer.

Ce didacticiel Git explique chaque idée en termes simples, puis présente un premier projet dans une interface graphique. L'application dans les captures d'écran est GitTree, un client Git de bureau pour macOS, Windows et Linux ; son créateur a écrit ce guide. Son interface est également disponible en arabe, disposée de droite à gauche : choisissez la langue dans Préférences › Personnalisation de l'interface utilisateur. Chaque étape affiche également la commande correspondante, de sorte que ce que vous apprenez fonctionne dans le terminal et dans tout autre outil Git.

Qu’est-ce que Git ? Contrôle de version en termes simples

Git est un système de contrôle de version : un programme qui enregistre chaque modification que vous enregistrez dans un ensemble de fichiers, afin que vous puissiez voir qui a modifié quoi et quand, comparer deux versions et revenir à une version antérieure. Pensez à un historique d'annulation illimité pour un dossier entier, où chaque point enregistré a un nom et une note expliquant pourquoi.

Les développeurs du noyau Linux, dirigés par Linus Torvalds, ont créé Git en 2005, et cela fonctionne aussi bien pour les sites Web, la documentation ou une thèse que pour le code. Git est distribué : chaque copie d'un référentiel contient l'historique complet, vous pouvez donc valider, parcourir l'historique et créer des branches hors ligne. Vous n'avez besoin que du réseau pour partager le travail.

Une confusion courante : Git est l'outil sur votre ordinateur, tandis que GitHub, GitLab et Bitbucket sont des sites Web qui hébergent des référentiels Git afin que les équipes puissent les partager. Notre guide sur Git vs GitHub explique la différence en détail.

Les bases de Git pour les débutants : les cinq idées à apprendre en premier

1. Référentiel : votre projet et son historique

Un référentiel (repo) est un dossier de projet ordinaire suivi par Git. Git conserve l'historique dans un dossier caché .git à l'intérieur. Vos fichiers restent des fichiers normaux : vous les modifiez avec n'importe quel éditeur, et Git n'intervient que lorsque vous lui demandez d'enregistrer ou de partager quelque chose.

2. Commit : un instantané enregistré avec un message

Un commit enregistre l'état de vos fichiers à un moment donné, ainsi que votre nom, la date et un court message tel que « Ajouter un formulaire de contact ». Chaque commit obtient un identifiant unique appelé hachage (par exemple a1b2c3d) et renvoie au commit qui le précède. C'est ainsi que Git crée un historique que vous pouvez lire, comparer et auquel vous pouvez revenir.

Avant de vous engager, vous stadez les modifications que vous souhaitez inclure. La zone de préparation vous permet de diviser le travail en validations ordonnées : corrigez un bug et renommez une variable, puis validez chaque modification séparément, même si les deux se trouvent dans le même fichier.

3. Branche : un métier à part

Une branche est un nom qui pointe vers une validation et avance à chaque fois que vous effectuez une validation dessus. La plupart des référentiels ont une branche principale, généralement appelée main (les plus anciens utilisent souvent master). Lorsque vous démarrez quelque chose de nouveau, vous créez une branche telle que feature/contact-page, vous vous y engagez et main reste intact jusqu'à ce que le travail soit prêt. Les branches dans Git sont bon marché : en créer une prend un instant, alors utilisez-les librement.

4. Fusionner : rassembler le travail

Une fusion ajoute les commits d'une branche à une autre, par exemple votre branche de fonctionnalité dans main. Si main n'a pas bougé depuis votre création de branche, Git le fait simplement avancer (une avance rapide) ; sinon, cela crée une validation de fusion avec deux parents. Lorsque les deux côtés ont modifié les mêmes lignes, Git vous demande de choisir : un conflit de fusion. C'est une routine, et notre guide sur la résolution des conflits de fusion Git montre comment en gérer un calmement.

5. Remote : une copie sur un serveur

Une télécommande est une autre copie du référentiel, généralement sur un service d'hébergement. Celui à partir duquel vous avez cloné est nommé origin par défaut. Vous poussez pour envoyer vos nouveaux commits à la télécommande, récupérez pour télécharger les commits que d'autres ont poussés et tirez pour récupérer et importer ces commits dans votre branche actuelle. Clone copie un référentiel distant, avec tout son historique, sur votre ordinateur.

Avant de commencer : installez Git et définissez votre nom

GitTree s'exécute sur Git installé sur votre ordinateur et ne regroupe pas le sien, alors installez d'abord Git (version 2.39 ou plus récente). C'est aussi pourquoi chaque bouton de GitTree fait ce que fait la commande correspondante. Sur macOS, exécutez xcode-select --install ou brew install git. Le Windows, installez Git for Windows depuis git-scm.com. Le Linux, exécutez sudo apt install git sur Ubuntu 24.04 ou Debian 12 ; Ubuntu 22.04 et Linux Mint 21 livrent Git 2.34, ce qui est trop ancien, donc mettez à niveau Git sur Ubuntu d'abord. Vérifiez ensuite la version dans un terminal :

git --version

Git écrit un nom et un e-mail dans chaque commit, alors définissez-les une fois. Utilisez l'e-mail de votre compte GitHub, GitLab ou Bitbucket si vous souhaitez y associer des commits à votre profil :

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Vous pouvez également les définir sans le terminal : dans les Préférences de GitTree, un profil contient un nom et une adresse e-mail pour les validations (pratique pour séparer les identités professionnelle et personnelle), et chaque référentiel peut avoir son propre Nom pour les validations et son E-mail pour les validations.

Étape 1 : clonez ou créez votre premier référentiel

Téléchargez GitTree et installez-le. Lorsqu'il s'ouvre, connectez-vous avec un compte GitTree, créé sur gittree.app avec votre email ou avec GitHub, GitLab, Bitbucket ou Azure DevOps : chaque fonctionnalité Git est alors sur le plan gratuit. GitTree Pro est requis pour l'hébergement d'intégrations, telles que la publication d'un référentiel ; Nour, l'assistant IA, est livré avec GitTree Pro. Chaque nouvel onglet s'ouvre sur la page de démarrage, qui propose trois manières d'accéder : Ouvrir, Clone et Init.

Cloner un dépôt qui existe déjà

Choisissez Clone, collez l'URL du référentiel (HTTPS ou SSH), choisissez un dossier parent et vérifiez le chemin Clones into. Laissez Ouvrir après le clonage coché et choisissez Clone. Si vous avez connecté un compte GitHub ou Bitbucket, Clone from GitHub / Bitbucket… vous permet de choisir un référentiel dans une liste au lieu de copier son URL. La commande fait la même chose :

git clone https://github.com/your-name/your-project.git

Ou démarrez un nouveau référentiel avec Init

Pour placer un dossier existant sous contrôle de version ou repartir de zéro, choisissez Init. Choisissez l'emplacement, utilisez main comme branche initiale et ajoutez éventuellement un modèle .gitignore (afin que la sortie de construction et les dépendances restent en dehors de Git) et une licence. Rien n'est écrit jusqu'à ce que vous choisissiez Initialiser. La version de la commande :

git init -b main

Étape 2 : préparez et validez votre premier changement

Ouvrez le projet dans votre éditeur et modifiez quelque chose de petit : ajoutez une ligne à README.md, par exemple. De retour dans GitTree, une ligne // WIP apparaît au-dessus du commit le plus récent sur le graphique, et le fichier apparaît sous Fichiers non mis en scène dans le panneau de droite.

1. Mettez en scène la modification. Choisissez Mettez en scène toutes les modifications ou sélectionnez un fichier et préparez-le uniquement. Pour mettre en scène une partie d'un fichier, ouvrez-le et utilisez Stage Hunk, ou cochez des lignes simples et choisissez Stage Lines. Les fichiers préparés sont déplacés vers Fichiers préparés.
2. Écrivez un message. Tapez un court Résumé de ce que fait la validation, par exemple « Ajouter une description du projet au README ». Un compteur indique à quel point vous êtes proche de 72 caractères ; les résumés plus longs sont souvent coupés dans d’autres outils. Ajoutez une Description si la raison n'est pas évidente.
3. Commit. Choisissez Commit Changes to 1 File (le nombre correspond à ce que vous avez préparé). Le nouveau commit apparaît en haut du graphique.

Les trois mêmes étapes sur la ligne de commande :

git status
git add README.md
git commit -m "Add project description to README"

De bonnes habitudes dès le premier jour : un changement logique par commit, un résumé qui dit ce que fait le commit ("Fix login redirect", pas "trucs"), et des commits fréquents. Les petits commits sont plus faciles à réviser, expliquer et annuler.

Étape 3 : créer une branche, puis la fusionner

Choisissez Branche dans la barre d'outils, saisissez un nom tel que feature/contact-page, assurez-vous que Découvrir la nouvelle branche est coché et choisissez Créer une branche. Faites un commit ou deux de la même manière qu’avant. Le graphique montre maintenant l'étiquette de votre branche en avance sur main ; lorsque les deux branches ont de nouveaux commits, chacune obtient sa propre voie colorée.

git switch -c feature/contact-page

Lorsque le travail est prêt, ramenez-le dans main. Double-cliquez sur main dans la barre latérale pour le consulter, puis cliquez avec le bouton droit sur votre branche de fonctionnalités et choisissez Fusionner la fonctionnalité/la page de contact dans la page principale. Vous pouvez également faire glisser l'étiquette de branche sur main et sélectionner la fusion dans le menu. Les commandes :

git switch main
git merge feature/contact-page

Étape 4 : transférez votre travail vers GitHub ou une autre télécommande

Si vous avez cloné le référentiel, il dispose déjà d'un distant appelé origin : choisissez Push dans la barre d'outils. La première poussée d'une nouvelle branche la place également en amont, de sorte que les poussées et tractions ultérieures sachent où aller. Pour pousser à chaque fois, ouvrez Options de validation et activez Push After Commit.

Un référentiel que vous avez créé avec Init n'a pas encore de référentiel distant. Exécutez Publish Repository… à partir de la palette de commandes (⌘+Shift+P sur un Mac, Ctrl+Shift+P sur Windows et Linux) : il crée le référentiel sur votre compte connecté GitHub, GitLab, Bitbucket ou Azure DevOps (la connexion nécessite un compte GitTree avec Pro), l'ajoute en tant que distant et pousse la branche. Voir comment pousser un projet vers GitHub sans la ligne de commande pour chaque étape. Sur la ligne de commande, après avoir créé un dépôt vide sur le site :

git remote add origin https://github.com/your-name/your-project.git
git push -u origin main

Pour que vos coéquipiers poussent les commits, choisissez Pull ; GitTree récupère également en arrière-plan, donc les nouveaux commits à distance s'affichent en premier sur le graphique. Si la télécommande vous demande qui vous êtes, générez une clé SSH dans GitTree et ajoutez-la à votre compte GitHub, GitLab ou Bitbucket, ou connectez votre compte d'hébergement dans GitTree, qui peut également télécharger la clé pour vous (les intégrations d'hébergement sont fournies avec GitTree Pro, qui commence par un essai gratuit).

Glossaire Git pour les débutants

Gardez ce tableau ouvert pendant que vous apprenez Git. Chaque ligne donne un terme, ce qu'il signifie et où vous le trouvez dans GitTree.

Comment continuer à apprendre Git après votre premier projet

La boucle que vous venez de pratiquer (édition, mise en scène, validation, push et branche pour tout ce qui est plus important qu'une solution rapide) couvre la plupart des jours avec Git. Lorsque vous êtes prêt à en savoir plus, apprenez une nouvelle idée à la fois :

• Lire l'historique. Apprenez à suivre les voies, les bifurcations et les fusions avec un visualiseur d'arborescence Git.
• Annuler en toute sécurité. La plupart des erreurs sont récupérables ; voir comment annuler une réinitialisation, un rebase ou un commit.
• Ranger les commits avant de les partager. Un rebase interactif dans une interface graphique vous permet d'écraser, de reformuler et de réorganiser les commits en les faisant glisser.
• Apprenez également les commandes. Le terminal intégré de GitTree se trouve sous le graphique, vous pouvez donc saisir une commande et regarder le graphique changer. Notre comparaison de une interface graphique Git et la ligne de commande explique quand chacun gagne.
• Suivez un cours. Les tutoriels Git gratuits commencent par la différence entre Git, GitTree et GitHub et passent aux branches, aux télécommandes, à la fusion et au rebasage, une courte leçon à la fois.

Étudiant universitaire ? Lisez le guide Git GUI étudiant pour connaître l'offre Pro unique de 24 mois et son éligibilité restreinte aux e-mails académiques.

GitTree propose un forfait gratuit qui couvre toutes les fonctionnalités de Git, y compris les référentiels privés, et Nour, l'assistant IA, est livré avec GitTree Pro. Consultez tout ce qu'il peut faire ou lisez les notes d'installation pour Mac, Windows et Linux.