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

Explicación técnica

El problema ocurre porque pip.exe es un launcher empaquetado que contiene una ruta fija a python.exe. Cuando se crea un entorno virtual, Python embebe la ruta absoluta del python.exe usado para crearlo dentro del archivo pip.exe. Si esa ruta se vuelve inválida (por ejemplo, al reinstalar Python, cambiar de versión, mover el entorno, o por permisos en el directorio temporal), el launcher falla con un error de acceso denegado (Access is denied.), incluso si el usuario tiene permisos correctos sobre el archivo.

Este es un comportamiento conocido en entornos Windows donde:

• El launcher pip.exe no es un binario nativo, sino un ZIP autocontenido con un script de inicio y la ruta al intérprete.
• Si la ruta embebida apunta a un python.exe inaccesible (por ejemplo, eliminado, movido, o con permisos corruptos), el lanzamiento falla.
• Esto es independiente de los permisos del propio pip.exe, como ya verificaste con icacls.

Pasos para solucionar el problema

✅ Paso 1: Verifica la ruta embebida en pip.exe

Crea un script temporal (check_pip_launcher.py) con el siguiente contenido:

import sys

def extract_python_path(pip_exe_path):
    with open(pip_exe_path, 'rb') as f:
        data = f.read()
    # Busca el ZIP central directory (PK\x05\x06)
    i = data.rfind(b'PK\x05\x06')
    if i == -1:
        print("Error: No ZIP central directory found.")
        return
    # Busca el shebang '#!' dentro del ZIP
    i0 = data.rfind(b'#!', 0, i) + 2
    i1 = data.find(b'\n', i0)
    if i0 == 1 or i1 == -1:
        print("Error: No shebang found.")
        return
    path = data[i0:i1].strip(b'"').decode()
    print(f"Embedded python.exe path: {path}")

if __name__ == "__main__":
    if len(sys.argv) != 2:
        print("Usage: python check_pip_launcher.py <path_to_pip.exe>")
        sys.exit(1)
    extract_python_path(sys.argv[1])

Ejecútalo desde CMD (no desde bash) y sin activar el entorno virtual:

python check_pip_launcher.py "C:\Users\<username>\<project dir>\venv\Scripts\pip.exe"

⚠️ Importante: Reemplaza <username> y <project dir> con tus valores reales. Usa comillas si hay espacios en la ruta.

✅ Paso 2: Si la ruta embebida es inválida, recrea pip.exe

La solución definitiva es regenerar los launchers del entorno virtual. No reemplaces manualmente archivos: usa python -m venv --upgrade o recrea el entorno.

Opción A (recomendada): Actualizar solo los launchers

"C:\Users\<username>\AppData\Local\Programs\Python\Python310\python.exe" -m venv --upgrade "C:\Users\<username>\<project dir>\venv"

🔍 Asegúrate de usar el python.exe de la versión correcta (3.10 en tu caso). Verifica la ruta con where python o Get-Command python en PowerShell.

Opción B: Recrear el entorno (si la anterior falla)

# Desactiva el entorno si está activo
deactivate

# Elimina el entorno actual
rmdir /s /q "C:\Users\<username>\<project dir>\venv"

# Crea uno nuevo con Python 3.10 explícitamente
"C:\Users\<username>\AppData\Local\Programs\Python\Python310\python.exe" -m venv "C:\Users\<username>\<project dir>\venv"

# Activa el nuevo entorno
"C:\Users\<username>\<project dir>\venv\Scripts\activate"

# Verifica que pip funcione
pip --version

✅ Paso 3: Verificación final

Ejecuta desde CMD (sin activar entorno):

"C:\Users\<username>\<project dir>\venv\Scripts\pip.exe" --version

Debería mostrar algo como:

pip 23.2.1 from C:\Users\<username>\<project dir>\venv\Lib\site-packages\pip (python 3.10)

Pro-tip: Evita este problema en el futuro

• Nunca muevas ni copies directorios de entornos virtuales. Si necesitas moverlos, recrea el entorno.
• Usa python -m pip en lugar de pip.exe directamente. Es más robusto y evita problemas con launchers corruptos:

  python -m pip install -e .

• Si usas múltiples versiones de Python, instala cada versión desde el instalador oficial de python.org (no desde Microsoft Store), ya que este último puede causar problemas con rutas y permisos en entornos virtuales.
• Considera usar herramientas como pyenv o conda si gestionas múltiples entornos frecuentemente.

💡 Nota clave: El error no es de permisos del archivo pip.exe, sino de rutas rotas embebidas en el launcher. La solución no es cambiar ACLs, sino regenerar el launcher con la ruta correcta a python.exe.