Errore pip «Microsoft Visual C++ 14.0 or greater is required»: soluzioni
Perché pip chiede Microsoft Visual C++ durante l'installazione di una libreria Python e come risolvere l'errore, spesso senza installare nessun compilatore.
Stai installando una libreria Python con pip e, dopo qualche riga di avanzamento, il terminale si riempie di messaggi rossi che finiscono più o meno così:
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 nome-libreria
Failed to build nome-libreria
Il messaggio suggerisce di installare gli strumenti di sviluppo C++ di Microsoft: diversi gigabyte di software. Nella maggior parte dei casi, però, non è la soluzione migliore. In questo articolo vediamo cosa significa davvero l'errore, come capirne la causa e come risolverlo, partendo dalle soluzioni più semplici.
Cosa significa l'errore
Molte librerie Python contengono parti scritte in linguaggio C, per essere più veloci. Quel codice va compilato, cioè trasformato in un programma eseguibile dal computer. Gli autori delle librerie di solito lo fanno al posto tuo e pubblicano su PyPI, l'archivio ufficiale delle librerie Python, dei pacchetti già pronti chiamati wheel.
Il punto chiave è che una wheel con codice compilato vale solo per:
- una specifica versione di Python, per esempio la 3.14;
- uno specifico sistema operativo e processore, per esempio Windows a 64 bit.
Quando pip non trova una wheel adatta alla tua combinazione, scarica il codice sorgente e prova a compilarlo da solo. Per farlo su Windows serve il compilatore C++ di Microsoft: se non c'è, compare l'errore. In altre parole, il messaggio non dice «ti manca Visual C++», ma «non esiste un pacchetto pronto per la tua configurazione».
Le cause più comuni
- Una versione di Python troppo recente. È la causa più frequente. Quando esce una nuova versione, come Python 3.15 il 9 ottobre 2026, molte librerie impiegano settimane o mesi per pubblicare le wheel compatibili. Nel frattempo pip prova a compilare.
- Una versione di Python troppo vecchia. Il caso opposto: le versioni recenti di una libreria non pubblicano più wheel per le versioni di Python fuori supporto.
- Una versione della libreria vecchia o fissata nel progetto. Un file
requirements.txtche impone una versione datata di una libreria può non avere wheel per il tuo Python. - Un processore o un sistema meno comune, per esempio Windows su ARM o Python a 32 bit.
- Una dipendenza indiretta. A volte la libreria che fallisce non è quella che hai chiesto, ma una che lei si porta dietro.
Come capire qual è la libreria che fallisce
Leggi l'output dall'alto: cerca le righe che iniziano con Building wheel for o Failed building wheel for. Il nome che compare lì è la libreria che pip sta cercando di compilare. Spesso non è quella che hai installato tu: per esempio, chiedendo uvicorn[standard] pip installa anche altre librerie opzionali, e una di queste può essere quella senza wheel.
Poi verifica quale versione di Python stai usando:
python --version
Come verificare se esiste una wheel per il tuo Python
Apri la pagina della libreria su pypi.org e clicca su Download files. I nomi dei file contengono delle sigle che indicano per quale configurazione sono stati preparati. Per esempio:
nomelibreria-1.2.0-cp314-cp314-win_amd64.whl
cp314significa CPython 3.14, cioè Python 3.14;win_amd64significa Windows a 64 bit.
Se nell'elenco non c'è nessun file con la tua versione (per esempio cp315 se usi Python 3.15), hai trovato la causa.
Soluzione 1: aggiornare pip
È la prima cosa da fare, perché richiede pochi secondi: una versione vecchia di pip può non riconoscere le wheel più recenti.
python -m pip install --upgrade pip
Poi ripeti l'installazione della libreria.
Soluzione 2: usare una versione di Python supportata
Se la libreria non ha ancora le wheel per la tua versione di Python, la soluzione più pulita è usare la versione precedente. Con il Python Install Manager su Windows bastano pochi comandi:
py install 3.14
Poi ricrea l'ambiente virtuale del progetto con quella versione. Dalla cartella del progetto:
rmdir /s /q .venv
py -V:3.14 -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt
Il primo comando elimina il vecchio ambiente; gli altri lo ricreano con Python 3.14 e reinstallano le librerie. Puoi tenere installate entrambe le versioni di Python e usare la più recente negli altri progetti.
Questa è la soluzione giusta nella grande maggioranza dei casi: in pochi minuti risolvi il problema senza installare nulla di pesante.
Soluzione 3: aggiornare la libreria
Se nel progetto è indicata una versione precisa della libreria, per esempio nomelibreria==1.0.3 nel file requirements.txt, prova con una versione più recente, che potrebbe avere le wheel per il tuo Python:
python -m pip install --upgrade nomelibreria
Verifica poi che il tuo programma funzioni ancora: una nuova versione principale di una libreria può introdurre cambiamenti.
Soluzione 4: evitare le dipendenze opzionali
Alcune librerie offrono delle «aggiunte» opzionali, indicate tra parentesi quadre, come uvicorn[standard]. Se la libreria che fallisce arriva da una di queste aggiunte e non ti serve, installa la versione base:
python -m pip install uvicorn
Soluzione 5: chiedere a pip di usare solo wheel
Con questa opzione pip non prova mai a compilare: se esiste una versione della libreria con wheel compatibile, la sceglie; altrimenti si ferma subito con un messaggio chiaro, invece di un lungo errore di compilazione.
python -m pip install --only-binary :all: nomelibreria
È utile anche come strumento di diagnosi: ti dice con certezza se il problema è la mancanza di wheel.
Soluzione 6: installare i Microsoft C++ Build Tools
Se nessuna delle soluzioni precedenti funziona, per esempio perché ti serve davvero una libreria che non pubblica wheel per Windows, puoi installare il compilatore. È la soluzione che suggerisce il messaggio di errore:
- Scarica Microsoft C++ Build Tools dalla pagina indicata nell'errore.
- Durante l'installazione seleziona il carico di lavoro Sviluppo di applicazioni desktop con C++ («Desktop development with C++»), che include il compilatore MSVC e il Windows SDK.
- Al termine riavvia il computer, apri un nuovo terminale, attiva l'ambiente virtuale e ripeti l'installazione.
Tieni presente che l'installazione occupa diversi gigabyte e che alcune librerie richiedono, oltre al compilatore, altre componenti specifiche indicate nella loro documentazione.
E su Linux?
Su Linux l'errore ha un aspetto diverso, di solito con messaggi su gcc o su file come Python.h, ma la causa è la stessa. Le soluzioni 1–5 valgono anche qui. Se serve compilare, su Ubuntu e Debian installa gli strumenti di base:
sudo apt install build-essential python3-dev
In sintesi
- L'errore significa che non esiste un pacchetto già pronto per la tua combinazione di Python e sistema operativo.
- La causa più frequente è una versione di Python troppo recente.
- La soluzione più rapida è aggiornare pip e, se non basta, usare la versione di Python precedente in un nuovo ambiente virtuale.
- I Build Tools sono l'ultima risorsa, non la prima.
Fonti ufficiali
Share
What's Your Reaction?
Like
0
Cancella like
0
Amore
0
Buffo
0
arrabbiato
0
Sad
0
Wow
0