Curso de vibe coding con Python — Suplemento

El problema de las rutas largas en Windows

Cómo resolver los errores de ruta demasiado larga

Ilustración de carpetas anidadas que forman una ruta 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.

Me sale «path too long».
Windows limita la ruta de un archivo a 260 caracteres. Con un cambio en la configuración se puede quitar ese límite.
01

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.

Ejemplo de error
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.

02

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.

  1. Busque «PowerShell» en el menú Inicio
  2. Haga clic con el botón derecho en «Windows PowerShell» → «Run as administrator» (en Windows en español, «Ejecutar como administrador»)
  3. En el cuadro de diálogo del Control de cuentas de usuario, haga clic en «Yes» («Sí»)
  4. Pegue el comando siguiente y pulse Enter
PowerShell (administrador)
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.

03

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_analysis o C:\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.

04

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.

Entonces, conviene guardar las carpetas de investigación fuera de OneDrive, en una ruta corta.
Así es. Si el error sigue, basta con pegar el mensaje completo en un LLM y pedirle ayuda.