Homebrew introuvable ? Correctif débutant sur Mac 2026

Le terminal affiche « command not found » après l’installation de Homebrew.

Solution la plus rapide : vérifiez d’abord si l’installation s’est terminée, puis contrôlez le shell actif et son PATH. Si brew fonctionne seulement dans une fenêtre, examinez le fichier de démarrage du shell au lieu de réinstaller Homebrew ou de modifier les droits du système.

Ce guide s’adresse aux élèves qui viennent d’installer Homebrew et ne savent pas pourquoi la commande brew manque.
Il aide aussi les personnes qui suivent un cours de Python ou de développement web et veulent vérifier si leur terminal peut lancer les outils demandés.
Si vous utilisez un Mac à distance, vous pourrez déterminer si le blocage vient de la configuration du terminal ou de l’environnement de développement.

Homebrew introuvable : identifier le type de blocage

Le message d’erreur est un indice, pas un diagnostic complet. Avant de changer un réglage, notez le texte exact de l’erreur et ce que vous veniez de faire. La commande n’a peut-être jamais été installée, le terminal ne sait peut-être pas où la chercher, ou bien brew fonctionne et c’est une autre commande qui échoue.

Ces situations appellent des corrections différentes. Une réinstallation n’est donc pas la bonne première étape.

• L’installation ne s’est pas terminée : l’installateur a affiché une erreur ou le processus s’est interrompu. Dans ce cas, ne considérez pas Homebrew comme installé simplement parce que vous avez commencé la procédure.
• Le terminal répond que brew est introuvable : la commande peut être absente, ou se trouver dans un dossier que le shell ne recherche pas.
• brew est reconnu, mais une commande suivante échoue : le problème concerne peut-être le paquet demandé, un outil de développement nécessaire, ou les permissions d’un fichier. Ce n’est plus forcément un problème de PATH.

Le shell est l’interpréteur qui reçoit vos commandes, un peu comme la personne qui lit vos instructions dans une salle de classe. PATH est sa liste de lieux à consulter pour retrouver les programmes. Le fichier d’initialisation, lui, est le pense-bête que le shell relit lorsqu’il démarre : si une instruction utile n’y figure pas, une correction faite à la main peut disparaître à la fermeture de la fenêtre.

Pour commencer sans modifier votre Mac, ouvrez le terminal et essayez :

command -v brew

Si le terminal affiche un chemin, il trouve brew. Si rien ne s’affiche, notez le shell et le message obtenu, puis poursuivez les vérifications. Vous pouvez également comparer le chemin indiqué par Homebrew avec la documentation officielle de l’installation et de la configuration du shell.

Shell et PATH : vérifications sans modification risquée

Le nom du shell que vous avez configuré et le processus qui traite actuellement vos commandes peuvent différer, notamment si un éditeur ouvre son propre terminal. Pour recueillir des indices, exécutez :

echo "$SHELL"
ps -p $$ -o comm=
printf '%s\n' "$PATH"

La première commande indique le shell associé à votre compte. La deuxième aide à reconnaître le shell actif dans cette fenêtre. La dernière affiche les dossiers recherchés par le shell. Ces commandes ne réparent rien et ne changent pas vos réglages : elles servent à comparer les résultats avec les instructions d’installation.

L’emplacement de Homebrew dépend de l’architecture du Mac. La documentation officielle indique comme préfixes d’installation par défaut /opt/homebrew pour Apple Silicon et /usr/local pour les Mac Intel. Ce sont des chemins à vérifier, pas des valeurs à coller automatiquement : le résultat de votre installation et les instructions affichées pour votre machine priment. Consultez les indications officielles sur le préfixe d’installation et la configuration du shell avant de choisir un chemin.

Si command -v brew ne renvoie rien, vérifiez avec prudence si l’exécutable existe dans le chemin correspondant à votre installation. Par exemple, vous pouvez tester ces emplacements sans rien modifier :

test -x /opt/homebrew/bin/brew && echo "brew présent dans /opt/homebrew/bin"
test -x /usr/local/bin/brew && echo "brew présent dans /usr/local/bin"

Un résultat positif suggère que le programme est présent mais que le shell ne le trouve pas. Un résultat négatif sur ces chemins ne prouve pas, à lui seul, que toute installation est impossible : comparez d’abord avec la sortie de l’installateur et la configuration réelle de votre appareil.

L’installation officielle fournit les instructions destinées à rendre Homebrew accessible depuis le shell, notamment la commande brew shellenv. N’ajoutez pas une ligne copiée d’un tutoriel avant d’avoir confirmé son chemin et le shell concerné. La documentation du manuel de brew décrit les commandes disponibles, tandis que la page d’installation indique comment adapter la configuration au résultat obtenu.

Persistance après fermeture du terminal

Si brew fonctionne dans la fenêtre actuelle mais n’est plus reconnu après l’avoir fermée, la correction est peut-être temporaire. Une commande saisie directement dans le terminal ne modifie pas forcément le fichier relu au prochain démarrage. Le shell repart alors avec sa liste de recherche habituelle, comme un élève qui a oublié de remettre son aide-mémoire dans son sac.

Vérifiez d’abord quel shell utilise cette fenêtre. Pour zsh, examinez le fichier de démarrage recommandé par les instructions Homebrew correspondant à votre cas ; pour un autre shell, utilisez le fichier prévu pour celui-ci. Ne mettez pas la même ligne dans tous les fichiers « au cas où » : cela peut rendre la configuration confuse et compliquer l’identification de la source du problème.

Procédez ainsi :

• Ouvrez les instructions officielles de Homebrew et repérez la commande de configuration correspondant au chemin effectivement installé.
• Vérifiez quel shell est actif et quel fichier d’initialisation il lit dans votre cas.
• Si l’installateur recommande une commande brew shellenv, ajoutez-la uniquement au fichier approprié et en respectant son chemin exact.
• Enregistrez le fichier, puis ouvrez une nouvelle fenêtre de terminal. Vous pouvez aussi recharger le fichier si vous savez précisément lequel vous avez modifié.
• Relancez command -v brew et comparez le résultat avec la fenêtre précédente.

Pour zsh, la ligne indiquée par l’installateur peut ressembler à l’exemple ci-dessous lorsque le chemin installé correspond à celui-ci. Ne la reprenez pas telle quelle si votre installation pointe ailleurs :

eval "$(/opt/homebrew/bin/brew shellenv)"

Le principe est de demander au shell de préparer son environnement à partir de l’installation existante, plutôt que d’écrire manuellement un chemin approximatif. La documentation Installation de Homebrew reste la référence pour choisir la commande et l’emplacement adaptés.

Terminal de l’éditeur et terminal système

Si brew est reconnu dans le terminal de macOS mais pas dans VS Code, l’installation n’est pas nécessairement en cause. L’éditeur peut ouvrir un profil de terminal différent, démarrer le shell d’une autre manière ou utiliser un environnement qui n’a pas récupéré les mêmes réglages. Comparez les résultats directement dans les deux terminaux :

command -v brew
echo "$SHELL"
printf '%s\n' "$PATH"

Si le terminal système affiche un chemin et celui de VS Code n’en affiche aucun, relevez les différences avant de modifier quoi que ce soit. Consultez les profils de terminal de VS Code pour vérifier le profil sélectionné. Sa documentation sur l’environnement du terminal intégré explique aussi les éléments qui peuvent influer sur l’environnement transmis au terminal.

Évitez d’ajouter la même configuration à tous les fichiers de démarrage du shell pour contourner le problème. Une telle accumulation masque souvent la différence entre les profils au lieu de l’expliquer. Commencez par choisir le profil attendu dans l’éditeur, puis rouvrez son terminal intégré et relancez command -v brew. Si la commande est enfin reconnue, utilisez un outil déjà installé dont votre cours a besoin pour confirmer que le terminal peut aussi le lancer.

Pour une formation suivie sur un Mac à distance, la documentation sur les cas d’usage du Mac à distance peut vous aider à déterminer si votre difficulté concerne la configuration locale ou l’environnement de travail. Ce choix ne remplace toutefois pas le diagnostic du shell : vérifiez d’abord si le terminal lui-même trouve brew.

Erreurs de droits et installation interrompue

Un message de permission refusée ne signifie pas que le shell ne trouve pas brew. De même, une erreur signalant un outil de développement manquant ou une installation interrompue ne se corrige pas en changeant PATH. Repérez la commande qui échoue et lisez la totalité du message ; la première ligne seule peut cacher l’étape réellement bloquée.

L’approche la moins risquée consiste à comparer l’erreur avec les consignes de dépannage Homebrew. Le guide officiel Troubleshooting de Homebrew demande de s’appuyer sur les diagnostics pertinents et sur le contexte de l’installation, plutôt que d’appliquer une réparation générique. La FAQ officielle apporte également des précisions sur les problèmes courants.

N’exécutez pas sudo uniquement pour faire disparaître un message, ne changez pas récursivement les droits de répertoires système et ne lancez pas un script dont vous ne connaissez pas l’origine. Ces actions peuvent modifier des fichiers sans traiter la cause ; sur un ordinateur géré par votre établissement, elles peuvent aussi entrer en conflit avec les règles de gestion de l’appareil. Si vous ne disposez pas des droits nécessaires, demandez à la personne responsable de l’ordinateur plutôt que de contourner ses protections.

Décision rapide selon le résultat observé

Cochez les vérifications au fur et à mesure, puis suivez la branche qui correspond au résultat. Cette liste sert à choisir une prochaine étape sûre, et non à appliquer toutes les corrections d’un coup.

• [ ] L’installation s’est interrompue ou affiche une erreur d’installation.
  Alors : notez le message complet et suivez le guide officiel de dépannage. Ne considérez pas brew comme installé tant que l’installation n’a pas abouti.
• [ ] command -v brew ne renvoie rien, mais l’exécutable existe à l’emplacement indiqué par votre installation.
  Alors : vérifiez le shell et PATH, puis appliquez uniquement les indications officielles correspondant au chemin observé. Sinon : revenez à la sortie de l’installateur et vérifiez si l’installation s’est achevée avant de modifier la configuration.
• [ ] brew fonctionne après une modification temporaire, puis disparaît à la fermeture du terminal.
  Alors : contrôlez le fichier d’initialisation lu au démarrage, enregistrez la configuration adaptée et testez dans une nouvelle fenêtre.
• [ ] Le terminal système trouve brew, mais celui de VS Code ne le trouve pas.
  Alors : examinez le profil et l’environnement de l’éditeur, sans dupliquer la configuration dans tous les fichiers.
• [ ] brew est trouvé, mais une autre commande échoue avec une erreur de droits ou de dépendance.
  Alors : traitez le message propre à cette commande selon la documentation officielle. Ne classez pas cette erreur comme un problème de PATH et ne modifiez pas les droits pour faire disparaître l’avertissement.

Si aucune branche ne correspond clairement à votre résultat, arrêtez-vous avant de lancer une commande de réparation. Notez le shell actif, la sortie de command -v brew, le chemin éventuellement trouvé et le texte intégral de l’erreur ; ces éléments permettent de comparer votre situation aux consignes officielles sans multiplier les changements.

Questions fréquentes sur Homebrew

Après l’installation, pourquoi le terminal ne trouve-t-il pas brew ?

L’installation peut s’être interrompue, ou le chemin de Homebrew peut ne pas figurer dans la liste des dossiers parcourus par le shell. Gardez le message final de l’installation, testez command -v brew et comparez le chemin installé aux consignes officielles. N’appliquez pas le chemin d’un autre Mac sans vérifier l’architecture et le shell utilisés.

Faut-il réinstaller Homebrew si la commande est introuvable ?

Pas avant d’avoir vérifié si l’installation s’est terminée et si le fichier de commande existe. Si brew est présent mais invisible pour le shell, une réinstallation ne corrigera pas nécessairement la configuration de PATH. En revanche, si l’installateur a signalé un échec, suivez le diagnostic officiel et ne confondez pas une installation incomplète avec un simple problème de recherche de commande.

Comment éviter que brew disparaisse à la réouverture du terminal ?

Vérifiez si la correction précédente était seulement temporaire, puis identifiez le shell et son fichier d’initialisation pertinent. Ajoutez la configuration recommandée par Homebrew uniquement si le chemin correspond à votre installation. Ouvrez une nouvelle fenêtre pour valider le résultat : une commande saisie dans une fenêtre déjà ouverte ne garantit pas que la configuration sera relue au prochain démarrage.

Que faire si brew fonctionne dans le terminal, mais pas dans VS Code ?

Comparez command -v brew, le shell actif et PATH dans les deux terminaux. Si les résultats diffèrent, vérifiez le profil choisi et les paramètres d’environnement de l’éditeur. Évitez de recopier la même ligne dans plusieurs fichiers de démarrage : cette méthode peut brouiller le diagnostic et ne garantit pas que VS Code lancera le shell avec la configuration souhaitée.

Validation avec une commande de cours

Une fois la configuration corrigée, fermez et rouvrez le terminal avant de conclure. Testez d’abord la présence de la commande :

command -v brew
brew --version

Si ces commandes fonctionnent, Homebrew est joignable depuis cette fenêtre. Pour vérifier son préfixe sans le deviner, demandez-le à brew :

brew --prefix

Le chemin affiché doit être cohérent avec votre installation et les indications officielles. Pour un diagnostic plus détaillé, la commande brew config rassemble des informations utiles sur la configuration ; consultez la documentation du manuel de brew avant de transmettre sa sortie, notamment si elle contient des renseignements propres à votre appareil.

Terminez par une vérification liée à votre cours, par exemple en lançant un outil que vous avez réellement installé. Le but n’est pas seulement d’obtenir une réponse à brew --version, mais de confirmer que le terminal utilisé pour travailler peut invoquer la commande attendue. Si elle échoue, relevez le shell actif, le message complet, le chemin de brew et les vérifications déjà effectuées. Ces éléments seront plus utiles pour un dépannage ciblé qu’une nouvelle installation faite à l’aveugle.

Quand un autre environnement devient pertinent

Si Homebrew fonctionne dans le terminal système et dans l’éditeur, vous n’avez pas besoin de changer d’ordinateur pour ce problème. Si la configuration échoue encore, reprenez les consignes officielles avec les messages complets ; sur un poste administré par votre école, faites valider toute modification nécessitant des droits particuliers. Vous pouvez également consulter la foire aux questions de KVMFLUX pour vérifier les conditions d’utilisation d’un Mac à distance.

La situation change si vous n’avez pas accès à un Mac ou si l’ordinateur de l’établissement bloque les installations requises par votre cours. Continuer sur un poste Windows peut vous empêcher d’utiliser certains outils propres à macOS ; une machine virtuelle ajoute des réglages et des dépendances qui ne sont pas forcément adaptés à un exercice débutant ; acheter un Mac n’est pas toujours justifié pour un besoin temporaire. Si vous devez simplement réaliser un projet ou suivre un cours dans un environnement macOS, louer un Mac auprès de KVMFLUX peut vous éviter ces obstacles sans faire de l’achat immédiat votre seule option. En revanche, pour un travail quotidien prolongé ou l’usage nécessaire de périphériques physiques, comparez soigneusement l’accès à distance avec un Mac local. Vous pouvez consulter les offres de location de KVMFLUX si cette solution correspond à la durée et aux outils de votre formation.