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

Explicación técnica

El problema ocurre porque el archivo pip.exe en venv/Scripts/ es un launcher empaquetado que contiene una ruta fija a python.exe y un script __main__.py incrustado. Cuando se crea el entorno virtual, este launcher se construye con la ruta exacta del python.exe que se usó para crearlo.

Si esa ruta se vuelve inválida (por ejemplo, porque se desinstaló Python, se movió el entorno, o hubo una instalación incorrecta), el launcher falla con "Access is denied", aunque los permisos del archivo sean correctos. Esto es especialmente común tras múltiples instalaciones/desinstalaciones de Python (desde el sitio web y Microsoft Store), ya que los rutas absolutas quedan corruptas o apuntan a archivos inexistentes.

El hecho de que python -m pip funcione confirma que el problema está específicamente en el launcher, no en los permisos del sistema ni en la configuración de seguridad.

Pasos para solucionarlo

1. Elimina el entorno virtual actual

# Desde la raíz del proyecto
rm -rf venv/
# O en Windows CMD:
rmdir /s /q venv

2. Crea un nuevo entorno virtual usando la versión exacta de Python que necesitas

# Asegúrate de que la versión deseada esté en PATH (verifica con `python --version`)
python -m venv venv

⚠️ Importante: Usa python -m venv, no py -3.10 -m venv ni herramientas externas como virtualenv. Esto garantiza que el launcher se construya con la ruta correcta al python.exe del entorno.

3. Verifica que pip.exe funcione correctamente

"C:\ruta\al\proyecto\venv\Scripts\pip.exe" --version

Debería mostrar algo como: pip 23.x.x from C:\...\venv\lib\site-packages\pip (python 3.10)

4. Usa siempre python -m pip como práctica segura

Aunque el launcher funcione, evita problemas futuros usando:

venv\Scripts\python.exe -m pip install -e .

o tras activar el entorno:

python -m pip install -e .

Bloque de código corregido

Script de diagnóstico (opcional, para verificar el launcher)

Crea check_pip_launcher.py:

import sys
try:
    with open(sys.argv[1], 'rb') as f:
        data = f.read()[-4096:]
    i = data.rfind(b'PK\x05\x06')
    i0 = data.rfind(b'#!', 0, i) + 2
    i1 = data.find(b'\n', i0)
    path = data[i0:i1].strip(b'"').decode()
    print(f"Embedded python.exe path: {path}")
except Exception as e:
    print(f"Error reading launcher: {e}")

Ejecuta desde CMD (sin activar el entorno):

python check_pip_launcher.py "C:\ruta\al\proyecto\venv\Scripts\pip.exe"

✅ Salida esperada: Embedded python.exe path: C:\Users\...\venv\Scripts\python.exe

❌ Si muestra una ruta a un archivo inexistente (ej. C:\Python39\python.exe), el launcher está corrupto.

Pro-tip

• Nunca muevas ni copies el entorno virtual. Si necesitas reutilizarlo, recrea el entorno desde cero.
• Evita usar pip.exe directamente. Usa siempre python -m pip en entornos virtuales: es más robusto y evita problemas con launchers corruptos.
• Si usas múltiples versiones de Python, instálalas desde el Python.org installer (no Microsoft Store) y marca la opción "Add Python to PATH" durante la instalación.
• Para entornos productivos, considera usar py -3.10 -m venv venv para forzar la versión exacta.

🔑 Clave final: El error no es de permisos del sistema, sino de rutas rotas en el launcher. La solución definitiva es recrear el entorno con python -m venv y evitar manipular archivos del entorno manualmente.