Error de pip «Microsoft Visual C++ 14.0 or greater is required»: soluciones
Por qué pip pide Microsoft Visual C++ al instalar una biblioteca de Python y cómo resolver el error, a menudo sin instalar ningún compilador.
Estás instalando una biblioteca de Python con pip y, tras algunas líneas de progreso, el terminal se llena de mensajes rojos que terminan más o menos así:
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 nombre-biblioteca
Failed to build nombre-biblioteca
El mensaje sugiere instalar las herramientas de desarrollo C++ de Microsoft: varios gigabytes de software. Sin embargo, en la mayoría de los casos no es la mejor solución. En este artículo vemos qué significa realmente el error, cómo encontrar su causa y cómo resolverlo, empezando por las soluciones más sencillas.
Qué significa el error
Muchas bibliotecas de Python contienen partes escritas en lenguaje C para ser más rápidas. Ese código debe compilarse, es decir, transformarse en un programa que el ordenador pueda ejecutar. Los autores de las bibliotecas suelen hacerlo por ti y publican en PyPI, el archivo oficial de bibliotecas de Python, paquetes ya preparados llamados wheels.
La clave es que una wheel con código compilado solo sirve para:
- una versión concreta de Python, por ejemplo la 3.14;
- un sistema operativo y un procesador concretos, por ejemplo Windows de 64 bits.
Cuando pip no encuentra una wheel adecuada para tu combinación, descarga el código fuente e intenta compilarlo por sí mismo. En Windows, para ello necesita el compilador C++ de Microsoft: si no está, aparece el error. Dicho de otro modo, el mensaje no significa «te falta Visual C++», sino «no existe un paquete preparado para tu configuración».
Las causas más comunes
- Una versión de Python demasiado reciente. Es la causa más frecuente. Cuando sale una nueva versión, como Python 3.15 el 9 de octubre de 2026, muchas bibliotecas tardan semanas o meses en publicar wheels compatibles. Mientras tanto, pip intenta compilar.
- Una versión de Python demasiado antigua. El caso contrario: las versiones recientes de una biblioteca ya no publican wheels para versiones de Python sin soporte.
- Una versión de la biblioteca antigua o fijada en el proyecto. Un archivo
requirements.txtque impone una versión antigua de una biblioteca puede no tener wheels para tu Python. - Un procesador o un sistema menos común, por ejemplo Windows en ARM o Python de 32 bits.
- Una dependencia indirecta. A veces la biblioteca que falla no es la que has pedido, sino una que esta arrastra consigo.
Cómo saber qué biblioteca falla
Lee la salida desde arriba: busca las líneas que empiezan por Building wheel for o Failed building wheel for. El nombre que aparece ahí es la biblioteca que pip intenta compilar. A menudo no es la que instalaste tú: por ejemplo, al pedir uvicorn[standard], pip instala también otras bibliotecas opcionales, y una de ellas puede ser la que no tiene wheel.
Después comprueba qué versión de Python estás usando:
python --version
Cómo comprobar si existe una wheel para tu Python
Abre la página de la biblioteca en pypi.org y haz clic en Download files. Los nombres de los archivos contienen unas siglas que indican para qué configuración se prepararon. Por ejemplo:
nombrebiblioteca-1.2.0-cp314-cp314-win_amd64.whl
cp314significa CPython 3.14, es decir, Python 3.14;win_amd64significa Windows de 64 bits.
Si en la lista no hay ningún archivo para tu versión (por ejemplo cp315 si usas Python 3.15), has encontrado la causa.
Solución 1: actualizar pip
Es lo primero que hay que hacer, porque solo lleva unos segundos: una versión antigua de pip puede no reconocer las wheels más recientes.
python -m pip install --upgrade pip
Después repite la instalación de la biblioteca.
Solución 2: usar una versión de Python compatible
Si la biblioteca todavía no tiene wheels para tu versión de Python, la solución más limpia es usar la versión anterior. Con el Python Install Manager en Windows bastan unos pocos comandos:
py install 3.14
Después vuelve a crear el entorno virtual del proyecto con esa versión. Desde la carpeta del proyecto:
rmdir /s /q .venv
py -V:3.14 -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt
El primer comando elimina el entorno antiguo; los demás lo vuelven a crear con Python 3.14 y reinstalan las bibliotecas. Puedes mantener instaladas ambas versiones de Python y usar la más reciente en tus otros proyectos.
Es la solución correcta en la gran mayoría de los casos: en pocos minutos resuelves el problema sin instalar nada pesado.
Solución 3: actualizar la biblioteca
Si en el proyecto se indica una versión exacta de la biblioteca, por ejemplo nombrebiblioteca==1.0.3 en el archivo requirements.txt, prueba con una versión más reciente, que podría tener wheels para tu Python:
python -m pip install --upgrade nombrebiblioteca
Comprueba después que tu programa sigue funcionando: una nueva versión principal de una biblioteca puede introducir cambios.
Solución 4: evitar las dependencias opcionales
Algunas bibliotecas ofrecen «extras» opcionales, indicados entre corchetes, como uvicorn[standard]. Si la biblioteca que falla procede de uno de estos extras y no lo necesitas, instala la versión básica:
python -m pip install uvicorn
Solución 5: pedir a pip que use solo wheels
Con esta opción pip nunca intenta compilar: si existe una versión de la biblioteca con una wheel compatible, la elige; si no, se detiene enseguida con un mensaje claro en lugar de un largo error de compilación.
python -m pip install --only-binary :all: nombrebiblioteca
También es útil como herramienta de diagnóstico: te dice con certeza si el problema es la falta de wheels.
Solución 6: instalar Microsoft C++ Build Tools
Si ninguna de las soluciones anteriores funciona, por ejemplo porque de verdad necesitas una biblioteca que no publica wheels para Windows, puedes instalar el compilador. Es la solución que sugiere el mensaje de error:
- Descarga Microsoft C++ Build Tools desde la página indicada en el error.
- Durante la instalación selecciona la carga de trabajo Desarrollo para el escritorio con C++ («Desktop development with C++»), que incluye el compilador MSVC y el Windows SDK.
- Al terminar, reinicia el ordenador, abre un terminal nuevo, activa el entorno virtual y repite la instalación.
Ten en cuenta que la instalación ocupa varios gigabytes y que algunas bibliotecas necesitan, además del compilador, otros componentes específicos indicados en su documentación.
¿Y en Linux?
En Linux el error tiene otro aspecto, normalmente con mensajes sobre gcc o sobre archivos como Python.h, pero la causa es la misma. Las soluciones 1–5 también valen aquí. Si hace falta compilar, en Ubuntu y Debian instala las herramientas básicas:
sudo apt install build-essential python3-dev
En resumen
- El error significa que no existe un paquete preparado para tu combinación de Python y sistema operativo.
- La causa más frecuente es una versión de Python demasiado reciente.
- La solución más rápida es actualizar pip y, si no basta, usar la versión anterior de Python en un entorno virtual nuevo.
- Las Build Tools son el último recurso, no el primero.
Fuentes oficiales
Compartir
¿Cuál es tu reacción?
Me gusta
0
No me gusta
0
Me encanta
0
Divertido
0
Enfadado
0
Triste
0
¡Vaya!
0