Parte 11 — Errores comunes

“Python no se reconoce”

En Windows puede aparecer un mensaje parecido a:

'python' is not recognized as an internal or external command

O:

El término 'python' no se reconoce como nombre de un cmdlet

Esto significa que la terminal no pudo encontrar Python.

Posibles causas:

• Python no está instalado.
• No se agregó Python a PATH.
• La terminal estaba abierta antes de instalar Python.
• Windows está utilizando un acceso de Microsoft Store.
• El comando correcto en tu sistema es py.

Primera solución: abrir una terminal nueva

Después de instalar Python, cierra la terminal actual.

Presiona el icono de papelera.

Crea una nueva terminal.

Después prueba:

python --version

Las terminales abiertas antes de una instalación pueden no detectar los cambios inmediatamente.

Segunda solución: usar py

En Windows prueba:

py --version

Si funciona, ejecuta:

py main.py

Tercera solución: reinstalar Python

Si Python no aparece, vuelve a ejecutar el instalador oficial.

Asegúrate de marcar:

Add Python to PATH

Después completa la instalación y reinicia VS Code.

En algunos casos puede ser útil reiniciar la computadora.

Microsoft Store se abre al escribir python

Windows puede tener accesos de ejecución que redirigen python hacia Microsoft Store.

Primero comprueba si funciona:

py --version

Si py muestra una versión de Python, puedes utilizarlo.

También puedes revisar los alias de ejecución de aplicaciones dentro de la configuración de Windows, pero no modifiques opciones sin saber cuáles corresponden a Python.

La solución más sencilla suele ser instalar Python desde su sitio oficial y utilizar py.

“Command not found”

En macOS o Linux puede aparecer:

python: command not found

Prueba:

python3 --version

Si funciona, utiliza:

python3 main.py

Si tampoco funciona, Python 3 puede no estar instalado correctamente.

“Can’t open file”

Puede aparecer algo parecido a:

python: can't open file 'main.py': No such file or directory

Esto significa que Python no encontró main.py en la carpeta actual.

Comprueba el contenido.

Windows:

dir

macOS o Linux:

ls

Si main.py no aparece, la terminal está en la carpeta incorrecta o el archivo tiene otro nombre.

Revisar la carpeta abierta

Comprueba que VS Code tenga abierta la carpeta:

mini-finance

No solamente el archivo main.py.

Después cierra y vuelve a abrir la terminal.

La terminal debería iniciar dentro de la carpeta del proyecto.

Revisar el nombre del archivo

Asegúrate de que el archivo se llame:

main.py

No:

Main.py
main.PY
main.py.txt
main

En algunos sistemas, las mayúsculas y minúsculas importan.

Si el archivo se llama Main.py, este comando podría fallar:

python main.py

Tendrías que escribir:

python Main.py

Lo recomendable es utilizar:

main.py

El archivo no muestra los cambios

Supongamos que modificaste:

print("Versión nueva")

Pero al ejecutar sigue apareciendo el texto anterior.

La causa más común es que no guardaste el archivo.

Presiona:

Ctrl + S

Después ejecuta nuevamente.

Comprueba también que estés editando y ejecutando el mismo main.py.

SyntaxError

Código incorrecto:

print("Bienvenido a MiniFinance"

Falta cerrar el paréntesis.

Python puede mostrar:

SyntaxError

Corrige:

print("Bienvenido a MiniFinance")

Comilla sin cerrar

Incorrecto:

print("MiniFinance)

Correcto:

print("MiniFinance")

Python necesita saber dónde comienza y termina el texto.

Usar Print en lugar de print

Incorrecto:

Print("MiniFinance")

Correcto:

print("MiniFinance")

Python distingue mayúsculas y minúsculas.

Escribir el comando dentro del archivo

El archivo main.py debe contener código Python:

print("MiniFinance")

No debes escribir dentro del archivo:

python main.py

Ese es un comando para la terminal.

La diferencia es:

Archivo main.py → Código Python
Terminal → Comandos

Copiar el símbolo del prompt

Si una guía muestra:

$ python main.py

normalmente el símbolo $ representa la terminal.

Debes escribir:

python main.py

No:

$ python main.py

Ejecutar desde otra carpeta

Supongamos que tienes dos proyectos:

Proyectos/
├── mini-finance/
│   └── main.py
└── calculadora/
    └── main.py

Si la terminal está dentro de calculadora, ejecutará el main.py de esa carpeta.

Comprueba siempre la ruta de la terminal.

El programa se cierra demasiado rápido

Si ejecutas el archivo haciendo doble clic desde el Explorador de Windows, puede abrirse una ventana y cerrarse inmediatamente.

Eso ocurre porque el programa termina.

Para aprender y revisar resultados, ejecuta el archivo desde la terminal de VS Code:

python main.py

La terminal permanecerá abierta y podrás ver el resultado.