Erreur "Commande non trouvée" : vérifier le `PATH` (concept), les erreurs de frappe et l'installation du paquet

Introduction : le message "Commande non trouvée", un classique du débutant

Si vous venez de faire vos premiers pas dans le terminal Linux, il est fort probable que vous ayez déjà croisé le message d'erreur "bash: nom_commande: commande non trouvée" ou son équivalent anglais "bash: command_name: command not found". Ce message, bien que potentiellement frustrant, est l'un des plus courants et, heureusement, souvent l'un des plus simples à résoudre. Il signifie simplement que le shell Bash (ou tout autre shell que vous utilisez) n'a pas réussi à localiser l'exécutable correspondant à la commande que vous avez tapée.

Ce sous-chapitre a pour objectif de vous guider à travers les causes les plus fréquentes de cette erreur et de vous fournir une méthodologie de diagnostic claire. Nous aborderons trois axes principaux : les erreurs de saisie, la compréhension du mécanisme par lequel le shell recherche les commandes (le fameux `PATH`), et la vérification de l'installation effective du programme que vous souhaitez utiliser.

En maîtrisant ces quelques points, vous serez capable de surmonter rapidement cet obstacle et de poursuivre votre exploration de Linux avec plus de sérénité. N'oubliez pas, chaque erreur est une occasion d'apprendre !

Première vérification : la tyrannie de la frappe et la sensibilité à la casse

Avant de plonger dans des concepts plus techniques, la première cause d'une "commande non trouvée" est souvent la plus simple : une erreur de frappe. Une lettre oubliée, inversée, ou un caractère incorrect peuvent suffire à rendre votre commande méconnaissable pour le système. Prenez le temps de relire attentivement ce que vous avez tapé.

Un aspect crucial à retenir sous Linux (et la plupart des systèmes Unix) est la sensibilité à la casse (case sensitivity). Cela signifie que `MaCommande`, `macommande` et `MACOMMANDE` sont considérées comme trois commandes distinctes. Si la commande réelle est `ls` (pour lister les fichiers) et que vous tapez `Ls` ou `LS`, le système ne la reconnaîtra pas. Vérifiez donc scrupuleusement la casse utilisée.

Par exemple, si vous souhaitez lister le contenu d'un répertoire avec des détails et que vous tapez `LS -L` au lieu de `ls -l`, vous obtiendrez une erreur "Commande non trouvée" pour `LS`. Une simple correction de la casse résoudra le problème. Soyez également attentif aux espaces superflus avant ou au milieu du nom de la commande.

Comprendre le `PATH` : le GPS des commandes de votre shell

Si votre commande est correctement orthographiée, l'étape suivante consiste à comprendre comment le shell la recherche. Lorsqu'vous tapez une commande comme `ls` ou `mkdir`, vous ne précisez généralement pas son emplacement exact sur le disque (par exemple, `/bin/ls`). Le shell est capable de la trouver grâce à une variable d'environnement spéciale appelée `PATH`.

Le `PATH` est une liste de répertoires, séparés par des deux-points (`:`), dans lesquels le shell va chercher séquentiellement un fichier exécutable portant le nom de la commande que vous avez entrée. Vous pouvez afficher le contenu de votre `PATH` actuel avec la commande :

echo $PATH

La sortie ressemblera à quelque chose comme : `/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin`. Le shell parcourt ces répertoires dans l'ordre. Si la commande `ma_commande` se trouve dans `/usr/bin`, le shell la trouvera. Si elle est dans un répertoire non listé dans le `PATH`, l'erreur "Commande non trouvée" apparaîtra, à moins de spécifier son chemin complet (par exemple `/opt/mon_app/ma_commande`).

Pour les utilisateurs plus avancés, il est possible de modifier le `PATH` pour y ajouter des répertoires personnels contenant des scripts ou des programmes spécifiques, mais cela dépasse le cadre de cette introduction. L'important est de comprendre que si une commande standard (comme `ls`, `cp`, `sudo`, etc.) n'est pas trouvée, un problème avec le `PATH` est peu probable mais possible, tandis que pour des commandes moins courantes ou des logiciels tiers, il est plus probable que le problème vienne de leur installation ou de leur absence dans un répertoire du `PATH`.

Vérification cruciale : le paquet est-il installé sur votre système ?

Une autre raison fréquente pour laquelle une commande n'est pas trouvée est tout simplement que le logiciel (ou le paquet) qui la fournit n'est pas installé sur votre système Linux. De nombreuses commandes sont des programmes distincts qui doivent être installés via le gestionnaire de paquets de votre distribution.

Pour vérifier si une commande spécifique est disponible, vous pouvez utiliser la commande `which`. Si la commande est trouvée dans un des répertoires du `PATH`, `which` affichera son chemin complet. Sinon, elle ne retournera rien ou un message d'erreur.

which htop
# Si htop est installé et dans le PATH, affichera /usr/bin/htop (par exemple)
# Sinon, rien ou un message d'erreur

Si `which` ne trouve rien, le paquet est probablement manquant. Vous pouvez alors utiliser votre gestionnaire de paquets pour le rechercher et l'installer. Par exemple, sur un système Debian ou Ubuntu, pour installer `htop` (un moniteur de processus interactif) :

# D'abord, mettre à jour la liste des paquets
sudo apt update
# Ensuite, rechercher le paquet (optionnel, si vous n'êtes pas sûr du nom)
apt search htop
# Enfin, installer le paquet
sudo apt install htop

Sur les systèmes basés sur Fedora/RHEL (comme CentOS), vous utiliseriez `dnf` ou `yum` :

sudo dnf search htop
sudo dnf install htop

Une fois l'installation terminée, la commande devrait être accessible et l'erreur "Commande non trouvée" disparaître pour cette commande spécifique. Pensez toujours à vérifier si un logiciel que vous souhaitez utiliser est inclus par défaut dans votre distribution ou s'il nécessite une installation séparée.

Cas des scripts locaux et réflexes de diagnostic

Un cas particulier concerne les scripts que vous créez vous-même. Si vous avez un script nommé `mon_script.sh` dans votre répertoire courant et que vous tapez simplement `mon_script.sh` pour l'exécuter, vous risquez d'obtenir "Commande non trouvée". Cela se produit parce que, par défaut et pour des raisons de sécurité, le répertoire courant (`.` ) n'est souvent pas inclus dans le `PATH` des utilisateurs standards.

Pour exécuter un script situé dans le répertoire courant, vous devez indiquer explicitement son chemin en le préfixant par `./` :

./mon_script.sh

En résumé, face à une erreur "Commande non trouvée", adoptez les réflexes suivants : 1. Vérifiez méticuleusement l'orthographe et la casse de la commande. 2. Assurez-vous que le logiciel ou le paquet fournissant la commande est bien installé sur votre système ; installez-le si nécessaire. 3. Si c'est un script personnel ou un exécutable dans un répertoire non standard, vérifiez que vous utilisez le chemin correct pour l'appeler (par exemple, `./nom_script` ou `/chemin/complet/vers/commande`).

Comprendre le rôle du `PATH` est également fondamental pour diagnostiquer pourquoi certaines commandes sont accessibles directement et d'autres non. Avec ces outils de diagnostic, vous serez bien mieux armé pour résoudre ce type d'erreur courant.