Erreur pip « Microsoft Visual C++ 14.0 or greater is required » : solutions
Pourquoi pip réclame Microsoft Visual C++ lors de l’installation d’une bibliothèque Python et comment corriger l’erreur, souvent sans installer de compilateur.
Vous installez une bibliothèque Python avec pip et, après quelques lignes de progression, le terminal se remplit de messages rouges qui se terminent à peu près ainsi :
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
[end of output]
ERROR: Failed building wheel for nom-bibliotheque
Failed to build nom-bibliotheque
Le message propose d’installer les outils de développement C++ de Microsoft : plusieurs gigaoctets de logiciels. Dans la plupart des cas, pourtant, ce n’est pas la meilleure solution. Dans cet article, nous voyons ce que signifie vraiment l’erreur, comment en trouver la cause et comment la corriger, en commençant par les solutions les plus simples.
Ce que signifie l’erreur
Beaucoup de bibliothèques Python contiennent des parties écrites en langage C, pour être plus rapides. Ce code doit être compilé, c’est-à-dire transformé en programme exécutable par l’ordinateur. Les auteurs des bibliothèques le font généralement à votre place et publient sur PyPI, l’archive officielle des bibliothèques Python, des paquets prêts à l’emploi appelés wheels.
Le point essentiel est qu’une wheel contenant du code compilé ne vaut que pour :
- une version précise de Python, par exemple la 3.14 ;
- un système d’exploitation et un processeur précis, par exemple Windows 64 bits.
Lorsque pip ne trouve pas de wheel adaptée à votre combinaison, il télécharge le code source et tente de le compiler lui-même. Sous Windows, il lui faut pour cela le compilateur C++ de Microsoft : s’il est absent, l’erreur apparaît. Autrement dit, le message ne signifie pas « il vous manque Visual C++ », mais « il n’existe pas de paquet prêt pour votre configuration ».
Les causes les plus courantes
- Une version de Python trop récente. C’est la cause la plus fréquente. Quand une nouvelle version sort, comme Python 3.15 le 9 octobre 2026, beaucoup de bibliothèques mettent des semaines ou des mois à publier des wheels compatibles. En attendant, pip tente de compiler.
- Une version de Python trop ancienne. Le cas inverse : les versions récentes d’une bibliothèque ne publient plus de wheels pour les versions de Python qui ne sont plus prises en charge.
- Une version de la bibliothèque ancienne ou figée dans le projet. Un fichier
requirements.txtqui impose une version datée d’une bibliothèque peut ne pas avoir de wheels pour votre Python. - Un processeur ou un système moins courant, par exemple Windows sur ARM ou Python 32 bits.
- Une dépendance indirecte. Parfois, la bibliothèque qui échoue n’est pas celle que vous avez demandée, mais une de celles qu’elle entraîne.
Comment savoir quelle bibliothèque échoue
Lisez la sortie depuis le début : cherchez les lignes qui commencent par Building wheel for ou Failed building wheel for. Le nom qui y figure est la bibliothèque que pip essaie de compiler. Souvent, ce n’est pas celle que vous avez installée : par exemple, en demandant uvicorn[standard], pip installe aussi d’autres bibliothèques optionnelles, et l’une d’elles peut être celle sans wheel.
Vérifiez ensuite quelle version de Python vous utilisez :
python --version
Comment vérifier s’il existe une wheel pour votre Python
Ouvrez la page de la bibliothèque sur pypi.org et cliquez sur Download files. Les noms des fichiers contiennent des sigles qui indiquent pour quelle configuration ils ont été préparés. Par exemple :
nombibliotheque-1.2.0-cp314-cp314-win_amd64.whl
cp314signifie CPython 3.14, c’est-à-dire Python 3.14 ;win_amd64signifie Windows 64 bits.
Si la liste ne contient aucun fichier pour votre version (par exemple cp315 si vous utilisez Python 3.15), vous avez trouvé la cause.
Solution 1 : mettre à jour pip
C’est la première chose à faire, car cela ne prend que quelques secondes : une ancienne version de pip peut ne pas reconnaître les wheels les plus récentes.
python -m pip install --upgrade pip
Recommencez ensuite l’installation de la bibliothèque.
Solution 2 : utiliser une version de Python prise en charge
Si la bibliothèque n’a pas encore de wheels pour votre version de Python, la solution la plus propre est d’utiliser la version précédente. Avec le Python Install Manager sous Windows, quelques commandes suffisent :
py install 3.14
Recréez ensuite l’environnement virtuel du projet avec cette version. Depuis le dossier du projet :
rmdir /s /q .venv
py -V:3.14 -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt
La première commande supprime l’ancien environnement ; les autres le recréent avec Python 3.14 et réinstallent les bibliothèques. Vous pouvez garder les deux versions de Python installées et utiliser la plus récente dans vos autres projets.
C’est la bonne solution dans la grande majorité des cas : en quelques minutes, le problème est réglé sans rien installer de lourd.
Solution 3 : mettre à jour la bibliothèque
Si le projet indique une version précise de la bibliothèque, par exemple nombibliotheque==1.0.3 dans le fichier requirements.txt, essayez une version plus récente, qui pourrait avoir des wheels pour votre Python :
python -m pip install --upgrade nombibliotheque
Vérifiez ensuite que votre programme fonctionne toujours : une nouvelle version majeure d’une bibliothèque peut introduire des changements.
Solution 4 : éviter les dépendances optionnelles
Certaines bibliothèques proposent des « extras » optionnels, indiqués entre crochets, comme uvicorn[standard]. Si la bibliothèque qui échoue provient de l’un de ces extras et que vous n’en avez pas besoin, installez la version de base :
python -m pip install uvicorn
Solution 5 : demander à pip de n’utiliser que des wheels
Avec cette option, pip n’essaie jamais de compiler : s’il existe une version de la bibliothèque avec une wheel compatible, il la choisit ; sinon, il s’arrête tout de suite avec un message clair, au lieu d’une longue erreur de compilation.
python -m pip install --only-binary :all: nombibliotheque
C’est aussi un bon outil de diagnostic : il vous dit avec certitude si le problème vient de l’absence de wheel.
Solution 6 : installer les Microsoft C++ Build Tools
Si aucune des solutions précédentes ne fonctionne, par exemple parce que vous avez vraiment besoin d’une bibliothèque qui ne publie pas de wheels pour Windows, vous pouvez installer le compilateur. C’est la solution suggérée par le message d’erreur :
- Téléchargez les Microsoft C++ Build Tools depuis la page indiquée dans l’erreur.
- Pendant l’installation, sélectionnez la charge de travail Développement Desktop en C++ (« Desktop development with C++ »), qui comprend le compilateur MSVC et le Windows SDK.
- À la fin, redémarrez l’ordinateur, ouvrez un nouveau terminal, activez l’environnement virtuel et recommencez l’installation.
Sachez que l’installation occupe plusieurs gigaoctets et que certaines bibliothèques exigent, en plus du compilateur, d’autres composants précisés dans leur documentation.
Et sous Linux ?
Sous Linux, l’erreur a un aspect différent, généralement avec des messages sur gcc ou sur des fichiers comme Python.h, mais la cause est la même. Les solutions 1 à 5 s’appliquent aussi. S’il faut vraiment compiler, installez sous Ubuntu et Debian les outils de base :
sudo apt install build-essential python3-dev
En résumé
- L’erreur signifie qu’il n’existe pas de paquet prêt pour votre combinaison de Python et de système d’exploitation.
- La cause la plus fréquente est une version de Python trop récente.
- La solution la plus rapide consiste à mettre à jour pip et, si cela ne suffit pas, à utiliser la version de Python précédente dans un nouvel environnement virtuel.
- Les Build Tools sont le dernier recours, pas le premier.
Sources officielles
Partager
Quelle est votre réaction ?
Aimer
0
Je n'aime pas
0
Amour
0
Drôle
0
En colère
0
Triste
0
Waouh
0