Ce que nous installons (et ce que nous n’installons pas)
Rappel de la leçon 1.2, parce que c’est le moment où la distinction devient concrète : nous installons Git, le logiciel, sur votre poste de travail. Pas la forge. Celle-ci attendra la section 2.
À la fin de cette leçon, vous pourrez versionner des fichiers en local, consulter leur historique et revenir en arrière — sans serveur, sans compte, sans réseau. C’est déjà l’essentiel du bénéfice.
Comptez dix minutes, dont huit de configuration. Cette proportion n’est pas une erreur : l’installation est triviale, mais quelques réglages faits maintenant vous éviteront des heures de perplexité plus tard. Les fins de ligne, en particulier, sont responsables de plus de temps perdu chez les administrateurs système que n’importe quelle commande Git.
Installation sous Windows
La méthode rapide
Si vous êtes sur Windows 10 ou 11, winget est déjà présent :
winget install --id Git.Git -e
Fermez puis rouvrez votre terminal, et vérifiez :
git --version
La méthode par l’assistant
Sinon, téléchargez l’installeur sur git-scm.com. L’assistant pose une quinzaine de questions, dont la plupart peuvent rester à leur valeur par défaut. Voici les seules qui méritent votre attention.
| Écran de l’assistant | Ce que je recommande | Pourquoi |
|---|---|---|
| Éditeur par défaut | Visual Studio Code (ou Notepad++) | Le défaut est Vim. Si vous ne le connaissez pas, vous vous retrouverez bloqué dans un écran noir dont vous ne saurez pas sortir. |
| Nom de la branche initiale | main |
C’est la convention actuelle, et celle qu’utilisent Forgejo et GitLab par défaut. Éviter un décalage dès le premier dépôt. |
| Ajustement du PATH | Git from the command line and also from 3rd-party software | Rend git utilisable depuis PowerShell, l’invite de commandes et VS Code. |
| Fins de ligne | Checkout Windows-style, commit Unix-style | Le sujet est traité en détail plus bas. C’est le bon défaut. |
| Gestionnaire d’identifiants | Git Credential Manager | Il stockera vos jetons d’accès à la forge dans le gestionnaire d’identifiants Windows, plutôt qu’en clair. |
Ce que l’installation apporte
Vous obtenez git en ligne de commande, mais aussi Git Bash — un terminal Unix minimal sous Windows, avec ssh, ssh-keygen, curl, grep. Nous l’utiliserons pour générer nos clés SSH en section 3.
Installation sous Linux
Rien de particulier, Git est dans tous les dépôts.
Debian, Ubuntu
sudo apt update && sudo apt install -y git
RHEL, Rocky Linux, AlmaLinux, Fedora
sudo dnf install -y git
Alpine
apk add git
openSUSE
sudo zypper install git
Vérification :
git --version
Les versions packagées sont parfois en retard de quelques mois sur la dernière publiée. Sans importance pour nos usages : les commandes que nous allons employer sont stables depuis des années.
Les trois niveaux de configuration
Avant de taper quoi que ce soit, comprenez où atterrissent vos réglages. Git lit sa configuration à trois niveaux, du plus général au plus spécifique — et le plus spécifique gagne.
| Niveau | Option | Emplacement | Portée |
|---|---|---|---|
| Système | --system |
/etc/gitconfig |
Tous les utilisateurs de la machine |
| Utilisateur | --global |
~/.gitconfig |
Tous vos dépôts |
| Dépôt | --local |
.git/config du dépôt |
Ce dépôt uniquement |
En pratique, vous utiliserez --global pour vos réglages personnels, et --local dans un seul cas de figure — que nous verrons juste après.
Votre identité
C’est la seule configuration réellement obligatoire. Sans elle, Git refusera d’enregistrer quoi que ce soit.
git config --global user.name "Romain Dupont"
git config --global user.email "[email protected]"
Ces deux informations seront inscrites dans chaque enregistrement que vous produirez, et elles y resteront définitivement. C’est exactement ce que nous cherchions dans la leçon 1.3 : savoir qui a modifié quoi.
Deux précisions importantes.
L’adresse doit être la vraie. Sur la forge, c’est elle qui permet de rattacher un enregistrement à votre compte. Une adresse fantaisiste, et vos contributions apparaîtront comme celles d’un inconnu.
Ce n’est pas une authentification. N’importe qui peut configurer n’importe quel nom sur sa machine. L’identité déclarée ici sert à la lisibilité de l’historique, pas à la sécurité — celle-ci reposera sur vos clés SSH et vos jetons, et éventuellement sur la signature des enregistrements que nous verrons en section 14.
Le cas de la double identité
Si vous contribuez à des projets publics avec une adresse personnelle et à ceux de votre entreprise avec votre adresse professionnelle, configurez le global sur l’un des deux, puis surchargez au niveau du dépôt concerné :
cd ~/projets/projet-perso
git config --local user.email "[email protected]"
C’est le seul usage courant de --local.
La branche par défaut
git config --global init.defaultBranch main
Historiquement, la branche principale s’appelait master. La convention actuelle est main, adoptée par l’ensemble des forges. Si vous ne réglez pas ce paramètre, Git vous affichera un avertissement à chaque nouveau dépôt, et vous vous retrouverez avec un décalage de nom dès votre première synchronisation.
L’éditeur par défaut
Git ouvrira un éditeur de texte à chaque fois qu’il aura besoin que vous rédigiez un message. Si vous n’avez rien configuré, ce sera Vim — un excellent éditeur, mais dont on ne devine pas comment sortir.
# Visual Studio Code
git config --global core.editor "code --wait"
# Nano (Linux, simple et suffisant)
git config --global core.editor "nano"
# Notepad++ (Windows)
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
L’option --wait de VS Code est indispensable : sans elle, Git considère que vous avez terminé avant même que la fenêtre ne s’ouvre.
Si vous êtes déjà tombé dans Vim : tapez :q! puis Entrée pour sortir sans enregistrer, ou :wq pour enregistrer et sortir.
Les fins de ligne : le piège numéro un
Voici le réglage qui vous fera gagner le plus de temps, et celui que la plupart des tutoriels expédient en une ligne.
Le problème
Windows et Unix ne marquent pas la fin d’une ligne de la même façon. Windows utilise deux caractères (CRLF), Linux et macOS un seul (LF). Invisible dans un éditeur, mais bien réel dans le fichier.
Sans réglage, deux conséquences désagréables.
Des différences fantômes. Un collègue sous Windows ouvre un fichier venu d’un serveur Linux, l’enregistre sans y toucher, et Git annonce que les 400 lignes ont été modifiées. Comparer devient impossible, et l’historique perd tout son intérêt.
Des scripts qui ne s’exécutent pas. Celui-là, vous le rencontrerez tôt ou tard. Vous écrivez un script Bash sous Windows, vous le déposez sur un serveur Linux, et vous obtenez :
-bash: ./deploy.sh: /bin/bash^M: bad interpreter: No such file or directory
Ce ^M est le caractère CR que Linux ne sait pas interpréter. Le script est parfaitement correct — il est juste encodé pour le mauvais système. Comme nous allons précisément faire circuler des scripts entre Windows et Linux dans toute cette formation, autant régler le problème maintenant.
Le réglage
Sous Windows :
git config --global core.autocrlf true
Git stocke en LF dans le dépôt et convertit en CRLF sur votre disque. Le dépôt reste propre, votre confort local est préservé.
Sous Linux et macOS :
git config --global core.autocrlf input
Git convertit en LF à l’enregistrement, et ne touche à rien à la récupération.
La vraie solution, pour plus tard
Ce réglage dépend de chaque poste, donc de la bonne volonté de chacun. La méthode robuste consiste à imposer la règle dans le dépôt lui-même, via un fichier .gitattributes qui s’applique à tout le monde quels que soient ses réglages locaux. C’est indispensable dès qu’une équipe mélange Windows et Linux — et c’est justement notre cas.
Nous le mettrons en place en section 5. En attendant, core.autocrlf suffit.
Quelques réglages de confort
Le comportement de la récupération
git config --global pull.rebase false
Sans ce réglage, Git affiche un avertissement à chaque récupération pour vous demander de choisir une stratégie. false correspond au comportement classique, celui que nous utiliserons en section 3.
Des raccourcis
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.lg "log --oneline --graph --decorate --all"
Le dernier est le plus utile : git lg affiche l’historique sous forme de graphe compact, sur une ligne par enregistrement. Vous l’utiliserez tous les jours.
La stratégie de conservation des identifiants
Sous Windows, le Credential Manager installé par défaut fait le travail. Sous Linux, pour éviter de ressaisir un jeton à chaque échange :
git config --global credential.helper "cache --timeout=3600"
Les identifiants restent en mémoire une heure. Nous verrons en section 3 que les clés SSH évitent totalement cette question — c’est la méthode que je vous recommanderai.
Vérifier votre configuration
git config --list --show-origin
L’option --show-origin est précieuse : elle indique de quel fichier provient chaque valeur. C’est ce qui vous permettra, le jour où un réglage se comporte bizarrement, de comprendre qu’il est surchargé au niveau du dépôt ou du système.
Pour interroger un seul paramètre :
git config user.email
Vos réglages personnels sont dans ~/.gitconfig (ou C:\Users\<vous>\.gitconfig). C’est un simple fichier texte, que vous pouvez éditer directement — et qui constitue, soit dit en passant, un excellent premier candidat au pattern ① : beaucoup d’administrateurs versionnent leur .gitconfig avec leurs autres fichiers de configuration personnels, pour les retrouver à l’identique sur chaque machine.
Deux cas particuliers d’entreprise
Derrière un proxy
Fréquent, et bloquant tant que ce n’est pas réglé :
git config --global http.proxy http://proxy.nordika.local:8080
git config --global https.proxy http://proxy.nordika.local:8080
Si le proxy exige une authentification, résistez à la tentation d’écrire vos identifiants dans l’URL : ils se retrouveraient en clair dans votre ~/.gitconfig. Privilégiez un proxy qui accepte l’authentification intégrée, ou utilisez SSH plutôt que HTTPS pour joindre la forge — solution que nous mettrons en place en section 3.
Pour exclure votre forge interne du proxy, la variable d’environnement NO_PROXY s’applique comme pour vos autres outils.
Face à un certificat interne
Votre forge, en section 2, sera probablement publiée avec un certificat émis par votre autorité interne. Git refusera alors la connexion en HTTPS, avec une erreur de vérification de certificat.
Le mauvais réflexe, que vous trouverez partout sur les forums :
git config --global http.sslVerify false # ❌ NON
Cette commande désactive la vérification TLS pour tous vos dépôts, partout. Vous supprimez la protection contre l’interception là où vous vouliez juste faire confiance à votre propre autorité.
Le bon réflexe : installer le certificat de votre autorité interne dans le magasin de la machine — ce que vous savez déjà faire, et ce qui règle le problème pour Git comme pour tous vos autres outils. À défaut, désignez explicitement le fichier :
git config --global http.sslCAInfo /etc/ssl/certs/ca-nordika.pem
Nous reviendrons sur ce point en section 2, au moment de publier la forge.
Récapitulatif : la configuration de départ
À copier-coller, en adaptant les deux premières lignes :
git config --global user.name "Prénom Nom"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main
git config --global core.editor "code --wait"
git config --global pull.rebase false
git config --global alias.lg "log --oneline --graph --decorate --all"
# Windows
git config --global core.autocrlf true
# Linux / macOS
git config --global core.autocrlf input
« Je vais devoir taper des commandes toute ma vie ? »
Non. Mais commencez par là quand même — pour trois raisons qui vous concernent particulièrement.
Les commandes épousent le modèle mental. Vous verrez dans la prochaine leçon que git add correspond exactement au plateau de montage, et git commit au registre. Une interface graphique masque cette mécanique : très confortable quand on l’a comprise, franchement déroutante avant.
Sur un serveur, il n’y aura pas d’interface. En sections 6 et 8, nous travaillerons directement sur des serveurs Debian, en SSH. Aucune fenêtre à cliquer.
Toute l’aide que vous trouverez est en commandes. Le jour où quelque chose se passe mal, les réponses des forums, de la documentation et de nos fiches de dépannage sont des lignes de commande. Savoir les lire n’est pas optionnel.
Cela dit — et c’est mon cas — rien ne vous oblige à rester en ligne de commande une fois les bases acquises. J’ai appris au terminal, et j’utilise aujourd’hui un client graphique au quotidien pour le confort : voir d’un coup d’œil ce qui a changé, cocher les fichiers à enregistrer, lire un historique sous forme de graphe. C’est plus rapide, et il n’y a aucun mérite à s’en priver.
Il en existe plusieurs, gratuits comme payants — VS Code dispose d’ailleurs déjà de tout le nécessaire, et vous l’avez probablement installé. Nous ferons le tour de la question en leçon 3.9, une fois que vous saurez ce qu’est un enregistrement et une branche : à ce moment-là, les interfaces deviendront lisibles.
Ce qu’il faut retenir
- Nous avons installé Git le logiciel, pas la forge — vous pouvez déjà tout faire en local.
- La configuration se lit à trois niveaux : système, utilisateur, dépôt. Le plus spécifique l’emporte.
user.nameetuser.emailsont obligatoires et figureront définitivement dans chaque enregistrement.- Réglez l’éditeur avant de vous retrouver coincé dans Vim.
core.autocrlfévite les différences fantômes et les scripts Bash inexécutables —.gitattributesprendra le relais en section 5.- Face à un certificat interne, installez votre autorité ; ne désactivez jamais la vérification TLS globalement.
Dans la leçon suivante
Tout est prêt. Nous allons enfin manipuler.
Dans la leçon 1.7, vous créerez votre premier dépôt sur un vrai script d’administration, vous enregistrerez une première version, vous modifierez le script, vous enregistrerez la suivante — puis vous consulterez l’historique et retrouverez précisément ce qui a changé entre les deux.
Cinq commandes, une quinzaine de minutes, et le schéma des trois zones de la leçon 1.1 va enfin prendre tout son sens.