VS Code est installé, mais son panneau de contrôle de code source indique que Git est introuvable.
La solution la plus rapide est de lancer git --version avant toute installation. Pour installer Git 2.55 sur Mac, utilisez d’abord Xcode Command Line Tools pour un cours classique ; choisissez Homebrew uniquement si votre cours ou votre outillage exige explicitement une version plus récente. La configuration ne sera considérée comme terminée qu’après l’ajout de votre nom, de votre adresse électronique et la réussite d’un commit de test.
Dernière mise à jour : 8 septembre 2026. Les informations de version et les chemins d’installation ont été vérifiés à partir de la page officielle d’installation de Git pour macOS, ainsi que des documentations officielles de Git, Apple, GitHub et VS Code.
01 Pour qui est ce tutoriel
Ce guide s’adresse aux étudiants qui utilisent Git pour la première fois sur un Mac et hésitent entre Xcode Command Line Tools et Homebrew. Il convient aussi aux personnes qui travaillent sur un Mac distant ou sur un ordinateur d’établissement afin de sauvegarder leurs exercices dans un dépôt autorisé.
Si VS Code est déjà installé mais ne détecte pas Git, vous trouverez également une procédure de vérification. Le but n’est pas de mémoriser toutes les commandes Git. Il est de disposer d’un environnement vérifiable pour enregistrer un devoir sans perdre votre travail.
02 Le contrôle initial
Avant d’installer quoi que ce soit, ouvrez l’application Terminal. Vous pouvez la rechercher avec Spotlight ou la trouver dans le dossier des applications du Mac. Apple décrit les fonctions de base de Terminal dans son guide officiel consacré à l’utilisation de Terminal.
Dans la fenêtre du Terminal, saisissez :
git --version
La commande officielle de vérification de version est documentée par Git dans la référence de git version. Le résultat peut prendre plusieurs formes :
- une version Git s’affiche : Git est déjà accessible depuis ce Terminal ;
- macOS propose d’installer les outils de développement : vous pouvez accepter cette proposition si vous êtes autorisé à installer des composants ;
- un message indique que la commande est introuvable : passez à la route d’installation adaptée ;
- une version apparaît, mais votre cours exige précisément Git 2.55 : ne concluez pas encore que la version actuelle suffit. Comparez la demande du cours avec le résultat réellement affiché.
Imaginez que Git soit un manuel de cours dans votre sac. La présence d’un manuel ne prouve pas qu’il s’agit de la bonne édition. De la même manière, « Git est installé » et « le Terminal utilise la version attendue » sont deux vérifications distinctes.
Vous pouvez aussi afficher le chemin du programme utilisé :
which git
Cette commande permet de repérer le programme appelé par votre Terminal. Le chemin obtenu dépend de l’installation présente sur votre Mac. Ne supprimez pas un dossier et ne modifiez pas les répertoires protégés uniquement parce que le chemin vous semble inhabituel.
Mac possède-t-il déjà Git, ou faut-il le réinstaller ?
Pas nécessairement. Si git --version affiche une version compatible avec votre cours et si un commit de test fonctionne, une nouvelle installation n’apporte rien. Réinstallez seulement si la commande est absente, si les outils requis manquent ou si une version plus récente est explicitement demandée.
03 Le choix de la méthode
La page officielle de Git pour macOS indique plusieurs routes, notamment Xcode Command Line Tools et Homebrew. La version affichée sur cette page au 8 septembre 2026 est Git 2.55.0 ; le résultat obtenu après installation doit toutefois être vérifié sur votre propre Mac, car une route donnée peut fournir une version différente selon le moment et l’environnement.
Voici le choix à faire avant de saisir une commande :
| Situation | Méthode conseillée | Pourquoi | Condition d’arrêt |
|---|---|---|---|
| Cours d’initiation, devoirs classiques, usage courant de VS Code | Xcode Command Line Tools | Route adaptée aux outils de développement de base de macOS | Arrêtez-vous lorsque git --version fonctionne et qu’un commit de test est possible |
| Cours demandant explicitement Git 2.55 ou une version récente | Homebrew | Permet de gérer Git comme un paquet séparé | Vérifiez la version après l’installation ; ne supposez pas qu’elle correspond à la demande |
| Vous utilisez déjà Homebrew pour plusieurs outils | Homebrew | Gestion centralisée des outils installés par ce gestionnaire | Ne l’installez pas uniquement par habitude si le cours n’en a pas besoin |
| Vous ne disposez pas des droits nécessaires | Demandez l’autorisation ou utilisez un Mac autorisé | Une installation forcée peut casser la configuration de l’établissement | N’exécutez aucun script inconnu et ne contournez pas les restrictions |
Xcode Command Line Tools
Pour un débutant, cette route est généralement la plus simple lorsque le cours demande Git, un éditeur et quelques outils de programmation. Lorsque macOS affiche une fenêtre proposant les outils de développement, vérifiez le nom du composant avant de confirmer.
Vous pouvez également consulter les instructions de la page officielle d’installation de Git pour Mac. Une fois l’installation terminée, fermez puis rouvrez Terminal et exécutez :
git --version
which git
L’installation n’est pas validée parce qu’une fenêtre s’est fermée. Elle est validée lorsque le Terminal répond à la commande et que le chemin est exploitable.
Homebrew
Choisissez cette route si votre enseignant, votre projet ou votre environnement de développement demande une version récente de Git, ou si vous utilisez déjà Homebrew pour maintenir vos outils. La page officielle de Git indique la commande Homebrew appropriée :
brew install git
Utilisez uniquement les instructions provenant de la documentation officielle de Git ou de votre installation Homebrew déjà approuvée. Ne copiez pas une commande trouvée dans un commentaire, une vidéo ou une page inconnue. Après l’installation, contrôlez la version :
git --version
which git
Si une version inattendue apparaît, ne désinstallez pas immédiatement l’autre Git. Le problème peut venir du chemin de recherche du Terminal, appelé PATH. Le PATH est une liste de dossiers dans lesquels le système cherche les commandes, comparable à un itinéraire indiquant quelle salle consulter en premier.
Quelle différence entre Command Line Tools et Homebrew pour Git ?
Xcode Command Line Tools fournit les outils de développement Apple nécessaires à de nombreux usages courants. Homebrew installe et gère Git comme un paquet distinct. Pour un devoir standard, commencez par Command Line Tools ; pour une exigence de version ou une maintenance déjà organisée avec Homebrew, choisissez cette seconde route.
04 La configuration de votre identité
Git doit associer chaque commit à un nom et à une adresse électronique. Ces informations sont enregistrées dans l’historique du projet. Elles ne constituent pas votre mot de passe et ne remplacent pas l’authentification auprès d’une plateforme de dépôt.
Pour définir une identité générale, utilisez les commandes suivantes :
git config --global user.name "Votre nom"
git config --global user.email "votre-adresse@example.com"
La procédure est expliquée dans le chapitre Pro Git consacré à la première configuration. Remplacez les valeurs d’exemple par les informations que vous souhaitez voir apparaître dans vos commits.
Faut-il obligatoirement inscrire son vrai nom et son adresse personnelle ?
Vous devez fournir une identité cohérente avec les règles de votre cours et du dépôt utilisé, mais vous n’avez pas à publier une adresse privée si ce n’est pas nécessaire. Vérifiez la politique de votre établissement. Si une adresse étudiante est demandée, utilisez-la seulement dans le cadre prévu et ne diffusez pas votre mot de passe.
Contrôlez la configuration :
git config --global user.name
git config --global user.email
Vous pouvez aussi choisir un nom de branche initiale :
git config --global init.defaultBranch main
Cette préférence concerne le nom créé lors de l’initialisation d’un nouveau dépôt. Elle ne modifie pas automatiquement les branches déjà présentes. Si votre cours impose un autre nom, suivez la consigne du cours.
L’identité Git et l’accès à un dépôt sont deux sujets différents. Pour vous connecter à un service de dépôt, vous pouvez utiliser HTTPS ou SSH selon les instructions du projet. Les explications officielles sur les méthodes d’authentification à GitHub distinguent bien l’identification du compte et les informations inscrites dans les commits.
Ne partagez jamais une clé privée, un jeton d’accès ou un mot de passe dans un fichier de cours. Les instructions officielles relatives aux jetons personnels expliquent leur rôle et les précautions associées.
Attention : une commande
git configne vous connecte pas à un dépôt distant. Elle prépare l’auteur du commit. La connexion sera vérifiée séparément, au moment où vous récupérerez ou enverrez un dépôt autorisé.
05 Le dépôt de test
Ne commencez pas directement avec votre devoir noté. Créez d’abord un petit dossier que vous pourrez supprimer.
mkdir git-test
cd git-test
git init
La commande git init crée les éléments nécessaires pour transformer le dossier en dépôt Git. Les notions de dépôt et de création de dépôt sont détaillées dans le chapitre Pro Git consacré aux dépôts.
Ajoutez un fichier simple :
printf "Premier test Git\n" > README.md
git status
git status doit vous signaler que README.md n’est pas encore suivi. Ajoutez-le à la prochaine zone de préparation :
git add README.md
git status
Puis créez le premier point d’archive :
git commit -m "Premier commit de test"
Enfin, affichez l’historique :
git log --oneline
Votre résultat est satisfaisant si vous pouvez observer le fichier, son passage dans la zone de préparation, puis son commit dans l’historique. Vous avez alors vérifié davantage qu’un simple numéro de version : Git peut créer un dépôt, suivre une modification et enregistrer un état du projet.
Si Git réclame de nouveau votre nom ou votre adresse, revenez à la section précédente. Si le commit est refusé par une règle du cours, conservez le message d’erreur et ne modifiez pas plusieurs réglages au hasard.
06 La vérification dans VS Code
Ouvrez le dossier git-test dans VS Code, et non le dossier parent. Le panneau de contrôle de code source devrait reconnaître le dépôt et afficher les changements lorsque vous modifiez README.md.
La documentation de VS Code sur le contrôle de code source précise que l’éditeur utilise le système de contrôle de version installé sur la machine. VS Code n’installe donc pas automatiquement une copie indépendante de Git pour remplacer celle du Mac.
Modifiez le fichier, enregistrez-le, puis observez le panneau de contrôle de code source. Vous pouvez également ouvrir le Terminal intégré de VS Code et lancer :
git --version
git status
Ces commandes permettent de comparer le Git trouvé dans le Terminal classique avec celui utilisé dans le dossier ouvert. Le guide de démarrage de VS Code présente le principe de suivi d’une modification et de création d’un commit depuis l’éditeur.
Pourquoi le Terminal trouve Git alors que VS Code affiche une erreur ?
Le plus souvent, l’éditeur n’a pas encore été redémarré après l’installation, le mauvais dossier est ouvert ou le chemin de Git n’est pas celui attendu. Fermez puis rouvrez VS Code, ouvrez le dossier du dépôt et vérifiez Git dans le Terminal intégré. Si l’erreur persiste, consultez le guide officiel de dépannage Git de VS Code plutôt que de modifier des dossiers système.
07 Les problèmes de chemin et d’accès
Pourquoi le Terminal indique-t-il encore que Git est introuvable après l’installation ?
Commencez par fermer et rouvrir Terminal, puis relancez git --version et which git. Une session ouverte avant l’installation peut ne pas refléter immédiatement l’environnement modifié. Si la commande reste absente, vérifiez que l’installation est réellement terminée et que vous avez le droit d’utiliser les outils sur cet ordinateur.
Sur un Mac d’établissement, vous pouvez ne pas avoir l’autorisation d’installer Command Line Tools ou Homebrew. N’essayez pas de contourner la gestion de l’appareil, de modifier un répertoire protégé ou de lancer un installateur dont la source n’est pas vérifiée. Demandez à l’enseignant quelle solution est autorisée, ou utilisez un environnement Mac sur lequel vous disposez des droits requis.
Sur un Mac distant, distinguez trois éléments :
- le dossier du projet enregistré sur la machine distante ;
- l’identité Git configurée dans cette session ;
- la copie du projet conservée dans un dépôt ou exportée ailleurs.
Le compte distant peut expirer alors que le fichier local est toujours présent. Un commit local n’est pas automatiquement une sauvegarde externe. Avant la fin de votre période d’accès, envoyez le dépôt vers l’emplacement autorisé par votre cours ou exportez une copie complète du projet. Ne stockez pas de jeton ou de clé privée dans le dossier à exporter.
Comment conserver un projet Git sur un Mac distant avant la fin de l’accès ?
Commitez d’abord les fichiers nécessaires, puis envoyez le dépôt vers l’emplacement autorisé par votre cours ou copiez le projet vers un stockage approuvé. Contrôlez ensuite que les fichiers et l’historique sont bien récupérables depuis une autre session. Ne considérez pas le dossier présent sur le Mac distant comme votre unique sauvegarde.
Si vous utilisez CALMVPS pour travailler sur un Mac distant, vous pouvez consulter la présentation française de l’accès Mac avant de déplacer un projet de cours. Pour examiner les options disponibles, la page française des offres peut vous aider à vérifier la durée d’accès adaptée à votre travail. La décision doit venir après le test de Git, pas avant : commencez par confirmer que l’édition, le commit et la copie du projet fonctionnent.
08 La liste de validation finale
Avant d’ouvrir votre projet officiel, cochez chaque point :
- [ ]
git --versionaffiche une version lisible ; - [ ]
which gitindique le programme appelé par le Terminal ; - [ ] la méthode choisie correspond à la demande du cours ;
- [ ]
user.nameetuser.emailsont définis correctement ; - [ ] un dépôt de test a été initialisé ;
- [ ] un fichier a été ajouté avec
git add; - [ ] un premier commit apparaît dans
git log; - [ ] VS Code reconnaît le dossier comme dépôt ;
- [ ] la modification d’un fichier apparaît dans le panneau de contrôle de code source ;
- [ ] le projet peut être copié vers l’emplacement autorisé avant l’expiration d’un Mac distant.
Si un point échoue, arrêtez-vous à cette étape. Vous gagnerez du temps en corrigeant une seule cause à la fois plutôt qu’en réinstallant Git sans diagnostic.
Pour un étudiant qui travaille sur un ordinateur Windows ou une machine d’école verrouillée, un Mac distant avec les droits nécessaires peut servir de poste de secours. Reproduisez d’abord cette procédure sur un petit projet supprimable. Vérifiez ensuite l’édition, le commit et la sauvegarde avant d’y transférer votre devoir officiel.
Le principal défaut d’une machine d’école est le manque de droits d’installation ; celui d’un poste Windows est l’absence de certains outils exclusivement liés à macOS ; celui d’une configuration improvisée est l’incertitude sur le chemin de Git et la conservation des identifiants. La location d’un Mac auprès de CALMVPS peut offrir un environnement macOS complet pour une période d’apprentissage, sans vous obliger à acheter immédiatement un ordinateur. Elle reste moins adaptée si vous avez besoin d’un poste physique permanent, de ports locaux spécifiques ou d’un usage intensif pendant une longue période.
Une fois le dépôt de test validé, vous pouvez commencer votre projet de cours avec une règle simple : vérifier, configurer, committer, puis sauvegarder.