Rust sur Windows : éliminer l'erreur linker 'cc' not found en 5 minutes

Introduction : Première rencontre avec le « dragon rouge »

Vous venez de commencer à apprendre Rust. Vous avez téléchargé le compilateur, écrit votre premier hello.rs, vous lancez cargo build... Et là, le terminal explose en rouge avec le message : « linker 'cc' not found ». Familier ? Si vous travaillez sur Windows 10 en utilisant le sous-système WSL avec Debian, cette erreur est un « bonjour » classique du monde de la programmation système.

Ne paniquez pas. Ce n'est pas un bug de Rust, c'est une particularité de la configuration de l'environnement. Dans cet article, nous allons non seulement résoudre ce problème une fois pour toutes, mais aussi parler de la manière d'optimiser le processus de compilation pour que votre code se compile plus rapidement. Car Rust est réputé pour ses performances, et nous devons donner au compilateur les meilleurs outils pour travailler.

Pourquoi l'erreur « linker 'cc' not found » se produit-elle ?

Pour comprendre l'ennemi, il faut le connaître. Rust est un langage compilé. Lorsque vous tapez cargo build, le compilateur rustc transforme votre code en code machine. Mais l'étape finale est l'édition de liens (assemblage des fichiers objets en un exécutable). Ce travail est effectué par un programme externe : l'éditeur de liens.

Par défaut, sur les systèmes Linux (y compris WSL Debian), Rust recherche l'éditeur de liens cc. Il s'agit d'un lien symbolique qui pointe généralement vers gcc ou clang. Si votre système WSL n'a pas de compilateur C (GCC ou Clang) installé, le lien cc est absent. Rust ne sait pas avec quoi lier votre projet et génère une erreur fatale.

Racine du problème : WSL Debian — installation minimale

Lorsque vous installez WSL Debian depuis le Microsoft Store, vous obtenez un système nu. Il ne contient ni GCC, ni Make, ni d'autres outils de développement. Rust n'inclut pas d'éditeur de liens C — cela relève de la responsabilité de l'environnement système.

Méthode n°1 : Solution rapide (installation de GCC)

La manière la plus simple et la plus correcte est d'installer l'ensemble standard d'outils de développement C. Ouvrez le terminal WSL Debian et exécutez :

sudo apt update\nsudo apt install build-essential

Le paquet build-essential est un méta-paquet qui installe gcc, g++, make et, surtout, crée le lien /usr/bin/cc. Après l'installation, vérifiez :

which cc\n# Devrait afficher : /usr/bin/cc

Maintenant, relancez cargo build — l'erreur disparaîtra. Rust a trouvé l'éditeur de liens.

Pourquoi est-ce important pour les performances ?

En utilisant le GCC standard, vous obtenez un éditeur de liens stable et optimisé. Rust compilera votre projet avec un minimum de frais généraux. L'optimisation commence par les bons outils.

Méthode n°2 : Configuration précise (installation de Clang)

Si vous êtes fan de LLVM et Clang (et Rust utilise aussi LLVM en coulisse), vous pouvez les installer à la place de GCC. Cela peut donner un léger gain de vitesse d'édition de liens sur certains projets.

sudo apt install clang lld\n# Créez le lien manuellement s'il n'existe pas\nsudo ln -s /usr/bin/clang /usr/bin/cc

Vérification :

cc --version\n# Devrait afficher Clang

Important : LLD (LLVM Linker) est souvent plus rapide que le GNU ld classique. Pour les grands projets Rust, cela peut réduire le temps de compilation de 10 à 20 %. Installer Clang n'est pas seulement une correction d'erreur, c'est une optimisation des performances de compilation.

Méthode n°3 : Solution de contournement (spécification manuelle de l'éditeur de liens)

Il existe des situations où vous ne voulez pas installer GCC ou Clang (par exemple, sur un serveur de production avec des restrictions). Vous pouvez indiquer explicitement à Rust quel éditeur de liens utiliser. Mais attention : sans éditeur de liens installé, cette méthode ne fonctionnera pas.

Créez un fichier ~/.cargo/config.toml (ou /.cargo/config.toml pour une configuration globale) :

[target.x