【Introducción al Desarrollo con Python】Cómo Configurar y Ejecutar Python en VSCode

"Quiero empezar a programar, pero no sé por dónde empezar..."
"Solo escuchar 'configuración de entorno' ya suena complicado..."

Hace solo unos meses, yo me sentía exactamente igual. Empecé desde cero, me topé con el muro de los errores una y otra vez, y pasaba los días buscando soluciones. Ahora, con la ayuda de la IA, he llegado a un punto en el que puedo lanzar sitios web por mi cuenta.

Este artículo es una "Guía para configurar un entorno de desarrollo de Python con VSCode", escrita como si fuera para mi yo del pasado. He intentado evitar la jerga técnica tanto como ha sido posible y lo he llenado de mis propias experiencias, incluyendo los puntos en los que me quedé atascado y los momentos "¡ajá!" que me ayudaron a entender.

El objetivo de este artículo no es solo que sigas unos pasos. Es que experimentes la pequeña emoción de ver el código que escribiste con tus propias manos "funcionar" en tu PC, y que tengas el mejor comienzo posible en tu viaje de aprendizaje de la programación. He preparado código que puedes copiar y pegar para que funcione, ¡así que sígueme con confianza!

PASO 1: Instalar Python [¡El primer y más crucial obstáculo!]

Primero, instalemos el lenguaje de programación Python en tu PC. Este es el primer y más importante paso. En particular, olvidar una casilla específica puede llevarte a un pozo sin fondo de errores de "¡comando no encontrado!" más adelante, así que procedamos con cuidado juntos.

Descargar el instalador desde el sitio web oficial

Lo primero es lo primero, consigue el instalador desde el sitio web oficial de Python.

1. Ve a la página de descargas oficial de Python.
2. Haz clic en el botón amarillo que dice "Download Python x.x.x" para descargar el instalador. (La última versión estable está bien).

【Crucial】La casilla mágica durante la instalación

Cuando abras el instalador descargado, aparecerá la pantalla de instalación. Aquí, lo único que no debes olvidar bajo ningún concepto es marcar la casilla "Add python.exe to PATH" en la parte inferior de la pantalla.

Después de marcar la casilla, haz clic en "Install Now" para iniciar la instalación. Una vez que termine, puedes hacer clic en "Close".

Verifiquemos si se instaló correctamente

Asegurémonos de que tu PC ha conocido correctamente a Python. Abre el "Símbolo del sistema" o "PowerShell" en Windows, o la "Terminal" en un Mac, y escribe el siguiente comando, luego presiona Enter.

python --version

Si ves algo como Python 3.12.4, mostrando la versión que instalaste, ¡es un gran éxito! Si obtienes un error, es muy probable que hayas olvidado marcar la casilla "Add python.exe to PATH". En ese caso, intenta desinstalar Python y volver a intentar este paso.

PASO 2: Instalar VSCode (Visual Studio Code)

A continuación, instalemos "VSCode", un editor de alto rendimiento para escribir código. Es como una "navaja suiza" para los programadores y se puede utilizar para el desarrollo en cualquier lenguaje, no solo en Python.

1. Ve a la página de descargas oficial de VSCode.
2. Haz clic en el botón correspondiente a tu sistema operativo (Windows, Mac) para descargar el instalador.
3. Ejecuta el instalador descargado y sigue las instrucciones en pantalla. Generalmente, está bien dejar todas las configuraciones como vienen por defecto.

PASO 3: ¡Personalizar VSCode para Python! 【Extensiones】

Una instalación nueva de VSCode es solo un editor de texto plano. Al instalar "extensiones", podemos transformarlo en una herramienta de desarrollo de Python superpotente.

Primero, pongamos VSCode en tu idioma (Opcional)

Si no te sientes cómodo con el inglés, puedes cambiar el idioma primero. (Este artículo asume que estás bien con el inglés, pero para otros idiomas...)

1. Inicia VSCode y haz clic en el icono de la izquierda que parece una pila de cuadrados (la vista de Extensiones).
2. En la barra de búsqueda, escribe el nombre del paquete de idioma que desees, por ejemplo, "Spanish Language Pack".
3. Selecciona el que tiene el icono del globo terráqueo que aparece en la parte superior y haz clic en el botón "Install".
4. Después de la instalación, haz clic en "Change Language and Restart" en la esquina inferior derecha para reiniciar, y los menús estarán en el idioma que hayas elegido.

Extensiones esenciales para el desarrollo en Python

A continuación, instalemos la extensión oficial de Microsoft que facilita drásticamente el desarrollo en Python. En la misma vista de Extensiones, busca "Python".

Selecciona la extensión "Python" de Microsoft, que tiene una marca de verificación azul, e instálala. Esta única extensión te proporciona las siguientes características clave:

• IntelliSense: Un asistente inteligente que autocompleta tu código. Reduce los errores de tipeo y acelera el desarrollo.
• Linting (Pylint): Señala errores gramaticales en tu código y estilos de escritura no recomendados en tiempo real.
• Depuración: La herramienta definitiva para resolver errores, que te permite ejecutar código línea por línea mientras supervisas el estado de las variables.

PASO 4: Entendiendo los "Entornos Virtuales" 【Un Concepto Clave】

¡Muy bien, ya casi es hora de escribir algo de código! Pero antes, permíteme explicar un concepto crucial más que es una práctica estándar en el desarrollo profesional: el "entorno virtual". Entender esto será un gran paso para dejar de ser un principiante.

¿Por qué necesitamos entornos virtuales?

Cuando aprendí sobre esto por primera vez, pensé: "¿Por qué tomarse tantas molestias?". En resumen, es para "aislar las herramientas (bibliotecas) utilizadas en cada proyecto".

Imagina que estás construyendo dos maquetas diferentes.

• Las instrucciones de la Maqueta A dicen: "Usa Pegamento X y Pintura Y".
• Las instrucciones de la Maqueta B dicen: "Usa el nuevo Pegamento Z y la versión antigua de la Pintura Y".

¿Y si solo tienes una mesa de trabajo? El Pegamento X y el Z se mezclarían, o usar la nueva Pintura Y podría hacer que la antigua Pintura Y fuera inutilizable... sería un caos.

La programación es igual. Es común necesitar la "versión 1.0 de la biblioteca X" para el Proyecto A, y la "versión 2.0 de la biblioteca X" para el Proyecto B. Si instalas bibliotecas globalmente en tu PC (como tirar todas tus herramientas en una sola mesa), no puedes manejar estos conflictos de versiones, y tus proyectos se romperán.

Ahí es donde entran los "entornos virtuales". Es como crear una "mesa de trabajo virtual (caja de herramientas)" dedicada para cada proyecto. Al poner solo las bibliotecas necesarias para ese proyecto específico en esta caja, evitas que las herramientas se mezclen con otros proyectos.

Crear y activar un entorno virtual

Suficiente teoría, vamos a crear uno de verdad.

1. Crea una nueva carpeta en algún lugar que te guste, por ejemplo, en tu escritorio. Llamémosla "my-python-project".
2. Inicia VSCode, ve al menú "Archivo", selecciona "Abrir carpeta...", y abre la carpeta "my-python-project" que acabas de crear.
3. En VSCode, ve al menú "Terminal" y selecciona "Nueva terminal" para abrir una terminal en la parte inferior de la pantalla.
4. En la terminal, escribe el siguiente comando y presiona Enter. Esto creará un entorno virtual (una caja de herramientas) llamado ".venv".

python -m venv .venv

A continuación, vamos a "activar" la caja de herramientas que acabamos de hacer para empezar a usarla. Piensa en esto como abrir la tapa de la caja de herramientas. Ten en cuenta que el comando difiere según tu sistema operativo.

【Para Windows (PowerShell)】

.venv\Scripts\activate

【Para Mac / Linux】

source .venv/bin/activate

Si tienes éxito, verás aparecer un prefijo (.venv) al principio de tu línea de terminal. ¡Esta es la señal de que estás dentro del entorno virtual (la tapa de la caja de herramientas está abierta)!

PASO 5: ¡Finalmente, a ejecutarlo! Mostrando "Hello, World!"

¡Gracias por tu paciencia! Todo está listo. Es hora de ejecutar un programa con tus propias manos.

1. En la vista del Explorador de VSCode a la izquierda, haz clic en el icono "Nuevo archivo" junto a tu carpeta "my-python-project".
2. Nombra el archivo "main.py" y presiona Enter.
3. En el archivo main.py que se ha abierto, intenta escribir la siguiente línea tú mismo. (¡Copiar y pegar está bien, pero es una buena práctica escribirlo al principio!)

print("Hello, VSCode World!")

Una vez que hayas escrito el código, haz clic en el botón con forma de play (▶) en la esquina superior derecha de la ventana de VSCode.

Si ves la siguiente salida en tu terminal, ¡tu primer programa se ejecutó con éxito! ¡Felicidades!

Hello, VSCode World!

Este es ese emocionante momento de "¡funcionó!" al aprender a programar. La acumulación de estos pequeños éxitos es la mejor motivación para seguir aprendiendo.

PASO 6: Experimenta el depurador [Haciéndote amigo de los errores]

Es normal que los programas no funcionen como esperas. El arma más poderosa para encontrar la causa de los errores en esos momentos es el "depurador".

¿Qué es la depuración?

La depuración es el proceso de pausar un programa a mitad de ejecución, observar cuidadosamente el contenido de las variables en ese punto y eliminar los errores (bugs). En lugar de cambiar el código al azar, te permite identificar científicamente el área problemática.

Pongamos un punto de interrupción

Primero, pega el siguiente código en main.py.

name = "Copicode"
message = "Welcome to " + name
print(message)

num1 = 10
num2 = 20
total = num1 + num2
print(total)

A continuación, intenta hacer clic a la izquierda de los números de línea en tu código. Aparecerá un punto rojo (●). Esto es un "punto de interrupción", un marcador que le dice al depurador que se detenga aquí durante una ejecución de depuración. Pongamos uno en la línea total = num1 + num2 (línea 6).

¡Ejecuta el depurador!

1. Presiona la tecla F5, o abre la vista "Ejecutar y depurar" a la izquierda (el icono con un bicho y un botón de reproducción) y presiona el botón "Ejecutar y depurar" en la parte superior.
2. Si aparece un cuadro de diálogo pidiéndote que selecciones una configuración de depuración, elige "Python File".

El programa comenzará a ejecutarse pero se detendrá justo antes de la línea con el punto de interrupción (después de que se haya ejecutado la línea 5). En este punto, mira el panel "Variables" en el lado izquierdo de la pantalla.

Puedes ver claramente los valores de variables como name, message, num1 y num2. La variable total de la línea 6, que aún no se ha ejecutado, todavía no está ahí.

Presiona el botón "Saltar (↓)" en la barra de herramientas de depuración que aparece en la parte superior. El programa avanzará una línea, ejecutando la línea 6. Deberías ver entonces total: 30 añadido al panel de Variables.

Usando el depurador de esta manera, puedes entender lo que está sucediendo dentro de tu programa como si lo tuvieras en tus manos. Te permite encontrar la causa de los errores de manera inteligente sin tener que escribir muchas sentencias print.

【Avanzado】Profundiza la sensación de "¡Funcionó!" con bibliotecas

"¡Hola, Mundo!" es un primer paso fantástico, pero el verdadero poder de la programación se desata al usar "bibliotecas" (colecciones de herramientas útiles) creadas por desarrolladores de todo el mundo.

Aquí, usemos la popularísima biblioteca `requests` para comunicarnos con sitios web externos y ejecutar un programa simple que obtiene información meteorológica.

1. Instalar la biblioteca

Asegúrate de que tu entorno virtual esté activado (deberías ver (.venv) al principio de la línea de tu terminal), luego ejecuta el siguiente comando para agregar la biblioteca `requests` a tu "caja de herramientas".

pip install requests

pip es un práctico comando para gestionar las bibliotecas de Python.

2. Código para acceder a una API del tiempo

Borra todo el contenido de main.py y pega el siguiente código. Este código obtiene el pronóstico del tiempo para Tokio desde una API gratuita proporcionada por la Agencia Meteorológica de Japón.

# Primero, una declaración de que usaremos la biblioteca requests
import requests
import json

# Endpoint de la API de la Agencia Meteorológica de Japón (pronóstico del tiempo de Tokio)
url = "https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json"

try:
    # Acceder realmente a la API y obtener la información
    response = requests.get(url)
    
    # Convertir la información recuperada (formato JSON) a un formato que Python pueda manejar
    weather_data = response.json()
    
    # Formatear y mostrar la información
    publishing_office = weather_data[0]["publishingOffice"]
    report_datetime = weather_data[0]["reportDatetime"]
    target_area = weather_data[0]["timeSeries"][0]["areas"][0]["area"]["name"]
    weather_info = weather_data[0]["timeSeries"][0]["areas"][0]["weathers"][0]

    print(f"Oficina de publicación: {publishing_office}")
    print(f"Fecha y hora del informe: {report_datetime}")
    print(f"Área objetivo: {target_area}")
    print(f"Tiempo de hoy: {weather_info}")

except requests.exceptions.RequestException as e:
    print(f"Ocurrió un error de comunicación: {e}")
except json.JSONDecodeError:
    print("No se pudo analizar la información meteorológica.")
except Exception as e:
    print(f"Ocurrió un error inesperado: {e}")

3. ¡Vamos a ejecutarlo!

Ejecútalo como de costumbre con el botón de reproducción en la esquina superior derecha. Si la fecha actual y el pronóstico del tiempo de Tokio se muestran en la terminal, ¡es un gran éxito!

Con solo unas pocas líneas de código, te has comunicado con un servidor externo y has recuperado información significativa. Esta es la diversión y el poder de la programación. ¡No olvides este sentimiento mientras avanzas hacia tu próxima aventura de aprendizaje!

Soy un principiante en programación.
Cuando ejecuté el siguiente código de Python, obtuve el error de abajo.

# --- Pega tu código aquí ---
(Pega el código del pronóstico del tiempo de arriba)
# --- Fin del código ---

# --- Pega el mensaje de error aquí ---
(Pega el error de tu terminal)
# --- Fin del mensaje de error ---

Por favor, explica la causa del error y qué debo hacer para solucionarlo, de una manera que un principiante pueda entender.

Conclusión: Para ti, que has tenido un gran comienzo

¡Has trabajado duro para llegar hasta aquí! Ahora tienes un entorno de desarrollo perfecto para ejecutar programas de Python con VSCode. Pero no solo eso, también has ganado:

• La emoción de ver tu código funcionar
• Un arma para resolver errores (el depurador)
• Un compañero confiable al que recurrir cuando estás atascado (IA)

Este es un activo increíblemente valioso en tu viaje de aprendizaje de la programación.

Atesora el pequeño éxito de "¡funcionó!" que experimentaste hoy y continúa disfrutando de tu aprendizaje. ¡Tu viaje como creador acaba de empezar!

Incluso si no tuviste problemas durante la configuración del entorno, la programación está llena de diversos errores. Como siguiente paso, asegúrate de leer el siguiente artículo que resume los errores comunes y sus soluciones.