Comment réparer « Commande Brew introuvable » sur Mac

Si vous êtes un utilisateur régulier de Homebrew, vous saurez à quel point il s’agit d’un outil pratique pour installer des packages à l’aide de Terminal. Vous pouvez également être dérouté lorsque vous rencontrez le message d'erreur « Commande Brew introuvable » lorsque vous essayez d'utiliser Homebrew dans un shell zsh dans Terminal. Il s'agit généralement du suivant :
zsh: command not found: brew, et dans cet article, nous expliquerons les causes possibles de cette erreur et vous montrerons comment les corriger.

Qu’est-ce que l’Homebrew ?

Juste au cas où vous n'en auriez pas entendu parler, Homebrew est un outil de gestion de packages qui vous permet d'installer un logiciel open source sur votre Mac à partir de la ligne de commande du Terminal. C’est un excellent moyen, par exemple, d’installer Git, afin de pouvoir ensuite « extraire » le code de GitHub et l’installer sur votre Mac. Une fois que vous avez installé Homebrew, les packages peuvent généralement être installés avec une seule commande.

Pourquoi l’erreur « Commande Brew introuvable » apparaît-elle sur mon Mac ?

Il existe plusieurs raisons possibles pour lesquelles le message d'erreur peut apparaître, mais elles ont toutes la même cause fondamentale : le shell zsh ne parvient pas à trouver le binaire Brew à exécuter. Cela pourrait être dû à un problème avec $PATH (la variable qui spécifie où se trouvent les programmes exécutables) ou avec l'installation de Homebrew.

Redémarrer le terminal

Avant de plonger dans des solutions plus complexes, éliminons un problème simple en redémarrant Terminal. Suivez ces étapes :

1. Appuyez sur Commande-Option-Esc pour ouvrir le menu Forcer à quitter.
2. Sélectionnez Terminal et cliquez sur Forcer à quitter.
3. Rouvrez le terminal.
4. Dans la nouvelle fenêtre Terminal, tapez :brew doctor

Lorsque vous exécutez Brew Doctor, vous recevrez l’une des deux réponses suivantes. Un message indiquant « Votre système est prêt à fonctionner » signifie que tout fonctionne correctement. Cependant, si vous obtenez une erreur commezsh: command not found: brew, essayez ces solutions.

Installer Git

Git est un système de contrôle de version distribué qui suit les modifications apportées aux fichiers et est souvent préinstallé sur macOS. Git est une dépendance critique pour Homebrew. Homebrew utilise les référentiels Git pour cloner, extraire et gérer les mises à jour de ses packages, garantissant ainsi que le système reste à jour et fiable.

Avant d’installer Git, vérifions si vous l’avez déjà :

1. Ouvrez le terminal.
2. Tapergit --versionet appuyez sur Entrée.

Si vous voyez un numéro de version, Git a déjà été installé. Si vous recevez un message indiquant qu'aucun outil de développement n'est trouvé, entrez
xcode-select --installet cliquez sur Installer dans la fenêtre contextuelle qui apparaît. Cela installera les outils de ligne de commande Git et Xcode, essentiels à la configuration d'un environnement de développement sur votre Mac.

Mettez à jour votre fichier .zshrc

Brew s'installe dans/opt/homebrew/bin/, mais parfois ce répertoire n'est pas inclus dans la configuration de votre shell. Pour résoudre ce problème, suivez ces étapes pour mettre à jour votre fichier .zshrc :

1. Ouvrez le Terminal et accédez à votre répertoire personnel en tapantcd
2. Maintenant, entrezls -alpour lister les fichiers cachés et vérifier si vous avez un fichier .zshrc. Si vous ne voyez pas .zshrc dans la liste, vous devrez le créer.
3. Entrerclearpour effacer le terminal.
4. Tapernano .zshrcpour accéder à l'éditeur de texte Nano.

   

5. Ajoutez le chemin de Brew au fichier :export PATH="/opt/homebrew/bin:$PATH"
6. Pour enregistrer et quitter Nano, appuyez sur Control-X.
7. Lorsque vous êtes invité à « Enregistrer le tampon modifié », appuyez sur Y. Appuyez sur Entrée pour confirmer et quitter.

   

8. Vérifiez si le fichier a été créé avec succès : entrezls -alet voyez que .zshrc apparaît dans la liste.
9. Enfin, tapezsource .zshrcpour charger la nouvelle configuration sans redémarrer le Terminal.
10. Courirbrew helppour voir si ça a marché.

Ce processus ajoute le chemin nécessaire pour Brew à vos sessions shell interactives, garantissant ainsi que la commande Brew est reconnue.

La différence entre .zshrc et .zprofile

De nombreux utilisateurs mélangent .zshrc et .zprofile. Voici une explication plus claire : .zprofile est exécuté pour les shells de connexion lancés lorsque vous vous connectez à votre système. Le fichier .zshrc est exécuté pour les shells interactifs, les sessions que vous ouvrez dans une nouvelle fenêtre ou un nouvel onglet de terminal.

Lors du dépannage des problèmes liés à Brew, vous modifiez généralement .zshrc car ce fichier est lu par les shells interactifs que vous utilisez dans Terminal. Cela garantit que chaque nouvelle session de terminal charge immédiatement les paramètres Homebrew corrects.

Réinstaller Homebrew

Si Homebrew ne fonctionne pas comme prévu, la solution la plus simple consiste à le réinstaller. Pour ce faire, suivez les étapes ci-dessous.

1. Ouvrez le terminal.
2. Tapez ou collez la commande suivante :/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. Appuyez sur Retour. Vous verrez des informations dans la fenêtre du terminal expliquant ce qui sera installé et où il sera installé.
4. Appuyez à nouveau sur Retour.
5. Tapez votre mot de passe administrateur et appuyez sur Retour.
6. Attendez un message vous indiquant que l'installation est terminée.
7. Vous pouvez maintenant réessayer la commande Brew pour voir si elle fonctionne.

Si l'erreur persiste après la réinstallation de Homebrew, l'étape suivante consiste à mettre Brew dans votre chemin zshrc. Pour ce faire, ouvrez une nouvelle fenêtre de terminal et tapez ou collez la commande ci-dessous suivie de Retour :

echo "export PATH=/opt/homebrew/bin:$PATH" >> ~/.zshrc

Ensuite, utilisez la commande ci-dessous pour réparer l'infusion :brew doctor

Si vous voyez « Commande Brew introuvable » après l'installation d'Oh My Zsh

Si vous venez d'installer Oh My Zsh pour vous permettre d'installer des plug-ins pour Zsh et que vous voyez ensuite l'erreur « Commande Brew introuvable », vous pouvez essayer autre chose. Vous pouvez ajouter une ligne à votre fichier zshrc. Le fichier se trouve dans le dossier racine de votre répertoire personnel, mais il est masqué. Pour le voir, vous pouvez afficher les fichiers cachés ou utiliser Finder > Aller > Aller au dossier > ~/zshrc. Ouvrez-le dans Text Edit et ajoutez la ligne ci-dessous. Ensuite, enregistrez-le et fermez-le.

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

Alternativement, vous pouvez utiliser la commande ci-dessous dans une fenêtre de terminal pour ajouter la ligne :

Apprendre encore plus:5 façons de réparer Zsh : commande introuvable : erreur Pip

echo "eval $(/opt/homebrew/bin/brew shellenv)" >> ~/.zshrc

Ensuite, exécutez à nouveau Brew Doctor à l'aide de la commande Terminal :brew doctor

Le message d'erreur « Commande Brew introuvable » signifie qu'il y a un problème avec l'installation de Homebrew sur votre Mac. Suivez les étapes ci-dessus pour résoudre ce problème et relancer Homebrew.