Preparar entorno y empezar a desarrollar aplicaciones en Flask con Visual Studio Code

▶

Si estás dando tus primeros pasos en el desarrollo web con Python, seguramente has escuchado hablar de Flask, un microframework ligero, flexible y muy potente. En esta guía te enseñaré cómo instalar Flask en Visual Studio Code (VS Code) y dejarlo listo para crear tu primera aplicación web, sin importar si usas Windows, macOS o Linux.

Llevo tiempo trabajando con distintos frameworks —desde Django hasta CodeIgniter— y te aseguro que Flask es una de las formas más rápidas y limpias de aprender a construir proyectos web con Python.

En este tutorial vamos a aprender a instalar Flask en nuestro equipo, independientemente del sistema operativo en el cual te encuentres; ya que Flask es multiplataforma ya que está soportado en Python; pero antes de esto, vamos a introducir, ¿qué es Flask?.

¿ Qué es Flask y por qué usarlo para desarrollar en Python?

De acuerdo a la documentación oficial que puedes encontrar en el siguiente enlace: es un microframework basado en Jinja2 y Werkzeug; aquí hay varias palabras un poco extrañas que vamos a abordar a continuación.

Flask es un pequeño framework (un micro framework) que proporciona las herramientas y funciones necesarias para crear nuestras aplicaciones, contiene lo mínimo como sería un motor de plantilla y el ruteo y acceso HTTP y todo esto con Python como lenguaje de programación soportado por este framework.

Flask es un microframework para Python diseñado para ser simple y extensible. Está basado en Werkzeug (que gestiona el servidor y las rutas) y Jinja2 (el motor de plantillas que permite generar HTML dinámico).

En palabras simples: Flask te da solo lo esencial para construir una app web, sin imponerte una estructura rígida. Tú decides qué módulos o extensiones añadir.

Flask frente a otros frameworks

Cuando empecé a trabajar con Flask, lo comparé inmediatamente con Django, y la diferencia fue clara: Django lo trae todo (ORM, autenticación, administración, etc.), mientras que Flask te da libertad total.
Para entenderlo con una analogía que siempre uso:

“Flask en Python es lo que CodeIgniter fue para PHP, mientras que Django se parece más a Laravel.”

Esa flexibilidad es lo que lo hace ideal para proyectos pequeños o medianos donde quieres aprender, experimentar o construir APIs ligeras.

¿Qué es un microframework?

Un microframework simplemente significa que el framework solamente contiene lo básico para poder funcionar; si también desarrollar en CodeIgniter del cual tenemos muchisima informacion en nuestro blog, sabrás que CodeIgniter es un framework pequeño con muchas funcionalidades pero carece de unas tantas.

Flask en su definición básica es más simple que CodeIgniter, no dispone de librerías o módulos para emails, control de usuario etc; solamente tenemos el ruteo de las funciones y la definición de los templates, y por supuesto, acceso a toda la API de Python, al estar el framework escrito en este lenguaje de programación.

Flask es extensible: El microframework con el que crear grandes proyectos

Lo comentado en el párrafo anterior no significa que flask solamente sirva para desarrollos básicos, por el contrario es extensible mediante módulos que los podemos instalar mediante la herramienta de gestión de paquetes o módulos de python, y tenemos módulos de todo tipos tal cual detallamos y explicamos los más importantes en el curso más completo sobre Flask en español:

Al conocer Flask, te darás cuenta que nada tiene que envidiar a otros frameworks como Django, es un framework completo con el que desarrollar todo tipo de aplicaciones, sencillas y no tan sencillas.

Esa flexibilidad es lo que lo hace ideal para proyectos pequeños o medianos donde quieres aprender, experimentar o construir APIs ligeras.

Ventajas de usar Flask

• ✅ Ligero y fácil de aprender.
• Altamente extensible mediante módulos.
• Multiplataforma (Windows, Mac, Linux).
• Perfecto para proyectos rápidos, prototipos o aplicaciones medianas.

Jinja2 y Werkzeug

Jinja2 es el motor de plantillas que emplea Flask y el Werkzeug es la librería que contiene distintas utilizadas o funciones para el HTTP, como la definición de ruteos, redirecciones, etc: también es nuestro WSGI que es la interfaz de Python que nos permite comunicarnos mediante HTTP

¿Por qué Python Flask?

Seguramente cuando escuchas programación web con Python, te viene a la cabeza Django que es un excelente framework web para Python que ya contiene todo lo necesario para hacer nuestras apps, pero Flask al ser la mínima expresión de un framework o microframework tenemos más control sobre los distintos elementos de nuestro framework, instalar justamente lo necesario y además es más fácil de aprender que Django. Esto no quiere decir que Flask sea mejor que Django o viceversa, son simplemente dos versiones diferentes para un mismo objetivo que es el desarrollo de apps webs con Python; en mi opinión Flask nos funciona excelente en proyectos de pequeña o mediana envergadura mientras que podríamos emplear Django para proyectos más grandes.

"Flask Python viene siendo el CodeIgniter de php y Django viene siendo el Laravel de php"

Para cerrar esta sección, te muestro una pequeña y mínima app en Flask:

@app.route('/') def hello_world():    return 'Hola mundo Flask' 

Y esto es todo lo que necesitamos para hacer un hola mundo en Flask (por supuesto una vez instalado el framework); un archivo con la definición anterior, en donde tenemos el ruteo gracias a nuestro Werkzeug, la función que viene siendo la acción o función de nuestro controlador y la respuesta que es simplemente un texto y por lo tanto en este momento no estamos empleando el motor de plantillas de Jinja2; ahora, en django necesitamos muchisimo mas que esto para empezar a trabajar y de aquí lo comentado anteriormente

¿Por qué aprender Python y Flask para desarrollar nuestras aplicaciones?

Python es un lenguaje excepcional, lo emplean empresas tan importantes como Microsoft que cuentan con cursos gratis sobre como comenzar en este lenguaje de programación, es rápido, multiplataforma y fácil de aprender en comparación con otros como el antigua Java.

Y lo mejor de todo

Es que si sabes Python puedes crear, desde apps de escritorio, juegos, Inteligencia Artificial (IA) procedimientos de probabilidades y por supuesto, crear apps webs como mencionamos anteriormente; inclusive, Python es el lenguaje de programación seleccionado para crear el famoso Blender.

Por lo tanto, es un lenguaje excepcional, en constante crecimiento y que mejor que emplearlo en la programación web, que es la creación de sistemas que están en constante demanda y crecimiento, de tal manera, que con esto puedes tener múltiples ventajas como crecimiento profesional, ya que en resumidas cuentas, Flask es el mejor framework web que puedes seleccionar si estas aprendiendo a programar y/o creando tus primeras apps webs en general o basadas en Python.

⚙️ Requisitos previos para instalar Flask

Antes de empezar, asegúrate de tener estos elementos instalados:

Verificar instalación de Python

Abre tu terminal o consola (PowerShell, CMD, o terminal de macOS/Linux) y ejecuta:

python --version

Si obtienes una versión 3.x, ya puedes continuar. Si no, descarga e instala Python desde python.org

Instalar Visual Studio Code y extensiones recomendadas

Yo uso Visual Studio Code porque es ligero, multiplataforma y tiene extensiones específicas para Python.
Instálalo desde code.visualstudio.com

Luego, dentro de VS Code:

Abre la pestaña de extensiones (Ctrl+Shift+X).

Instala Python (de Microsoft).

Opcionalmente, añade Pylance y Code Runner para autocompletado y ejecución rápida.

Preparar el entorno virtual

Crear un entorno virtual te permite aislar dependencias:

$ python -m venv venv

Tenemos un articulo especifico con el cual, podrás aprender a crear el ambiente virtual en Flask.

Extra: Crear en Ambiente Virtual con VSC

Con VS Code, es posible crear el ambiente virtual, para ello, debes de tener instalada la extensión de Python para VSC.

Creamos una carpeta vacía. En mi caso usaré:

proy/
└─ hello

Arrastro esa carpeta a VS Code antes de crear el entorno para evitar errores.

Presionamos Ctrl + Shift + P (o Command + Shift + P en Mac) en VSC y buscamos:

Create Environment

Selecciono Python como intérprete, y se empezará a crear el ambiente virtual automáticamente dentro de .venv.

Instalar Flask paso a paso

Finalmente vamos a llegar al punto que nos interesa, instalar Flask, que como Python es multiplataforma recuerda que con tan solo tener Python en sus últimas versiones es suficiente para seguir esta guía y con esto hacerte con tu Flask; para instalar Flask lo podemos hacer mediante pip: pip install flask

Con tu entorno virtual activo, instala Flask con pip:

$ pip install flask

Para verificar que la instalación fue exitosa:

$ pip show flask

Veras la versión que tienes instalado de Flask; y con esto puedes seguir con el siguiente tutorial:

Extra: seleccionando el editor

Ahora, para el editor puedes emplear cualquiera con que te sientas a gusto para trabajar con Python pero yo en lo personal te recomiendo Visual Studio Code, que es multiplataforma y puedes desarrollar todo tipo de proyectos basados en otros framework en un mismo editor.

Configurar Flask en Visual Studio Code

Abrir el proyecto y seleccionar el entorno virtual

1. Abre la carpeta del proyecto en VS Code.
2. En la esquina inferior derecha, selecciona el intérprete de Python correspondiente a tu entorno virtual (venv).
3. Verifica que los comandos de Flask se ejecuten desde la terminal integrada.

Ejecutar y depurar tu app desde VS Code

Presiona F5 o ve a Ejecutar > Iniciar depuración.
VS Code detectará automáticamente tu app Flask y abrirá el servidor.

❓ Preguntas frecuentes sobre Flask y Visual Studio Code

¿Qué versión de Python necesito?
Cualquier versión 3.7 o superior funciona perfectamente.

¿Puedo usar Flask en macOS o Linux?
Sí. Solo cambia el comando de activación del entorno virtual.

¿Cómo sé si Flask está bien instalado?
Ejecuta pip show flask o lanza el Hola Mundo. Si se abre el servidor en localhost, todo está correcto.

¿Qué hago si VS Code no detecta mi entorno virtual?
Reinicia la ventana de VS Code y selecciona el intérprete Python manualmente desde la barra inferior.

Conclusión

Instalar Flask en Visual Studio Code es sencillo si sigues los pasos correctos:

1. Instala Python.
2. Configura tu entorno virtual.
3. Instala Flask con pip.
4. Usa VS Code para ejecutar y depurar tu app.

Y recuerda: Flask no es solo para principiantes. Es una herramienta potente, flexible y lista para escalar tus ideas, justo como cuando yo lo descubrí y comencé a crear mis primeras APIs en cuestión de minutos.

Lo siguiente que debes de aprender hacer es, un Hola Mundo en Flask.