Zsh Error · 4 min read · Oct 08, 2025

Comment corriger l'erreur de commande Zsh introuvable sur macOS

Parfois, lorsque vous essayez d’utiliser des commandes dans le Terminal sur un Mac, vous pourriez recevoir un message d’erreur indiquant que la commande est introuvable.

À partir de macOS Catalina, Apple a changé le système principal utilisé dans le Terminal de ‘bash’ à ‘zsh’. L’une des raisons les plus courantes derrière cela est que le shell ne peut pas trouver la commande que vous essayez d’exécuter.

Donc, si votre Mac fonctionne sous macOS Catalina ou une version plus récente, vous pourriez voir une erreur comme “zsh: command not found: brew.”

Laissons-nous corriger l’erreur de commande Zsh introuvable de la manière suivante via le terminal et d’autres méthodes.

Table des matières

  • Raisons courantes de l’erreur de commande Zsh introuvable
  • Comment corriger l’erreur de commande Zsh introuvable ? - 1. Vérifiez la syntaxe
    1. Définir l’environnement $Path dans le fichier .zshrc
    1. Assurez-vous que le package est installé
    1. Créer un profil Zsh
    1. Réinstaller/Restaurer Mac
  • Comment passer aux commandes Zsh sur Mac ?
  • Résoudre l’erreur de commande introuvable sur macOS

Raisons courantes de l’erreur de commande Zsh introuvable

  • La commande n’est pas orthographiée correctement, ce qui entraîne une erreur.

  • Variable PATH incorrecte pour exécuter la commande Zsh (Z shell).

  • Le package correct n’est pas installé.

  • Configuration incorrecte récente pour la commande Zsh.

Comment corriger l’erreur de commande Zsh introuvable ?

1. Vérifiez la syntaxe

Il est courant d’obtenir une erreur de commande introuvable à cause de fautes d’orthographe ou de coquilles. Vous l’obtenez lorsque vous tapez des choses manuellement et que des caractères indésirables sont tapés.

Vous devriez vérifier à nouveau la commande pour voir s’il y a des erreurs. Nous vous recommandons de copier la commande directement dans le terminal au lieu de

2. Définir l’environnement $Path dans le fichier .zshrc

Un chemin dans un système de fichiers pointe vers un emplacement spécifique. De la même manière, pour les commandes du Terminal, la variable système PATH ($PATH) montre les répertoires où les programmes exécutables sont stockés.

Grâce à $PATH, votre Mac peut facilement localiser ces fichiers lorsque vous exécutez une commande, vous permettant d’utiliser simplement le nom de la commande, comme ‘ls’, au lieu de son chemin complet.

Par conséquent, vous devez définir le $PATH avant de continuer afin de ne pas obtenir l’erreur de commande introuvable.

  1. Appuyez sur Commande + Espace pour ouvrir la recherche Spotlight

Fix Zsh command not found error

  1. Recherchez et accédez au terminal.

open Terminal

  1. Collez la commande suivante et appuyez sur entrée.
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

Fix Zsh command not found error

Cela corrigera l’erreur de commande Zsh introuvable sur macOS.

3. Assurez-vous que le package est installé

Vous pouvez obtenir une erreur de commande introuvable lorsqu’un package n’est pas installé alors que vous essayez d’y accéder. Voici comment vérifier si le package est installé.

Pour Homebrew

  1. Entrez la commande suivante et appuyez sur entrée pour lister tous les packages installés.
brew list

Fix Zsh command not found error

Pour les packages Python

  1. Si vous souhaitez voir les packages Python installés, entrez la commande suivante et appuyez sur entrée.
pip list

Fix Zsh command not found error on macos

4. Créer un profil Zsh

L’erreur de commande introuvable peut se produire dans Zsh si le fichier .zshrc n’est pas créé ou s’il lui manque certaines configurations. Voici comment créer un profil Zsh avant d’entrer d’autres commandes.

  1. Entrez la commande suivante dans le terminal et appuyez sur entrée pour rediriger vers le répertoire personnel.
cd ~/ 
  1. Ensuite, entrez la commande suivante pour créer un profil Zsh.
touch .zshrc

Fix Zsh command not found error on macos

  1. Maintenant, vérifions le profil Zsh en l’ouvrant.
open .zshrc
  1. Vous verrez le fichier zshrc s’ouvrir dans l’éditeur de texte, confirmant la création du profil Zsh.

Fix Zsh command not found error on macos

5 . Réinstaller/Restaurer Mac

Lorsque vous avez épuisé toutes les options pour corriger l’erreur de commande introuvable, il est temps de recommencer à zéro. Réinstaller macOS peut être une solution pour corriger l’erreur de commande Zsh introuvable.

Surtout si l’erreur est due à un problème système plus large, tel que des fichiers système corrompus ou des paramètres mal configurés, vous pouvez utiliser le guide officiel d’Apple sur la réinstallation de macOS.

Et si vous avez sauvegardé macOS à l’aide de Time Machine, vous pouvez le restaurer sur un ordinateur démarré lorsque vous n’avez pas rencontré l’erreur de commande Zsh. Pour cela aussi, vous pouvez utiliser le guide officiel sur la restauration de macOS via Time Machine.


Comment passer aux commandes Zsh sur Mac ?

Pour macOS Catalina et les versions ultérieures, Zsh devrait déjà être défini comme votre shell par défaut. Voici comment le confirmer ou y passer :

Vérifiez le shell actuel :
Dans le Terminal, vérifiez votre shell actuel en tapant echo $SHELL. S’il renvoie quelque chose comme /bin/zsh, alors Zsh est déjà votre shell par défaut.

Changer pour Zsh (si nécessaire) :
Entrez la commande chsh -s /bin/zsh dans le Terminal. Vous pourriez avoir besoin d’entrer votre mot de passe pour confirmer ce changement.

Redémarrez le Terminal :
Enfin, fermez et rouvrez votre Terminal. Cela démarre une nouvelle session utilisant Zsh.

Résoudre l’erreur de commande introuvable sur macOS

Donc, voici comment vous pouvez corriger l’erreur de commande introuvable sur macOS. L’utilisation de gestionnaires de packages comme HomeBrew ou Macport, avec Zsh, peut faciliter les choses.

Assurez-vous de taper les commandes correctes pour résoudre les erreurs.

Share: X/Twitter LinkedIn

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.