HOWTO · Python

Arreglar el comando cl.exe falló: no existe tal archivo o directorio en Windows

Este tutorial le enseñará a corregir el error del comando 'cl.exe': No existe tal archivo o directorio en Windows.

En esta página

Cuando pip muestra error: command 'cl.exe' failed: no such file or directory en Windows, normalmente significa que se está compilando un paquete desde el código fuente y el proceso no encuentra el compilador C/C++ de Microsoft. Si faltan las herramientas de C++, instálalas y luego ejecuta pip desde un símbolo del sistema para desarrolladores de Visual Studio, que configura el compilador para esa sesión. Algunos paquetes ofrecen una rueda precompilada para tu versión de Python y pueden instalarse sin un compilador local.

Entender por qué pip indica que falta cl.exe

pip instala una rueda cuando hay un paquete precompilado compatible. De lo contrario, puede compilar el paquete desde el código fuente. Los paquetes con componentes nativos, incluidos algunos enlaces de Python, necesitan un compilador C o C++ durante esa compilación. En Windows, Microsoft Visual C++ utiliza el ejecutable del compilador cl.exe.

El mensaje indica que el comando de compilación intentó iniciar cl.exe, pero no pudo encontrarlo en el entorno actual. Puede ocurrir porque los componentes del compilador no están instalados o porque el terminal actual no está configurado para localizarlos. Por sí solo, esto no demuestra que Python o pip estén dañados, y la instalación del compilador no resolverá errores distintos, como versiones de paquetes no compatibles o dependencias ausentes.

Instalar las herramientas de compilación de C++ de Microsoft

Si ya tienes Visual Studio instalado, abre Visual Studio Installer, elige Modificar en esa instalación y selecciona la carga de trabajo Desarrollo para el escritorio con C++. Comprueba que incluya las herramientas de compilación de C++ y aplica los cambios. Esta carga de trabajo proporciona el compilador y otras herramientas que utilizan las compilaciones de paquetes nativos.

Install Desktop Development With C++

Si no necesitas el IDE completo de Visual Studio, instala Visual Studio Build Tools desde la página de descarga de Build Tools de Microsoft. En el instalador, selecciona la carga de trabajo de herramientas de compilación de C++ y los componentes necesarios para la arquitectura de destino. Los nombres de las opciones pueden variar según la versión; antes de completar la instalación, comprueba que estén seleccionadas las herramientas del compilador MSVC.

Install C++ Build Tools

La instalación de la carga de trabajo deja el compilador disponible en el equipo, pero un terminal normal quizá no tenga configurado el entorno para encontrarlo. Para el siguiente paso, usa un símbolo del sistema para desarrolladores en vez de copiar al PATH del sistema una ruta del compilador específica de una versión.

Ejecutar pip desde un entorno de desarrollo configurado

En el menú Inicio, abre un Developer Command Prompt o Native Tools Command Prompt de Visual Studio instalado con las herramientas de C++. Elige un símbolo del sistema x64 para una instalación de Python de 64 bits, o el símbolo x86 correspondiente para una instalación de 32 bits. El símbolo configura las variables de entorno de esa sesión de terminal, incluidas las rutas necesarias para encontrar el compilador; no modifica las ventanas de Símbolo del sistema o PowerShell que ya estén abiertas.

Open Native Tools Command Prompt

En ese símbolo del sistema, cambia al directorio del proyecto si hace falta y ejecuta el mismo comando pip install package-name que produjo el error. Usa el entorno de Python en el que quieres instalar los paquetes. Por ejemplo, si normalmente usas un entorno virtual, actívalo en el símbolo configurado antes de ejecutar pip. Si después abres un terminal normal, este no heredará la configuración del símbolo para desarrolladores.

Verificar el compilador y diagnosticar otros errores de compilación

Antes de volver a intentar la instalación, comprueba que el símbolo seleccionado encuentre el compilador ejecutando where cl. Windows debería mostrar la ruta de cl.exe. Si indica que no encuentra el archivo, confirma que terminó la instalación de la carga de trabajo de C++ y vuelve a abrir el símbolo para desarrolladores correspondiente. Comprueba que la arquitectura del símbolo coincida con la del intérprete de Python que utilizas; no agregues manualmente una ruta del compilador supuesta.

Si where cl encuentra el compilador pero pip sigue mostrando el mismo mensaje de comando ausente, asegúrate de que la instalación se esté ejecutando desde ese mismo símbolo y de que esté activo el entorno de Python previsto. Después, revisa el registro de compilación completo: puede que un paquete invoque otra herramienta de compilación o use una configuración del compilador que requiera componentes adicionales.

Si el error cambia y aparecen diagnósticos de C++, encabezados ausentes o errores específicos del paquete, significa que el compilador ya se encuentra y que el problema ocurre en una etapa posterior de la compilación. Lee el primer error sustancial de toda la salida y consulta las instrucciones de instalación del paquete y si ofrece una rueda compatible con tu versión de Python y plataforma. Que cl.exe esté disponible no garantiza que todos los paquetes puedan compilarse desde el código fuente.