Cómo corregir “Python no se reconoce” en Windows

El mensaje “Python no se reconoce como un comando interno o externo” aparece cuando Windows no encuentra el ejecutable de Python al escribir python o py en la terminal. Normalmente Python no está instalado, la instalación no fue añadida al PATH, el terminal estaba abierto antes del cambio o los alias de ejecución de aplicaciones están interceptando el comando. La solución correcta consiste en identificar cuál de estas causas se aplica.

Este diagnóstico se relaciona con la instalación y configuración de VS Code en Windows, el uso de entornos virtuales, la instalación de bibliotecas con pip y la corrección de ModuleNotFoundError.

Comprueba el mensaje exacto

Abre PowerShell o el Símbolo del sistema y ejecuta:

python --version
py --version
where python
where py

Si py funciona pero python no, el Python Launcher está instalado y puedes utilizar:

py programa.py
py -m pip install requests

También puedes corregir el PATH para que python funcione.

Verifica si Python está instalado

Busca “Python” en el menú Inicio o revisa la lista de aplicaciones instaladas. Las instalaciones oficiales suelen encontrarse en una ruta parecida a:

C:\Users\TU_USUARIO\AppData\Local\Programs\Python\Python313\

La carpeta exacta cambia según la versión. Dentro debe existir python.exe.

Instalar Python correctamente

Si no está instalado, descarga el instalador oficial y, en la primera pantalla, marca la opción Add python.exe to PATH. Después selecciona la instalación estándar o personalizada según tus necesidades. Al terminar, cierra todas las terminales abiertas y abre una nueva.

python --version
python -m pip --version

Utilizar python -m pip es más confiable que ejecutar pip directamente, porque garantiza que pip pertenece al mismo intérprete.

Por qué debes abrir una nueva terminal

Las terminales reciben una copia de las variables de entorno al iniciarse. Si modificas el PATH mientras PowerShell, CMD o VS Code están abiertos, esas sesiones pueden conservar la configuración anterior. Cierra el terminal integrado y reinicia VS Code si es necesario.

Añadir Python al PATH manualmente

Necesitas añadir normalmente dos carpetas:

C:\Users\TU_USUARIO\AppData\Local\Programs\Python\Python313\
C:\Users\TU_USUARIO\AppData\Local\Programs\Python\Python313\Scripts\

La primera contiene python.exe; la segunda contiene comandos como pip.exe. Para editar el PATH:

1. Busca “variables de entorno” en el menú Inicio.
2. Abre “Editar las variables de entorno del sistema”.
3. Selecciona “Variables de entorno”.
4. En variables del usuario, elige Path y pulsa “Editar”.
5. Añade las dos rutas correctas.
6. Confirma los cambios y abre una terminal nueva.

No copies una ruta de otro equipo. Localiza primero la instalación real.

Encontrar la ruta desde el Explorador

Si Python aparece en el menú Inicio, abre la ubicación del archivo, revisa las propiedades del acceso directo y localiza python.exe. También puedes buscar python.exe dentro de AppData\Local\Programs\Python.

Usar el instalador para reparar

El instalador oficial ofrece opciones de modificación y reparación. Ejecuta nuevamente el instalador correspondiente a la versión instalada, elige modificar y habilita las opciones relacionadas con el launcher y las variables de entorno. Esto suele ser más seguro que editar rutas desconocidas manualmente.

Desactivar alias de Microsoft Store

Windows puede tener alias llamados python.exe y python3.exe que abren Microsoft Store en lugar del intérprete instalado. Busca “Alias de ejecución de aplicaciones” en Configuración y desactiva los alias que interfieran. Después abre una terminal nueva y prueba otra vez.

Comprueba qué ejecutable se está usando

Cuando el comando funciona, verifica la ruta:

where python
python -c "import sys; print(sys.executable)"

Si aparecen varias rutas, el primer directorio del PATH suele tener prioridad. Esto puede explicar por qué una terminal utiliza una versión y VS Code otra.

Configurar el intérprete en VS Code

En VS Code abre la paleta de comandos con Ctrl+Shift+P, busca Python: Select Interpreter y selecciona la instalación o el entorno virtual correcto. El editor puede ejecutar Python aunque el terminal tenga otra configuración, por lo que conviene comprobar ambos.

Crear un entorno virtual

Después de corregir el intérprete, crea un entorno por proyecto:

python -m venv .venv
.venv\Scripts\activate
python -m pip install --upgrade pip

En PowerShell la política de ejecución puede bloquear el script de activación. No desactives permanentemente todas las protecciones; utiliza una política adecuada al usuario o ejecuta el archivo de activación desde una terminal compatible.

Cuando python3 funciona pero python no

En Windows la instalación oficial suele ofrecer python y el launcher py. Algunos entornos adicionales pueden registrar python3. Comprueba los tres comandos, pero utiliza una convención consistente en los scripts y documentación del proyecto.

Cuando pip no se reconoce

Si Python funciona pero pip no:

python -m ensurepip --upgrade
python -m pip install --upgrade pip
python -m pip --version

Esto evita depender del ejecutable pip.exe del PATH. Si python -m pip funciona, ya puedes instalar paquetes correctamente.

Evita mezclar instalaciones

Python puede proceder del instalador oficial, Microsoft Store, Anaconda, Miniconda o herramientas de administración de versiones. Varias instalaciones no son necesariamente un problema, pero debes saber cuál utiliza cada comando:

py -0p

El launcher puede listar versiones registradas. En un proyecto, el entorno virtual debe apuntar a una versión específica.

Comprobar variables desde PowerShell

$env:Path -split ';'

Revisa si la ruta de Python está presente y si aparece después de otra instalación conflictiva. No reemplaces todo el PATH: añade o corrige entradas concretas, porque otras aplicaciones también dependen de esta variable.

Prueba final

Crea prueba.py:

import sys

print("Python funciona")
print(sys.version)
print(sys.executable)

Ejecuta:

python prueba.py

Luego confirma pip:

python -m pip --version

Si ambos comandos muestran rutas coherentes, la configuración principal está resuelta.

Errores frecuentes

Los problemas más comunes son añadir solo la carpeta Scripts y olvidar la carpeta que contiene python.exe, editar el PATH con una ruta de otra versión, mantener la terminal antigua abierta, confundir un alias de Microsoft Store con una instalación real y utilizar pip de otro intérprete. También es un error ejecutar siempre como administrador; la configuración por usuario suele ser suficiente.

La documentación oficial de Python en Windows explica el instalador, el launcher, las rutas y la selección de versiones. La documentación de Microsoft sobre el comando y la variable PATH describe cómo Windows busca ejecutables.

Conclusión

El error “Python no se reconoce” significa que Windows no encuentra el ejecutable solicitado. Comprueba primero py, localiza la instalación real, añade las carpetas correctas al PATH, abre una terminal nueva y desactiva alias conflictivos. Después verifica sys.executable y utiliza python -m pip. Con una única ruta clara por proyecto y entornos virtuales, se evitan la mayoría de los conflictos de instalación.