Curso de vibe coding con Python — Suplemento
El problema de las rutas largas en Windows
Cómo resolver los errores de ruta demasiado larga
Windows limita por defecto la longitud de las rutas de archivo a 260 caracteres. Si al instalar bibliotecas de Python o al crear un entorno virtual aparecen errores como path too long, FileNotFoundError o "The filename or extension is too long", la causa es este límite. En esta página se explica cómo activar las rutas largas en Windows. En Mac y Linux este problema no se produce.
Cómo reconocer el problema
Si ve un mensaje de error como el siguiente, lo más probable es que la causa sea una ruta demasiado larga.
ERROR: Could not install packages due to an OSError:
[Errno 2] No such file or directory:
'C:\\Users\\...\\.venv\\Lib\\site-packages\\...\\very_long_filename.py'
Ocurre sobre todo cuando la carpeta del proyecto está muy anidada, por ejemplo en el Escritorio dentro de OneDrive. La ruta hasta su carpeta ya es larga, y las bibliotecas contienen a su vez archivos con nombres largos. Juntos superan con facilidad los 260 caracteres y provocan el error.
Activar las rutas largas (recomendado)
En Windows 10 (versión 1607 o posterior) y Windows 11, este límite se puede quitar cambiando un ajuste del sistema. Lo más sencillo es abrir PowerShell como administrador y ejecutar un solo comando.
- Busque «PowerShell» en el menú Inicio
- Haga clic con el botón derecho en «Windows PowerShell» → «Run as administrator» (en Windows en español, «Ejecutar como administrador»)
- En el cuadro de diálogo del Control de cuentas de usuario, haga clic en «Yes» («Sí»)
- Pegue el comando siguiente y pulse Enter
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
Después de ejecutar el comando, reinicie el ordenador. Tras el reinicio, vuelva a ejecutar pip install. El error ya no debería aparecer.
Este comando cambia un solo valor del registro de Windows y no afecta a la estabilidad del sistema. Es la solución que recomienda oficialmente Microsoft.
Mover la carpeta del proyecto a una ruta más corta
Si no tiene permisos de administrador (por ejemplo, en un ordenador del trabajo o de la universidad con permisos limitados), la alternativa más eficaz es mover la carpeta del proyecto a un lugar con una ruta más corta.
- Evite las rutas profundas, como
C:\Users\long-username\OneDrive\Desktop\Research\2026\... - Use rutas cortas, como
C:\dev\my_first_analysisoC:\work\my_first_analysis
Cree una carpeta nueva, por ejemplo dev o work, directamente en la unidad C y coloque allí su proyecto. Este simple cambio resuelve la mayoría de los problemas de rutas largas.
Si guarda el proyecto en una carpeta sincronizada con OneDrive, la ruta se alarga y, además, la sincronización de OneDrive puede entrar en conflicto con el entorno virtual. Le recomendamos guardar sus proyectos de investigación en una carpeta local fuera de OneDrive.
Activar las rutas largas al instalar Python
Si va a instalar Python por primera vez, es posible que el instalador muestre en la última pantalla el botón «Disable path length limit». Al pulsarlo se activan las rutas largas (aparecerá un cuadro de diálogo para confirmar los permisos de administrador).
Si Python ya está instalado, vuelva a descargar el instalador desde python.org/downloads. Elija «Modify», avance hasta la última pantalla y pulse allí el mismo botón.
Comprobar que se ha resuelto
Cuando haya aplicado una de las soluciones anteriores, vuelva a ejecutar un comando de la Parte 2, como pip install pandas openpyxl. Si aparece «Successfully installed ...» sin ningún error, el problema está resuelto.
Si el error continúa, pegue el mensaje de error completo en ChatGPT o Claude y pida ayuda. El comportamiento exacto puede variar según la versión del sistema y el entorno, así que pedir a un LLM una orientación para su caso suele ser el camino más rápido.