Guía para Ejecutar Python en VS Code

Visual Studio Code se ha convertido en el compañero de viaje inseparable para millones de desarrolladores alrededor del mundo. Su ligereza, flexibilidad y un ecosistema de extensiones casi infinito lo posicionan como una de las mejores herramientas para programar. Si estás incursionando en el mundo de Python o buscas un editor más potente, has llegado al lugar correcto. En esta guía completa, te llevaremos de la mano desde la instalación hasta la ejecución y depuración de tu primer programa en Python, transformando a VS Code en un entorno de desarrollo integrado (IDE) a tu medida.

A lo largo de este artículo, no solo aprenderás a presionar el botón de "play", sino que entenderás cómo configurar un entorno de trabajo profesional, gestionar las dependencias de tu proyecto y utilizar las herramientas de depuración para cazar esos molestos bugs que a todos nos quitan el sueño. ¡Prepárate para potenciar tu flujo de trabajo con Python!

Preparando el Terreno: ¿Qué Necesitas?

Antes de escribir nuestra primera línea de código, debemos asegurarnos de tener todas las herramientas necesarias. El proceso es sencillo y solo requiere tres componentes clave: Visual Studio Code, un intérprete de Python y la extensión oficial de Python para VS Code.

1. Instalación de Visual Studio Code

Si aún no lo tienes, puedes descargarlo desde su web oficial. La instalación es intuitiva en cualquier sistema operativo:

• Windows: Puedes usar el instalador de la web o, si eres fan de la línea de comandos, usar el gestor de paquetes WinGet con winget install Microsoft.VisualStudioCode. También está disponible en la Microsoft Store para una instalación con un solo clic.
• macOS: Descarga la aplicación desde la web y arrástrala a tu carpeta de Aplicaciones. Si usas Homebrew, simplemente ejecuta brew install --cask visual-studio-code en tu terminal.
• Linux: La página de descargas ofrece paquetes en formatos .deb (para Debian/Ubuntu) y .rpm (para Fedora/CentOS). También puedes encontrarlo en tiendas de aplicaciones como Snap Store.

2. Instalación de un Intérprete de Python

VS Code es un editor de texto; necesita un intérprete de Python para poder entender y ejecutar tus scripts. Es fundamental que instales Python en tu sistema.

• Windows: Ve a python.org y descarga la última versión estable. Durante la instalación, asegúrate de marcar la casilla que dice "Add Python to PATH" para que puedas ejecutarlo fácilmente desde la terminal.
• macOS: El sistema operativo suele incluir una versión antigua de Python. Es altamente recomendable instalar una versión moderna usando un gestor de paquetes como Homebrew: brew install python3.
• Linux: La mayoría de las distribuciones de Linux ya vienen con Python 3 preinstalado. Para instalar paquetes, solo necesitarás asegurarte de tener `pip`, el gestor de paquetes de Python.

Para verificar que la instalación fue exitosa, abre una terminal y escribe python3 --version (en macOS/Linux) o py -3 --version (en Windows). Deberías ver la versión que acabas de instalar.

3. La Extensión de Python para VS Code

Este es el componente mágico que une todo. Abre VS Code, ve a la vista de Extensiones (el icono de los bloques en la barra lateral izquierda), busca "Python" (de Microsoft) y haz clic en "Instalar". Esta extensión de Python te proporcionará características como IntelliSense (autocompletado de código), linting (detección de errores) y soporte para depuración.

Creando tu Espacio de Trabajo

Con todo instalado, es hora de organizar nuestro proyecto. Es una buena práctica trabajar dentro de una carpeta específica para cada proyecto, lo que VS Code llama un "workspace".

1. Abre tu terminal o línea de comandos.
2. Crea una nueva carpeta y navega hacia ella: mkdir mi_proyecto_python && cd mi_proyecto_python
3. Abre VS Code en esa carpeta: code .

Al hacer esto, VS Code se abrirá con esa carpeta como la raíz de tu proyecto, lo que facilitará la gestión de archivos.

Entornos Virtuales: Tu Aliado Esencial

Imagina que trabajas en dos proyectos: uno necesita la versión 1.0 de una librería y el otro necesita la versión 2.0. Si instalas ambas globalmente, tendrás conflictos. La solución es usar un entorno virtual. Este crea una carpeta aislada dentro de tu proyecto con su propia instalación de Python y sus propios paquetes. Es una de las prácticas más importantes en el desarrollo con Python.

Crear uno en VS Code es muy fácil:

1. Abre la Paleta de Comandos con `Ctrl+Shift+P` (o `Cmd+Shift+P` en macOS).
2. Escribe y selecciona `Python: Create Environment`.
3. Elige `Venv` como tipo de entorno.
4. Selecciona el intérprete de Python que instalaste anteriormente.

VS Code creará una carpeta llamada `.venv` en tu proyecto y la activará automáticamente. Verás el nombre del intérprete seleccionado en la esquina inferior derecha de la ventana. Si no es así, haz clic ahí y selecciona el que se encuentra dentro de la carpeta `.venv`.

¡A Programar! Tu Primer Script

Ahora sí, lo divertido. En el explorador de archivos de VS Code (el primer icono en la barra lateral), haz clic en el botón "Nuevo archivo" y nómbralo `app.py`.

Pega el siguiente código en el editor:

import random frases = [ "¡Un seis! ¡Has ganado!", "Casi, sigue intentando.", "Un uno, qué mala suerte.", "¡Buen lanzamiento!", "La suerte está de tu lado." ] print("¡Lanza el dado!") dado = random.randint(1, 6) print(f"Ha salido un: {dado}") if dado == 6: print(frases[0]) else: print(random.choice(frases[1:]))

Mientras escribes, notarás que IntelliSense te sugiere nombres de funciones y métodos. Esto es gracias a la extensión de Python. No olvides guardar el archivo (`Ctrl+S`).

Ejecutando tu Código: Múltiples Caminos

VS Code ofrece varias maneras de ejecutar un script de Python, cada una útil en diferentes escenarios. Exploremos las más comunes.

1. El Botón "Play": La forma más directa. En la esquina superior derecha del editor, verás un icono de reproducción (un triángulo). Al hacer clic en él, VS Code abrirá un panel de terminal, activará tu entorno virtual y ejecutará el comando `python app.py` por ti. Verás el resultado impreso directamente en la terminal.
2. El Menú Contextual: Haz clic derecho en cualquier parte del editor y selecciona `Run Python > Run Python File in Terminal`. El resultado es idéntico al del botón "Play".
3. Ejecutar Selección/Línea: A veces solo quieres probar un pequeño fragmento de código. Selecciona las líneas que deseas ejecutar, presiona `Shift+Enter`. VS Code abrirá una terminal interactiva de Python (conocida como REPL) y enviará solo el código seleccionado. Esto es increíblemente útil para experimentar.
4. La Terminal Integrada: Puedes tomar el control total. Abre una nueva terminal (`Ctrl+Shift+Ñ` o desde el menú `Terminal > New Terminal`). Como tu entorno virtual ya está activado, simplemente escribe `python app.py` y presiona Enter.

Tabla Comparativa de Métodos de Ejecución

Depuración: El Arte de Encontrar Errores

Escribir código es solo la mitad del trabajo; la otra mitad es encontrar por qué no funciona como esperabas. El depurador de VS Code es una herramienta potentísima para esto.

1. Establecer un Breakpoint: Ve a la línea donde quieres que el programa se detenga. Por ejemplo, en la línea `print(f"Ha salido un: {dado}")`. Haz clic en el margen izquierdo, justo al lado del número de línea. Aparecerá un círculo rojo. Esto es un breakpoint (punto de interrupción).
2. Iniciar la Depuración: Presiona la tecla `F5`. VS Code te preguntará qué configuración de depuración usar. Elige `Python File`.
3. Inspeccionar el Estado: El programa se ejecutará y se detendrá justo en tu breakpoint. La línea se resaltará en amarillo. Ahora puedes:
   • Ver el valor de todas tus variables locales en el panel "Variables" a la izquierda. Pasa el cursor sobre la variable `dado` en el código y verás su valor actual.
   • Usar la barra de herramientas de depuración que aparece en la parte superior para controlar el flujo: continuar (`F5`), pasar a la siguiente línea (`F10`), entrar en una función (`F11`) o detener la depuración (`Shift+F5`).
   • Interactuar con tu programa en la "Consola de Depuración". Puedes escribir nombres de variables para ver su valor o incluso ejecutar código.

Usar el depurador en lugar de llenar tu código de `print()` te ahorrará horas de frustración y te ayudará a entender realmente lo que está sucediendo.

Potenciando tu Proyecto con Paquetes

Rara vez un proyecto se basa solo en las librerías estándar de Python. Lo más probable es que necesites paquetes externos de PyPI (el Python Package Index). Supongamos que quieres usar la popular librería `numpy`.

1. Instalar un paquete: Abre la terminal integrada en VS Code (`Ctrl+Shift+Ñ`). Asegúrate de que tu entorno virtual esté activo (deberías ver `(.venv)` al principio de la línea). Luego, instala el paquete con pip: pip install numpy.
2. Gestionar dependencias: A medida que tu proyecto crece, añadirás más paquetes. Es una práctica estándar mantener un registro de ellos en un archivo. Para generar este archivo, ejecuta: pip freeze > requirements.txt.

Este comando crea un archivo llamado requirements.txt con una lista de todos los paquetes y sus versiones exactas. Si otro desarrollador (o tú mismo en otra máquina) quiere configurar el proyecto, solo necesita crear un entorno virtual y ejecutar pip install -r requirements.txt para instalar todas las dependencias de una sola vez.

Preguntas Frecuentes (FAQ)

¿Puedo usar diferentes versiones de Python?

¡Absolutamente! Puedes tener varias versiones de Python instaladas en tu sistema. Para cambiar entre ellas para un proyecto, usa la Paleta de Comandos (`Ctrl+Shift+P`) y busca `Python: Select Interpreter`. VS Code te mostrará una lista de todos los intérpretes que ha detectado, incluyendo los de tus entornos virtuales.

Mi código funciona en la terminal pero no con el botón "Play". ¿Por qué?

Este es un problema común. Generalmente significa que el intérprete seleccionado para VS Code (el que se muestra en la esquina inferior derecha) no es el mismo donde instalaste tus paquetes. Asegúrate de haber seleccionado el intérprete correcto, específicamente el que está dentro de tu carpeta `.venv`.

¿Qué es la "Paleta de Comandos" y por qué es tan útil?

La Paleta de Comandos (`Ctrl+Shift+P`) es el centro neurálgico de VS Code. Te da acceso a todas las funcionalidades del editor mediante una simple búsqueda de texto. En lugar de memorizar atajos de teclado o buscar en los menús, puedes abrir la paleta y escribir lo que quieres hacer, como "crear entorno" o "seleccionar intérprete".

¡Felicidades! Has completado el recorrido para convertir Visual Studio Code en un potente entorno de desarrollo para Python. Has aprendido a configurar tu espacio de trabajo, crear entornos virtuales, ejecutar y depurar tu código, y gestionar las dependencias de tu proyecto. Este es solo el comienzo; te animamos a seguir explorando las miles de extensiones y configuraciones que harán de VS Code la herramienta perfecta para ti.