Apprendre Git : le tutoriel pour les débutants

Git est un système de contrôle de version distribué. Il enregistre l’état de vos fichiers à chaque étape du travail, vous permet de revenir en arrière, et rend possible le travail à plusieurs sur le même projet sans s’écraser les uns les autres. C’est l’outil de base du métier de développeur : il est utilisé aussi bien pour un script d’une centaine de lignes que pour le noyau Linux.

Git n’est pas GitHub

C’est la confusion la plus fréquente quand on débute. Git est un programme qui tourne sur votre machine et qui gère l’historique de votre projet dans un dossier caché .git. Il fonctionne sans connexion internet et sans compte nulle part.

GitHub, GitLab ou Bitbucket sont des hébergeurs de dépôts Git. Ils stockent une copie de votre projet sur leurs serveurs, servent de point de rendez-vous à une équipe, et ajoutent leurs propres outils autour de Git : gestion des tickets, revue de code, intégration continue. Vous pouvez utiliser Git toute votre vie sans jamais créer de compte GitHub. L’inverse n’a pas de sens.

Dans ce tutoriel, Git est l’outil que vous apprenez, GitHub et GitLab sont les services que vous utilisez pour partager votre travail.

Ce que vous saurez faire à la fin

• Installer Git et le configurer correctement du premier coup, y compris l’authentification par clé SSH.
• Créer un dépôt sur GitHub ou GitLab et le relier à un dossier de votre machine, dans les deux sens.
• Enregistrer votre travail par étapes lisibles, consulter l’historique, et annuler une erreur sans tout perdre.
• Travailler sur une branche, la fusionner, et résoudre un conflit à la main.
• Choisir un modèle de branches adapté à votre équipe, entre Gitflow et le trunk-based development.

Ce dont vous avez besoin

Un terminal et rien d’autre. Ce tutoriel n’utilise aucune interface graphique : ni GitHub Desktop, ni l’onglet Git de votre éditeur. Ces outils sont pratiques une fois que vous comprenez ce qu’ils font à votre place, et trompeurs avant. Toutes les commandes fonctionnent à l’identique sur Windows (dans Git Bash), macOS et Linux.

Aucune connaissance préalable n’est attendue, mais savoir se déplacer dans un terminal avec cd et ls aide beaucoup.

Un mot sur les versions

Git est un logiciel stable et lent à changer : les commandes de ce tutoriel fonctionnent depuis des années et continueront de fonctionner. Deux points bougent malgré tout et sont traités explicitement dans les chapitres concernés.

D’abord les commandes git switch et git restore, apparues avec Git 2.23 en 2019, qui remplacent avantageusement git checkout pour changer de branche et annuler des modifications. Elles ne sont plus marquées comme expérimentales dans la documentation officielle. Ce tutoriel les enseigne en premier, et donne l’équivalent en git checkout pour que vous puissiez lire le code des autres.

Ensuite le nom de la branche par défaut. Contrairement à une idée répandue, git init crée toujours une branche master en Git 2.55, pas main. Le changement est annoncé pour Git 3.0. Le premier chapitre vous montre comment régler ce point une fois pour toutes.

Le parcours

1. Installer et configurer Git, installation par système, identité, branche par défaut, et authentification par clé SSH ou jeton.
2. Créer un dépôt et le récupérer en local, les deux chemins possibles : cloner un dépôt existant, ou publier un dossier que vous avez déjà.
3. Les commandes de base — status, add, commit, push, pull, le fichier .gitignore, et surtout comment annuler une bêtise.
4. Travailler en équipe avec les branches, créer une branche, la fusionner, résoudre un conflit, et choisir entre merge et rebase.
5. Gitflow ou trunk-based, les deux modèles de branches, leurs commandes, et dans quel contexte chacun se justifie.

Les chapitres se suivent : chacun reprend le projet là où le précédent l’a laissé. Vous pouvez malgré tout entrer directement dans celui qui vous intéresse, les commandes nécessaires y sont rappelées.

Ce tutoriel fait partie du parcours Développement web de Gekkode.