Installer et configurer Git sur Linux, macOS et Windows

Ce guide vous accompagne de l’installation de Git jusqu’à sa configuration complète. En 10 minutes, vous aurez un Git fonctionnel avec votre identité configurée, votre éditeur préféré associé et quelques alias pour gagner du temps au quotidien.

Prérequis : avoir compris le modèle Git (snapshots, 3 états). Aucun logiciel préalable n’est requis.

Ce que vous allez apprendre

• Installer Git sur Linux, macOS et Windows
• Configurer votre identité (nom et email associés à vos commits)
• Choisir votre éditeur pour les messages de commit
• Comprendre les 3 niveaux de configuration (système, global, local)
• Créer des alias pour les commandes les plus fréquentes

Installer Git

Linux (Debian/Ubuntu)

Sur les distributions basées sur Debian, installez Git depuis le dépôt officiel PPA pour obtenir la dernière version :

sudo apt update
sudo apt install git

Pour obtenir la toute dernière version de Git :

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git

Linux (Fedora/RHEL)

sudo dnf install git

macOS

Sur macOS, Git est souvent préinstallé avec les Xcode Command Line Tools. Vérifiez d’abord s’il est déjà présent :

git --version

S’il n’est pas installé, macOS vous proposera de l’installer. Vous pouvez aussi l’installer via Homebrew pour avoir la dernière version :

brew install git

Windows

Téléchargez l’installeur depuis le site officiel : git-scm.com/download/win.

Lancez l’installeur et conservez les options par défaut. L’installation inclut Git Bash, un terminal qui vous permet d’utiliser les mêmes commandes que sur Linux.

Vous pouvez aussi installer Git via winget (Windows Package Manager) :

winget install --id Git.Git -e --source winget

Vérifier l’installation

Quelle que soit votre plateforme, vérifiez que Git est correctement installé :

git --version

Sortie attendue :

git version 2.47.1

Version minimale recommandée

Ce guide utilise des commandes disponibles depuis Git 2.23 (août 2019), notamment git switch et git restore. Si votre version est antérieure, mettez à jour Git avant de continuer.

Comprendre les 3 niveaux de configuration

Git utilise un système de configuration à 3 niveaux, du plus large au plus spécifique. Chaque niveau peut écraser les valeurs du niveau précédent.

Niveau	Portée	Fichier	Option
System	Tous les utilisateurs de la machine	/etc/gitconfig	--system
Global	Votre compte utilisateur	~/.gitconfig	--global
Local	Un seul dépôt	.git/config	--local

Glissez pour voir

Analogie

Pensez aux niveaux de configuration comme à des vêtements superposés. Le niveau system, c’est l’uniforme de l’entreprise (pour tout le monde). Le niveau global, c’est votre style vestimentaire personnel. Le niveau local, c’est la tenue que vous portez pour un événement précis. La couche la plus spécifique l’emporte sur les autres.

En pratique, vous utiliserez principalement --global pour vos paramètres personnels et --local pour les exceptions spécifiques à un projet.

Voir la configuration actuelle

Pour afficher toute votre configuration et savoir d’où vient chaque valeur :

git config --list --show-origin

Sortie attendue (exemple) :

file:/home/bob/.gitconfig       user.name=Stéphane ROBERT
file:/home/bob/.gitconfig       user.email=stephane@example.com
file:/home/bob/.gitconfig       core.editor=code --wait
file:/home/bob/.gitconfig       init.defaultbranch=main
file:.git/config                core.repositoryformatversion=0
file:.git/config                core.bare=false

L’option --show-origin indique le fichier source de chaque paramètre. C’est indispensable pour déboguer les conflits de configuration.

Configurer votre identité

La première chose à faire après l’installation est de configurer votre nom et votre email. Ces informations sont inscrites dans chaque commit que vous créez. Elles ne sont pas modifiables après coup.

1. Définir votre nom :

   git config --global user.name "Votre Nom"

2. Définir votre email :

   git config --global user.email "votre@email.com"

3. Vérifier la configuration :

   git config user.name
   git config user.email

   Sortie attendue :

   Votre Nom
   votre@email.com

Email et plateformes Git

Si vous utilisez GitHub ou GitLab, utilisez l’email associé à votre compte. C’est cette adresse qui permet à la plateforme de relier vos commits à votre profil. Sur GitHub, vous pouvez utiliser votre email privé username@users.noreply.github.com pour ne pas exposer votre adresse personnelle.

Configuration minimale obligatoire

user.name et user.email sont les deux seules configurations obligatoires pour utiliser Git. Tout le reste (éditeur, couleurs, alias…) est optionnel. Si vous manquez de temps, arrêtez-vous là.

Configurer votre éditeur

Quand Git a besoin que vous écriviez un message (commit, merge, rebase), il ouvre un éditeur de texte. Par défaut, c’est souvent vi ou nano. Pour utiliser votre éditeur préféré :

VS Code

git config --global core.editor "code --wait"

L’option --wait indique à Git d’attendre que vous fermiez l’onglet dans VS Code avant de continuer.

nano

git config --global core.editor "nano"

vim

git config --global core.editor "vim"

Vérification : créez un commit vide pour tester l’ouverture de l’éditeur (vous pourrez annuler en fermant sans sauvegarder) :

git config --global core.editor

Sortie attendue :

code --wait

Configurer la branche par défaut

Depuis Git 2.28, vous pouvez définir le nom de la branche créée par git init. La convention moderne est d’utiliser main :

git config --global init.defaultBranch main

Sans cette configuration, Git crée une branche nommée master. Les deux noms sont fonctionnellement identiques, mais main est devenu le standard sur GitHub, GitLab et la plupart des projets récents.

Créer des alias utiles

Les alias permettent de créer des raccourcis pour les commandes que vous utilisez le plus souvent. Voici les alias les plus populaires :

git config --global alias.st status
git config --global alias.co switch
git config --global alias.ci commit
git config --global alias.br branch
git config --global alias.lg "log --oneline --graph --all --decorate"

Avec ces alias, vous pouvez taper :

git st      # au lieu de git status
git co main # au lieu de git switch main
git lg      # log visuel avec branches

Testez l’alias lg qui est particulièrement utile :

git lg

Sortie attendue (dans un dépôt avec quelques commits) :

* e4a1c0f (HEAD -> main) Ajout de la page de contact
* a3b7d2e Création de la structure du projet
* 1f2d3e4 Initial commit

Astuce

Pour voir tous vos alias configurés :

git config --get-regexp alias

Configuration SSH (recommandée)

Pour éviter de taper votre mot de passe à chaque push et pull, configurez une clé SSH. C’est la méthode recommandée pour se connecter à GitHub, GitLab et autres services Git.

1. Vérifier si une clé existe déjà :

   ls -la ~/.ssh/id_ed25519.pub

   Si le fichier existe, vous avez déjà une clé. Passez à l’étape 3.

2. Générer une nouvelle clé (si nécessaire) :

   ssh-keygen -t ed25519 -C "votre@email.com"

   Appuyez sur Entrée pour accepter l’emplacement par défaut. Choisissez une passphrase pour protéger votre clé.

3. Copier la clé publique :

   cat ~/.ssh/id_ed25519.pub

   Copiez la sortie complète et ajoutez-la dans les paramètres SSH de votre service Git (GitHub : Settings → SSH and GPG keys → New SSH key).

4. Tester la connexion :

   ssh -T git@github.com

   Sortie attendue :

   Hi username! You've successfully authenticated, but GitHub does not provide shell access.

SSH vs HTTPS

SSH est recommandé car vous n’avez plus besoin de saisir vos identifiants à chaque opération. HTTPS est plus simple à configurer initialement, mais nécessite un gestionnaire de credentials ou un token personnel. Pour plus de détails sur la sécurité, consultez secrets dans le code.

Résumé de la configuration recommandée

Voici l’ensemble des commandes de configuration en une seule séquence :

# Identité
git config --global user.name "Votre Nom"
git config --global user.email "votre@email.com"

# Éditeur
git config --global core.editor "code --wait"

# Branche par défaut
git config --global init.defaultBranch main

# Alias utiles
git config --global alias.st status
git config --global alias.co switch
git config --global alias.ci commit
git config --global alias.br branch
git config --global alias.lg "log --oneline --graph --all --decorate"

Dépannage : problèmes courants

Symptôme	Cause probable	Solution
git: command not found	Git n’est pas installé ou pas dans le PATH	Réinstaller Git. Sur Linux, vérifier avec which git
Commits avec le mauvais email	user.email pas configuré ou mal configuré au bon niveau	git config --global user.email "bon@email.com"
L’éditeur ne s’ouvre pas au commit	core.editor pas configuré ou l’éditeur n’est pas dans le PATH	Vérifier que l’éditeur est accessible en ligne de commande
permission denied (publickey) au push	Clé SSH pas configurée ou pas ajoutée à la plateforme	Vérifier avec ssh -T git@github.com et ajouter la clé
Config locale écrase la config globale	Normal : le niveau local a priorité sur global	Utiliser git config --list --show-origin pour comprendre d’où vient la valeur

Glissez pour voir

À retenir

• 3 niveaux de configuration : system (machine) → global (utilisateur) → local (dépôt). Le plus spécifique gagne.
• Identité obligatoire : configurez user.name et user.email avant votre premier commit.
• Éditeur recommandé : configurez core.editor pour éviter de vous retrouver coincé dans vi.
• Branche par défaut : utilisez main avec init.defaultBranch.
• SSH recommandé : évite de taper son mot de passe à chaque push/pull.
• Alias : git lg (log graphique) et git st (status) font gagner du temps au quotidien.

Prochaines étapes

Créer un dépôt Git Mettez en pratique votre installation : créez votre premier dépôt.

Enregistrer des modifications Apprenez le cycle add → commit pour versionner votre travail.

Le modèle Git : snapshots et 3 états Revenez aux fondamentaux si besoin.

×

📖 Voir la documentation →