Variable PATH de Python: soluciona “command not found” y más

Escribes python y te sale “command not found”. O pip corre, pero instala en un Python distinto al que esperabas. O tu script funciona en la terminal y muere en cron; funciona en tu máquina y falla en CI. Todos estos dolores, engañosamente simples y de los más difíciles de depurar, rastrean al mismo origen: el PATH y las variables de entorno. Y como el PATH es por proceso y se hereda, lo que ves en tu terminal casi nunca es lo que ve cron, Docker o tu pipeline.

Esta guía gratuita es el manual completo de diagnóstico y reparación de los problemas de PATH en Python para 2026, escrita para el desarrollador que choca con “python: command not found” en una máquina nueva, el ingeniero cuyo pip install funciona pero el import falla, el usuario que pelea con pyenv y conda en conflicto y el equipo que estandariza la configuración en máquinas mixtas. No damos por sentada ninguna experiencia previa con la shell: cada error se explica con su síntoma, el comando de diagnóstico y la solución exacta.

Lo que aprenderás

• Cómo funciona el PATH de verdad en 2026 y las reglas de orden de búsqueda.
• El triaje de 60 segundos para ubicar la causa sin dar vueltas.
• Resolver “python: command not found” desde el descubrimiento básico del PATH.
• Saber cuál Python se ejecuta cuando tienes varios en el PATH.
• Corregir cuando pip apunta a un Python distinto al de python.
• Entender PYTHONPATH y el problema de la ruta de importación.
• Cómo VIRTUAL_ENV y la activación de venv modifican el PATH.
• Configurar bien los archivos del shell: bashrc, zshrc, profile y login vs interactivo.
• Editar el PATH en Windows con el registro y el lanzador py.
• Manejar el PATH en macOS con Homebrew y en Linux con pyenv y conda.
• Qué pasa con el PATH en contenedores y en CI.
• Diferencia entre cambios de PATH persistentes y solo de sesión, más la receta de recuperación.

La guía es honesta: el PATH es por proceso y se hereda, la activación solo lo modifica, y python -m pip le gana al pip a secas. Cada comando se verificó con cuidado. Descárgala gratis, sin registro ni correo, y deja tu Python predecible en cualquier contexto, compres o no una de nuestras guías pagas.