Curso de Python / Escribir, ejecutar y depurar Python en VS Code

Para ejecutar Python en VS Code necesitas un intérprete instalado y seleccionar el entorno correcto en el editor. Abre la carpeta del proyecto y elige su entorno virtual para que la ejecución del código y la instalación de paquetes utilicen el mismo Python.

Preparar el editor y abrir el proyecto

Esta práctica presupone que Python está instalado y que existe un entorno .venv para el proyecto. VS Code es un editor: instalarlo no sustituye la instalación del intérprete. En Extensiones, busca la extensión Python de Microsoft y comprueba el editor antes de instalarla.

En Archivo → Abrir carpeta, selecciona python-lab. Si la interfaz está en inglés, la ruta es File → Open Folder. Abrir la carpeta completa facilita que el código, la terminal y las rutas relativas compartan la misma raíz del proyecto.

La guía de Python para VS Code explica los componentes. Si todavía necesitas preparar .venv, sigue la creación de entornos virtuales con venv antes de instalar paquetes.

Seleccionar y comprobar el intérprete

1. Abre la paleta de comandos y busca Python: Select Interpreter.
2. Selecciona el ejecutable de Python de la carpeta .venv del proyecto. Si no aparece, introduce su ruta.
3. Abre una terminal nueva y comprueba el ejecutable y la ubicación de pip con las siguientes órdenes.

python -c "import sys; print(sys.executable)"
python -m pip --version

En Windows, la ruta del intérprete debería terminar en .venv\Scripts\python.exe; en macOS y Ubuntu, en .venv/bin/python. La ubicación mostrada para pip también debe corresponder a ese entorno. Una terminal que ya estaba abierta puede conservar el entorno anterior aunque hayas cambiado la selección del editor.

Consulta la documentación de entornos de Python en VS Code si la lista no detecta el entorno esperado. Comprobar rutas resulta más útil que instalar repetidamente el mismo paquete en distintos intérpretes.

Ejecutar un archivo completo

Guarda este código como expense.py, en UTF-8 y dentro de la carpeta de práctica. Desde la terminal del entorno seleccionado, ejecuta python expense.py. Fuera de un entorno virtual en macOS o Ubuntu, utiliza python3 si ese es el nombre del intérprete elegido.

amounts = [3500, 8000, 2500]
total = sum(amounts)
print(f"total={total}")

La salida esperada es:

total=14000

También puedes utilizar la orden de la extensión Run Python File. Guarda el archivo antes de ejecutarlo y comprueba que la terminal está trabajando sobre el archivo correcto. Los importes se suman en total; la cadena formateada muestra ese mismo valor.

Depurar y distinguir problemas de configuración

Coloca un punto de interrupción junto a una línea ejecutable posterior al cálculo del total. Inicia la depuración con F5, observa la línea detenida y consulta amounts y total en el panel de variables. Avanza con F10: el valor inspeccionado debe coincidir con el que imprime el programa.

Si necesitas confirmar otra vez qué entorno utiliza la terminal después de seleccionar el intérprete, repite las comprobaciones:

python -c "import sys; print(sys.executable)"
python -m pip --version

La guía oficial de depuración de Python describe la ejecución paso a paso. Un error de importación después de instalar un paquete exige comparar Python y pip; un archivo que no se encuentra exige revisar la carpeta de trabajo y su nombre.

Si los cambios parecen no ejecutarse, comprueba que guardaste el archivo y que estás ejecutando ese archivo. Evita llamar a tus scripts json.py o csv.py, porque pueden ocultar módulos de la biblioteca estándar. Otras extensiones pueden añadir botones con ajustes distintos: empieza con las órdenes de la extensión Python y revisa expresamente cualquier diferencia.