Cómo solucionar el error de permisos al ejecutar pip.exe en un entorno virtual de Python en Windows

Explicación técnica

El problema ocurre porque el archivo pip.exe en la carpeta Scripts/ de tu entorno virtual es un launcher empaquetado (un archivo .exe que contiene una copia embebida de python.exe y el script __main__.py de pip). Este launcher tiene una ruta fija a python.exe incrustada en su interior. Si esa ruta se vuelve inválida —por ejemplo, porque:

• Se instaló/desinstaló Python (especialmente desde Microsoft Store),
• Se movió o eliminó el Python original,
• Hubo corrupción durante la creación del entorno virtual,

…entonces el launcher falla con un error de "Access is denied" o "Permission denied", aunque los permisos del archivo sean correctos. Esto es falsamente percibido como un problema de permisos, pero en realidad es una corrupción del launcher.

El hecho de que python -m pip funcione confirma que el problema está solo en el launcher pip.exe, no en pip como paquete ni en el entorno virtual.

---

Pasos para solucionarlo (definitivo)

✅ Paso 1: Elimina el launcher corrupto

# En PowerShell o CMD (NO en bash, para evitar problemas de rutas con comillas)
del "C:\Users\<tu-usuario>\ruta\al\proyecto\venv\Scripts\pip.exe"
del "C:\Users\<tu-usuario>\ruta\al\proyecto\venv\Scripts\pip3.exe"

⚠️ Importante: No elimines python.exe, solo los archivos pip*.exe.

✅ Paso 2: Regenera los launchers correctamente

# Asegúrate de que el entorno virtual esté activado
venv\Scripts\activate

# O ejecuta directamente (recomendado para evitar dependencias de PATH):
python -m pip install --upgrade pip --force-reinstall

Esto reinstala pip desde cero y regenera los launchers pip.exe y pip3.exe con la ruta correcta a python.exe del entorno.

🔍 ¿Por qué funciona?

pip install --force-reinstall detecta que los launchers faltan y los reconstruye usando la versión de python.exe que está en venv\Scripts\, no la del sistema.

✅ Paso 3: Verifica que funcione

pip --version
# Debe mostrar algo como: pip 24.0 from ...\venv\lib\site-packages\pip (python 3.10)

---

Bloque de código corregido (script de reinstalación automática)

Crea un archivo fix-venv-pip.bat en la raíz de tu proyecto y ejecútalo como administrador (solo para permisos, no por seguridad):

@echo off
setlocal

:: Configura la ruta a tu entorno virtual
set "VENV_DIR=%~dp0venv"

if not exist "%VENV_DIR%\Scripts\python.exe" (
    echo [ERROR] No se encontró python.exe en el entorno virtual.
    echo Asegúrate de que el entorno exista y esté creado con 'python -m venv venv'.
    exit /b 1
)

echo [INFO] Eliminando launchers corruptos...
del /q "%VENV_DIR%\Scripts\pip.exe" 2>nul
del /q "%VENV_DIR%\Scripts\pip3.exe" 2>nul

echo [INFO] Reiniciando pip con launchers nuevos...
"%VENV_DIR%\Scripts\python.exe" -m pip install --upgrade pip --force-reinstall --no-cache-dir

echo [SUCCESS] ¡Listo! Ahora puedes usar 'pip' dentro del entorno.

📌 Uso: Ejecuta fix-venv-pip.bat desde PowerShell/CMD en la carpeta del proyecto.

---

Pro-tip: Evita este problema en el futuro

1. Nunca uses pip.exe directamente si puedes evitarlo
   
   Usa siempre python -m pip en entornos virtuales. Es más robusto y evita problemas con launchers corruptos.

2. Evita mezclar instaladores de Python (web + Microsoft Store)
   
   La Microsoft Store instala Python en modo silo, con rutas aisladas (C:\Users\...\AppData\Local\Microsoft\WindowsApps\python.exe) que parecen ser python.exe, pero son alias que fallan al ser embebidos en launchers.

3. Si usas múltiples versiones de Python, crea entornos con la versión exacta deseada
   

   "C:\Python310\python.exe" -m venv venv

1. Actualiza pip antes de instalar paquetes

   python -m pip install --upgrade pip

---

✅ Resultado esperado: pip install -e . funcionará sin errores de permisos, y el launcher se regenerará correctamente con la ruta interna a python.exe válida.

---

🚀 ¿Quieres más soluciones técnicas?

Si te sirvió esta ayuda, suscríbete para recibir los errores más comunes de la semana y cómo evitarlos.
👉 Suscríbete aquí