Cuando veas'python' is not recognized as an internal or external commandeste error, significa que Windows no puede encontrar el ejecutable de Python en la variable de entorno PATH.

Al agregar el directorio correcto a PATH, podrás ejecutar Python y pip desde cualquier terminal sin necesidad de escribir la ruta completa.

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

Para obtener orientación detallada sobre PATH, las opciones del instalador y Python Launcher, consulta la sección «Usar Python en Windows» de la documentación oficial de Python (docs.python.org).

Método 1: Agregar PATH con el instalador oficial (recomendado)

El instalador de python.org puede configurar PATH por ti directamente, evitando errores de escritura manual, y además agrega la carpeta Scripts necesaria para pip.

El mismo instalador también puedeModifyagregar PATH a una instalación existente mediante la opción correspondiente, sin necesidad de desinstalar y volver a instalar.

Pasos

Pantalla de instalación: asegúrate de marcar la opción PATH:

Los usuarios con instalación existente deben seleccionar la opción Modify:

Verificar si la instalación fue exitosa:

python --version
pip --version
where python
where pip

Si ya tienes Python instalado pero no marcaste la opción PATH en su momento, solo vuelve a ejecutar el instalador y seleccionaModify«Modify», luego marca «Add python.exe to PATH» y, una vez completada la instalación, vuelve a abrir la terminal.

Método 2: Agregar Python a PATH manualmente (a nivel de usuario)

Si no habilitaste la opción PATH al instalar Python, o necesitas ajustar solo las variables de entorno del usuario actual sin afectar las variables del sistema, puedes editar PATH manualmente.

Pasos

Paso 1: abrir Propiedades del sistema mediante sysdm.cpl:

Paso 2: ventana de Variables de entorno:

Paso 3: editar la variable Path:

Paso 4: crear la entrada con la ruta de instalación de Python:

Paso 5: agregar el directorio Scripts:

Paso 6: subir la entrada para que se encuentre con prioridad:

Paso 7: confirmar y guardar en todos los cuadros de diálogo:

Paso 9: verificar el resultado:

python --version
pip --version
where python
where pip

Precauciones y errores comunes

Método 3: Reparar el «alias de ejecución de aplicaciones» instalado desde Microsoft Store

Si instalaste Python desde Microsoft Store, se usa el «alias de ejecución de aplicaciones» y el directorio WindowsApps para resolver el comando python, en lugar de la edición tradicional de PATH.

Pasos

Entrada de configuración de alias de ejecución de aplicaciones:

Conmutadores de alias de python.exe y python3.exe:

Si escribes `python`pythony se abre Microsoft Store en lugar de ejecutar Python, significa que el alias apunta a Store. Desactiva el alias de la versión correspondiente, instala la versión desde python.org, o usa Python Launcher (comando py) que se explica a continuación.

Método 4: Usar Python Launcher en lugar de editar PATH

Python Launcher（py.exeSe instala junto con las compilaciones de python.org y puede localizar automáticamente las versiones de Python instaladas según su etiqueta, evitando así por completo los conflictos de PATH.

Esta es la solución oficial recomendada para administrar múltiples versiones: sin necesidad de modificar PATH, puedes fijar una versión específica de Python para cada proyecto.

Pasos

Comprobar la versión de Launcher:

py --version

Ejecutar explícitamente la versión de Python deseada:

py -3
py -3.11
py -3.10 -m pip --version

Crear y usar entornos virtuales con Launcher:

# 使用指定版本创建虚拟环境
py -3.11 -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 在虚拟环境中确认 Python 版本
python --version

Notas complementarias

Con py Launcher, puedes omitir por completo los pasos de editar PATH manualmente. Launcher detecta automáticamente todas las versiones de Python instaladas y te permite elegir la que necesites; esto es especialmente útil para quienes necesitan Python 3.10 y 3.12 al mismo tiempo.

Verificación rápida y solución de problemas

Confirmar qué ejecutable se está ejecutando

where python
where python3
where py

Verificar pip y Scripts

pip --version
where pip

Solución de problemas comunes

Resumen

Una vez que PATH esté configurado correctamente —o comiences a usar Python Launcher— podrás ejecutar Python y pip desde cualquier ubicación sin necesidad de escribir la ruta completa.

Para entornos con múltiples versiones, se recomienda encarecidamente usar Python Launcher para seleccionar con precisión la versión y combinarlo con entornos virtuales para mantener el aislamiento de dependencias de cada proyecto.