Ne paniquez pas : « No default toolchain configured » dans Rust — solution

Introduction : La douleur familière de chaque débutant en Rust

Vous venez d’installer Rust en suivant les instructions du site officiel, vous ouvrez le terminal et, le cœur battant, vous tapez rustc --version. Et là — boum ! — au lieu d’une belle ligne avec le numéro de version, vous voyez un texte froid et effrayant : « No default toolchain configured after installing rustup ».

Ça vous dit quelque chose ? Si oui, vous n’êtes pas seul. Cette question sur Stack Overflow a recueilli des milliers de vues et des dizaines de commentaires. Mais ne paniquez pas et ne supprimez pas tout à la hâte. Dans cet article, nous allons voir ce qu’est un toolchain, pourquoi rustup ne peut pas le trouver, et surtout, comment le corriger une fois pour toutes. Nous passerons du zéro absolu à un environnement de développement Rust fonctionnel.

Prêts ? C’est parti !

Qu’est-ce qu’un toolchain et pourquoi rustup « l’oublie » ?

Avant de plonger dans les détails, clarifions les concepts. Un toolchain (chaîne d’outils) est un ensemble d’outils nécessaires pour compiler et construire du code en Rust. Il comprend :

\n
• rustc — le compilateur lui-même ;
\n
• cargo — le gestionnaire de paquets et le système de construction ;
\n
• rust-std — la bibliothèque standard ;
\n
• Et d’autres composants (par exemple, clippy pour le linting).
\n

Rustup est l’installateur officiel et le gestionnaire de versions de Rust. Il permet de basculer entre différentes versions du compilateur : stable (stable), nightly (nightly) et bêta (beta). Lorsque vous tapez rustup install stable, rustup télécharge le toolchain correspondant et le sauvegarde sur le disque.

L’erreur « No default toolchain configured » se produit lorsque rustup ne peut pas déterminer quelle version du toolchain utiliser par défaut. C’est comme si vous arriviez à la bibliothèque sans savoir quel livre lire en premier. Rustup ne sait tout simplement pas quel compilateur lancer.

Les causes peuvent être variées :

\n
• Vous venez d’installer rustup, mais vous n’avez installé aucun toolchain ;
\n
• L’installation a été interrompue à cause de problèmes de réseau ;
\n
• Vous avez supprimé le toolchain manuellement ;
\n
• Problèmes de droits d’accès au dossier ~/.rustup.
\n

Diagnostic : vérifions l’état actuel

Avant de corriger quoi que ce soit, regardons ce que nous avons. Ouvrez le terminal et exécutez la commande :

rustup show

Vous devriez voir quelque chose comme ceci (si tout va mal) :

Default host: x86_64-unknown-linux-gnu\nrustup home:  /home/user/.rustup\n\ninstalled toolchains\n--------------------\n\nactive toolchain\n----------------\n(no active toolchain)

Notez la ligne « no active toolchain ». C’est la racine du problème. Corrigeons cela.

Solution n°1 : Installation et configuration du toolchain par défaut

La méthode la plus simple et la plus courante consiste à installer explicitement le toolchain stable et à le définir comme version par défaut.

Exécutez dans le terminal :

rustup install stable

Cette commande téléchargera et installera la dernière version stable de Rust. Le processus peut prendre un certain temps (généralement 1 à 3 minutes, selon la vitesse de votre connexion Internet).

Une fois l’installation terminée, vous devez « lier » ce toolchain comme version par défaut :

rustup default stable

Vérifions maintenant le résultat :

rustup show

Vous devriez voir un toolchain actif. Vous pouvez également vérifier le compilateur :

rustc --version

Si vous voyez quelque chose comme rustc 1.78.0 (9b00956e5 2024-04-29) — félicitations, le problème est résolu !

Solution n°2 : Utilisation du toolchain nightly (pour les expérimentateurs)

Parfois, vous pouvez avoir besoin de la version nightly du compilateur, par exemple pour