Les préfixes d’installation par défaut de Homebrew diffèrent selon le type de processeur : la documentation indique /opt/homebrew pour Apple silicon et /usr/local pour les Mac Intel (guide d’installation Homebrew). Si Homebrew semble installé mais que brew est introuvable, vérifiez d’abord l’installation réelle, puis le préfixe et la configuration de votre shell. Ne relancez pas l’installation et ne modifiez pas les droits système avant ces contrôles.

Symptôme → le terminal répond que brew est introuvable.
Vérification la plus rapide → recherchez la commande avec command -v brew, puis comparez le résultat avec le chemin affiché par l’installateur.

Ce guide s’adresse aux étudiants qui viennent d’installer Homebrew et ne savent pas pourquoi le terminal ne reconnaît pas la commande.
Il vous aidera aussi si vous débutez sur Mac après avoir utilisé Windows et suivez un cours de programmation.
Si votre Mac appartient à votre établissement ou si vous utilisez un Mac distant, vous verrez comment vérifier les droits et les conditions d’accès sans contourner les règles de l’appareil.

Commencez par distinguer une installation terminée d’une commande introuvable

Le message « commande introuvable » ne signifie pas automatiquement que Homebrew n’est pas installé. Le terminal cherche les commandes dans des emplacements configurés ; si l’emplacement de Homebrew n’est pas connu de votre shell, il peut échouer même si le fichier existe bien.

L’installateur officiel indique les étapes de configuration à effectuer après l’installation. Il peut demander d’ajouter une commande brew shellenv à un fichier de configuration du shell. Si vous avez fermé la fenêtre ou sauté ce message, l’installation peut être présente tandis que la configuration nécessaire manque. Consultez les instructions officielles après l’installation avant de recommencer.

Pour éviter de perdre un indice utile, gardez sous la main le texte exact du message final de l’installateur et l’erreur complète du terminal. Une capture ou une copie du texte vous aidera à comparer le préfixe et la commande indiqués. Ne vous contentez pas de noter « ça ne marche pas » : le chemin affiché et l’étape où l’installation s’est arrêtée orientent le diagnostic.

Dans le terminal déjà ouvert, exécutez d’abord :

command -v brew

Si le terminal renvoie un chemin, il a localisé une commande appelée brew. Testez alors :

brew --version

Un numéro de version confirme que cette commande peut démarrer Homebrew. Si command -v brew ne renvoie rien ou si brew --version échoue, poursuivez le diagnostic au lieu de conclure que l’installation a échoué.

Vérification Ce que vous observez Ce que cela indique
command -v brew Un chemin vers brew s’affiche Le shell trouve une commande portant ce nom.
brew --version Une version s’affiche Homebrew démarre depuis ce terminal.
Aucun chemin, mais un fichier existe dans le préfixe réel La commande reste introuvable L’installation peut être présente, mais le shell ne connaît pas son emplacement.
Aucun chemin et aucun fichier au préfixe attendu Le fichier n’est pas trouvé à cet emplacement Vérifiez le message de l’installateur et l’emplacement choisi avant toute nouvelle installation.

Ces résultats ne sont utiles que si vous les interprétez avec le chemin réel de votre installation. Le préfixe par défaut n’est pas une garantie concernant chaque Mac : une installation personnalisée, une configuration scolaire ou une installation ancienne peut utiliser un autre emplacement. Le manuel Homebrew décrit les notions de préfixe et de shellenv (manuel des commandes Homebrew).

À retenir : une commande absente du PATH et un logiciel absent du Mac sont deux situations différentes. Vérifiez le fichier brew avant de choisir une solution.

Repérez le préfixe réel avant de toucher au shell

Le préfixe est le répertoire de base dans lequel Homebrew a été installé. Le PATH, lui, est la liste des emplacements que le shell parcourt lorsqu’il cherche une commande. En d’autres termes, vous pouvez avoir le bon outil au bon endroit, mais un PATH qui ne permet pas au terminal de le trouver.

Sur les Mac Apple silicon, la documentation Homebrew donne /opt/homebrew comme préfixe par défaut ; pour les Mac Intel, elle indique /usr/local (emplacements par défaut Homebrew). Utilisez ces chemins comme repères, pas comme des certitudes. Si l’installateur vous a fourni un autre préfixe, ou si votre établissement a préparé une configuration particulière, c’est ce chemin réel qui doit guider la vérification.

Vous pouvez examiner le répertoire correspondant au message de l’installateur. Par exemple, pour le préfixe par défaut d’Apple silicon, vérifiez si le fichier attendu est présent :

ls -l /opt/homebrew/bin/brew

N’utilisez cette commande que si ce préfixe correspond à votre installation. Pour une installation Intel utilisant le préfixe par défaut, le chemin attendu serait plutôt /usr/local/bin/brew. Si le préfixe indiqué dans vos propres messages est différent, adaptez le chemin en conséquence. La documentation Homebrew décrit ces préfixes et la manière dont brew shellenv fournit au shell les informations nécessaires (manuel Homebrew).

Ne créez pas un dossier brew à la main pour faire disparaître l’erreur. Ne déplacez pas non plus le fichier exécutable vers un autre répertoire : vous pourriez désynchroniser les commandes Homebrew et leur emplacement d’installation.

Vérifiez le shell et sa configuration sans écraser vos réglages

Un shell est le programme qui interprète les commandes saisies dans le terminal. Le fichier de configuration chargé au démarrage dépend du shell choisi et de la manière dont le terminal lance la session. Il n’existe donc pas un fichier unique à modifier sur tous les Mac.

Commencez par afficher le shell associé à votre compte :

echo "$SHELL"

Vous pouvez aussi examiner le réglage de démarrage du terminal. Si vous devez modifier le shell par défaut, vérifiez d’abord que ce changement est nécessaire et qu’il correspond aux instructions de votre cours. Ne changez pas de shell uniquement pour faire disparaître l’erreur de Homebrew.

Retournez ensuite au message final de l’installateur. Repérez la ligne contenant brew shellenv et le fichier de configuration qu’il vous recommande de mettre à jour. Vérifiez que cette ligne correspond bien au préfixe que vous avez trouvé. Si l’installateur a indiqué un fichier précis, suivez cette indication plutôt que de copier une instruction prise dans un tutoriel conçu pour une autre configuration.

La documentation Homebrew explique l’ajout de brew shellenv après l’installation (procédure officielle). Le principe est que le shell charge les informations associées à l’installation quand une nouvelle session démarre. La ligne exacte dépend du préfixe ; une commande faite pour /opt/homebrew ne doit pas être appliquée sans vérification à une installation située ailleurs.

Voici une façon sûre d’avancer :

  • Ouvrez le fichier mentionné par l’installateur dans un éditeur de texte.
  • Vérifiez s’il contient déjà une ligne brew shellenv cohérente avec le préfixe réel.
  • Si elle manque, ajoutez uniquement l’instruction indiquée par l’installateur ou la documentation officielle.
  • Enregistrez le fichier sans supprimer les autres réglages.
  • Rouvrez un terminal pour tester la configuration chargée au démarrage.

Si vous ne savez pas quel éditeur employer, demandez de l’aide avant de remplacer le fichier entier. Une configuration de shell peut contenir d’autres réglages utiles pour vos cours, vos outils ou vos projets.

Important : n’exécutez pas un script trouvé au hasard et ne lancez pas de commandes de modification avec des privilèges administrateur pour contourner une erreur de chemin. Homebrew fournit sa procédure de configuration ; partez de celle-ci et gardez une copie du fichier avant de l’éditer.

Utilisez cette branche de décision pour choisir la suite

Suivez la branche qui correspond à ce que vous avez observé. Le but est de réparer la cause la plus probable sans transformer un problème de configuration en problème de permissions.

  • Si command -v brew renvoie un chemin et brew --version fonctionne, l’installation est utilisable depuis cette session. Ouvrez un nouveau terminal pour vérifier que ce résultat persiste.
  • Si command -v brew ne renvoie rien, mais que le fichier brew existe au préfixe confirmé, ne réinstallez pas. Vérifiez le shell utilisé, puis la ligne shellenv dans le fichier indiqué par l’installateur.
  • Si le fichier n’existe pas au préfixe que vous avez testé, ne concluez pas encore à une panne. Vérifiez si le préfixe est celui de votre installation et relisez le message final de l’installateur. Une installation personnalisée peut ne pas se trouver au chemin par défaut.
  • Si l’installateur s’est interrompu ou n’a pas fourni de confirmation exploitable, consultez la procédure officielle d’installation et son état actuel avant de la reprendre (documentation d’installation Homebrew).
  • Si le Mac est administré par votre établissement et que vous ne pouvez pas modifier le fichier, arrêtez-vous là. Demandez à l’administrateur si l’installation et la modification de la configuration sont autorisées, sans chercher à augmenter vos droits.

Cette méthode a un avantage simple : elle isole le diagnostic en séparant présence du fichier, visibilité depuis le shell et autorisation de modifier la configuration. Sa limite est qu’elle ne résout pas une politique de gestion imposée par l’école. Dans ce cas, l’étape suivante est une demande à l’administrateur, pas une tentative de contournement.

Placez les questions fréquentes après le diagnostic de configuration

Pourquoi le terminal ne reconnaît-il pas Homebrew après l’installation ?

Le plus souvent, le shell ne voit pas le répertoire qui contient brew, ou la ligne de configuration demandée à la fin de l’installation n’a pas été chargée. La présence d’un message d’erreur ne suffit pas à trancher. Comparez le chemin obtenu avec command -v brew, le fichier réellement présent et le préfixe que l’installateur vous a donné.

Comment savoir si Homebrew est déjà installé sur le Mac ?

Lancez command -v brew. Si un chemin s’affiche, essayez brew --version. Si aucun chemin ne s’affiche, examinez le fichier exécutable au préfixe réel de votre installation. Les préfixes par défaut diffèrent selon l’architecture du Mac, mais une installation personnalisée ou gérée par un établissement peut utiliser un autre emplacement.

Quel fichier doit contenir la configuration de Homebrew ?

Le bon fichier dépend du shell lancé par votre terminal et des instructions affichées à la fin de l’installation. Vérifiez la valeur retournée par echo "$SHELL" et relisez l’instruction shellenv correspondant au préfixe utilisé. Ne copiez pas un nom de fichier ou une ligne de commande trouvés dans un guide qui ne correspond pas à votre configuration.

Pourquoi brew reste-t-il introuvable dans un nouveau terminal ?

Une modification temporaire dans une fenêtre ne garantit pas qu’une nouvelle session chargera la même configuration. Fermez et rouvrez le terminal, puis retestez command -v brew. Si l’erreur revient, vérifiez que le terminal lance le shell attendu, qu’il lit le fichier modifié et que la ligne shellenv correspond toujours au chemin réel de Homebrew.

Rouvrez le terminal et vérifiez que le correctif tient

Une fois la configuration relue, ouvrez une nouvelle fenêtre de terminal. Cette vérification permet de distinguer une commande qui fonctionne uniquement dans la session actuelle d’un réglage chargé à l’ouverture. La documentation Apple explique les bases d’utilisation du terminal et de ses sessions (guide d’utilisation du terminal).

Dans ce nouveau terminal, exécutez de nouveau :

command -v brew
brew --version

Si les deux commandes réussissent, essayez ensuite l’action Homebrew prévue par votre cours. Ne vous limitez pas à l’affichage de la version si votre objectif est d’installer un outil pour un projet : vérifiez que la commande du cours est reconnue et que le résultat attendu apparaît. Vous validerez ainsi la chaîne complète : terminal lancé, configuration chargée, Homebrew disponible, exercice réalisable.

Si l’erreur persiste, reprenez le diagnostic dans cet ordre :

  • Shell : le terminal démarre-t-il le shell que vous avez vérifié ?
  • Fichier de configuration : avez-vous modifié celui qui est réellement utilisé au démarrage ?
  • Préfixe : le chemin de brew shellenv correspond-il à l’emplacement observé ?
  • Droits : l’appareil vous autorise-t-il à enregistrer ce fichier ?

Homebrew recommande de procéder par vérifications ciblées en cas de problème, plutôt que d’appliquer des changements sans rapport avec l’erreur (guide officiel de dépannage). Ses notes sur les problèmes courants abordent également les chemins et les installations multiples, qui peuvent expliquer qu’une commande pointe vers un emplacement inattendu (problèmes courants Homebrew).

Sur un Mac d’école, l’absence de droits de modification est une limite de gestion, pas un signal vous autorisant à contourner les réglages. Notez l’erreur et les chemins obtenus, puis demandez à l’administrateur si Homebrew est permis et quelle configuration employer. Vous pouvez continuer les exercices indépendants de Homebrew en attendant, si votre cours propose cette possibilité.

Choisissez un environnement adapté si le Mac actuel vous bloque

Si Homebrew est simplement absent du PATH, corrigez la configuration locale avec la procédure officielle : vous n’avez pas besoin de changer d’ordinateur. En revanche, si vous n’avez pas accès à un Mac, si l’appareil scolaire interdit les modifications nécessaires ou si votre cours demande un outil réservé à macOS, séparez le problème logiciel du problème d’environnement.

Un ordinateur Windows reste adapté à de nombreux exercices de programmation. Son avantage est que vous pouvez continuer vos cours sans réorganiser votre configuration ; sa limite apparaît lorsque l’exercice dépend spécifiquement de macOS ou de ses outils. Une machine virtuelle ou une configuration personnelle peut aussi demander des réglages et des droits que vous n’avez pas sur un appareil d’école. Avant de choisir, vérifiez la consigne du cours et la possibilité de conserver les fichiers et le travail produits.

Pour une séance ou un projet temporaire qui exige un vrai environnement macOS, une machine Mac distante peut éviter l’achat immédiat d’un ordinateur. MACCOME présente ses options de Mac distant accessible pour vos travaux. Avant de vous engager, vérifiez que vous pourrez ouvrir un terminal, effectuer les opérations autorisées par votre cours, conserver ou récupérer vos fichiers et utiliser les outils demandés. Le contrôle doit porter sur votre exercice réel : l’accès à un Mac ne garantit pas à lui seul que chaque logiciel ou politique de votre établissement sera compatible.

La comparaison est donc concrète. Votre configuration actuelle peut être limitée par l’absence de macOS, les restrictions de l’école ou un accès administrateur refusé ; mais si seul le fichier de shell est mal configuré, un Mac distant ne corrigera pas ce réglage local. Commencez par les vérifications de ce guide. Si vous avez besoin d’un environnement Mac temporaire pour poursuivre un cours et que votre ordinateur ne peut pas en fournir un, examinez les conditions de location d’un Mac distant avec MACCOME et validez votre outil de cours avant de choisir.