Si alguna vez intentaste ejecutar Python en Windows y te topaste con el clásico:
'python' is not recognized as an internal or external command
Sí, no eres el único. Esta frustración surge cuando Windows no encuentra el ejecutable de Python en la ruta de acceso del sistema. Es como decirle: “Oye, instalé Python, pero olvidé decirte dónde se encuentra”.La buena noticia es que solucionar esto suele ser bastante sencillo, y significa que puedes ejecutar Python y pip desde cualquier terminal sin tener que escribir la ruta completa de la carpeta cada vez. Eso te ahorra la cordura.
En esta guía, encontrarás varias maneras eficaces de que Python sea reconocido. Ya sea que hayas instalado desde python.org, usado la Microsoft Store o simplemente hayas tenido un error durante la configuración, aquí encontrarás una solución que te ayudará a optimizar tu línea de comandos. Además, explicaremos cómo verificar el funcionamiento de tu configuración y evitar errores comunes que suelen confundir a los usuarios.
¿Por qué se bloquea el comando ‘python’?
Esto suele ocurrir porque Windows busca programas en la variable de entorno PATH. Si el directorio de Python no está incluido, al escribir pythonen la terminal simplemente se pierde información. No se encuentra. Esto puede ocurrir si no se marcó la casilla para agregar Python a PATH durante la instalación o si se produjo algún error durante el proceso.
Es un poco raro, pero a Windows le gusta que le indiquen explícitamente dónde están los programas. Por lo tanto, solucionarlo suele implicar actualizar PATH o usar el lanzador de Python (py.exe), que gestiona mejor varias versiones y no requiere modificar las variables de entorno cada vez.
Cómo solucionar el error “Python no reconocido” en Windows
Método 1: usar el instalador de Python para agregarlo automáticamente a PATH (mejor opción)
Absolutamente la forma más fácil. Si instalaste Python desde python.org, el instalador puede hacer el trabajo pesado por ti, incluyendo agregar Python a tu PATH durante la configuración.
- Descargue el último instalador de python.org.
- Ejecuta el instalador. Cuando se abra, asegúrate de marcar la casilla “Agregar Python 3.x a PATH” en la parte inferior antes de hacer clic en “Instalar ahora”. A veces, Windows activa esta casilla de forma discreta, así que no la ignores.
- Finalizar la instalación. Al finalizar, cierre el instalador.
- Abra una nueva terminal (ya sea el Símbolo del sistema o PowerShell) y escriba:
python --version pip --version where python where pip Si todo está configurado correctamente, deberías ver tu versión de Python y la de pip sin errores. En algunas configuraciones, la primera vez podría no reconocer los comandos, así que intenta cerrar la terminal y abrir una nueva.
Método 2: Agregar Python manualmente a su PATH de usuario (no se necesita administrador)
Esto ocurre si no seleccionaste la opción PATH durante la instalación o si se perdió. Puedes agregar los directorios tú mismo; solo necesitas modificar un poco el entorno de Windows. Ten en cuenta que esto solo afecta a tu cuenta de usuario, no a todos los usuarios del sistema. No necesitas derechos de administrador, ¡genial!
- Presione Win + R, escriba
sysdm.cply presione Enter. Se abrirá la ventana Propiedades del sistema. - Cambie a la pestaña Avanzadas y haga clic en Variables de entorno…
- En Variables de usuario, busque y seleccione Ruta y luego haga clic en Editar.
- Haga clic en Nuevo y péguelo en su directorio de instalación de Python, como:
C:\Users\\AppData\Local\Programs\Python\Python311 Y no olvides la carpeta Scripts, que es donde se encuentran pip y otras herramientas:
C:\Users\\AppData\Local\Programs\Python\Python311\Scripts - Utilice el botón Subir para priorizar estas entradas si es necesario.
- Haga clic en Aceptar en todas las ventanas y luego reinicie su terminal.
- Comprueba si tiene éxito con los mismos comandos que antes:
python --version pip --version where python where pip Atención: asegúrate de evitar errores comunes como añadir una barra invertida innecesariamente ( …\Python311vale, …\Python311\no), y comprueba que no haya rutas inválidas en tu variable PATH. Windows puede ser implacable si dejas entradas incorrectas.
Método 3: Gestionar instalaciones de Python en Microsoft Store con alias de aplicaciones
Si obtuvo Python de Microsoft Store, a menudo depende de alias de ejecución de aplicaciones : son como atajos que configura el sistema operativo, pero que a veces pueden interferir o entrar en conflicto con su RUTA.
- Abra la configuración de Windows y busque Administrar alias de ejecución de aplicaciones.
- Encuentra entradas para
python.exeypython3.exe. Desactívalas o actívalas si es necesario; a veces dificultan que sepythonabra la Tienda o causan otros problemas. - Además, asegúrese de que su PATH de usuario incluya:
C:\Users\\AppData\Local\Microsoft\WindowsApps Una vez configurado, reinicia tu terminal e inténtalo de nuevo con [Nombre del usuario python --version].Reconocimiento instantáneo si se coloca correctamente. A veces, esto solo funciona después de reiniciar o cerrar sesión.
Método 4: usar el lanzador de Python (ideal para varias versiones de Python)
El lanzador de Python (py.exe) se instala automáticamente al instalar desde python.org. Te ayuda a ejecutar diferentes versiones de Python sin tener que modificar constantemente la ruta. Si estás trabajando con varias versiones de Python, esto es fundamental.
- Comprueba si puedes llamarlo:
py --version Si eso devuelve una versión, perfecto. Luego puedes ejecutar versiones específicas de Python como:
py -3 py -3.11 py -2.7 ¿Quieres crear un entorno virtual? Fácil:
py -3.11 -m venv myenv myenv\Scripts\activate python --version Consejo adicional: úsalo py --listpara ver todos los entornos de ejecución de Python detectados. Es perfecto para gestionar varios proyectos sin tener que modificar la ruta cada vez. Más información en la documentación oficial de Python.
Consejos rápidos para la solución de problemas
¿Sigue sin funcionar? Ejecuta estos comandos para comprobarlo:
where python where python3 where py Y verificar pip también:
pip --version where pip Si Python abre la Microsoft Store en lugar de la instalación local, probablemente se deba a la configuración de alias de la aplicación. Desactívala en Configuración → Aplicaciones → Aplicaciones y funciones → Aplicaciones y funciones → Administrar alias de ejecución de aplicaciones.
Y, por supuesto, intenta cerrar la terminal por completo y volver a abrirla después de realizar cambios. A veces, Windows simplemente necesita un reinicio para reconocer las nuevas variables de entorno.
Resumen
La mayoría de los errores de “Python no se reconoce” se deben a configuraciones incorrectas de PATH o a problemas con el alias de la aplicación. Activar la casilla PATH del instalador, editar manualmente las variables de entorno o activar y desactivar los accesos directos de la aplicación suele ser la solución. La clave está en asegurarse de que Windows sepa exactamente dónde encontrar Python.
Una vez que todo esté configurado, su vida en la línea de comandos se volverá mucho más fácil: ya no tendrá que escribir rutas largas ni reinstalar Python por tercera vez.