Instalación de Flask

Antes de comenzar a escribir aplicaciones Flask, necesitamos preparar el entorno Python e instalar Flask.

La instalación de Flask es bastante sencilla.

Flask es una biblioteca de Python, por lo que primero debes asegurarte de que Python esté instalado en tu computadora.


Requisitos de versión de Python

Requisitos de Flask 3.xPython 3.9 o superior。

Si aún no has instalado Python, puedespython.orgdescargarlo e instalarlo.

Una vez completada la instalación, abre la terminal y verifica:

$ python3 --version
Python 3.12.3

$ pip3 --version
pip 24.0 from /usr/lib/python3.12/site-packages/pip (python 3.12)

macOS y la mayoría de las distribuciones de Linux ya incluyen Python 3. Si usas Windows, durante la instalación marca laAdd Python to PATHopción.


Entorno virtual

El entorno virtual (Virtual Environment) es una práctica estándar en los proyectos de Python; crea un espacio de paquetes de Python independiente para cada proyecto.

¿Por qué usar un entorno virtual?

Supongamos que tienes dos proyectos: el proyecto A necesita Flask 3.0 y el proyecto B necesita Flask 2.3.

Si se instalan globalmente, las dos versiones de Flask entrarán en conflicto entre sí.

El entorno virtual permite que cada proyecto tenga sus propias dependencias independientes, sin interferirse entre sí.

El módulo que viene con Pythonvenvpuede crear entornos virtuales sin necesidad de instalar herramientas adicionales.

Crear un entorno virtual

Primero crea el directorio del proyecto y luego crea el entorno virtual dentro de él:

$ mkdir ejemplo-flask-test
$ cd ejemplo-flask-test
$ python3 -m venv .venv

.venves el nombre del directorio del entorno virtual; puedes cambiarlo por el que prefieras, pero.venves la convención más común en la comunidad.

Activar el entorno virtual

Sistema operativo Comando de activación
macOS / Linux . .venv/bin/activateosource .venv/bin/activate
Windows (CMD) .venv\Scripts\activate
Windows (PowerShell) .venv\Scripts\Activate.ps1

Después de una activación exitosa, aparecerá antes del prompt de la terminal(.venv)el indicador, lo que significa que el entorno virtual está activo.

$ . .venv/bin/activate
(.venv) $   # <-- 提示符变了,说明虚拟环境已经激活

Salir del entorno virtual

Al terminar el desarrollo, usa eldeactivatecomando para salir:

(.venv) $ deactivate
$

Cada vez que abras una nueva ventana de terminal, debes reactivar el entorno virtual para poder usar Flask.

También puedes usar uv, la herramienta de gestión de paquetes y entornos de Python; consulta:https://www.example.com/python3/uv-tutorial.html

# 使用指定 Python 版本创建虚拟环境
uv venv --python 3.12
激活虚拟环境:

# macOS / Linux
source .venv/bin/activate

# Windows(PowerShell)
.venv\Scripts\activate

Instalar Flask

Con el entorno virtual activado, instala Flask usando pip:

(.venv) $ pip install Flask

Una vez instalado, verifica si Flask se instaló correctamente:

flask --version

La salida será similar a la siguiente información:

Python 3.9.6
Flask 3.0.0
Werkzeug 3.1.5

También puedes verificar con el siguiente código:

from importlib.metadata import version

flask_version = version("flask")
print(flask_version)

Si la instalación es exitosa, se mostrará un número de versión similar al siguiente:

3.1.3

En este momento, también se instalaron los siguientes paquetes de dependencia:Werkzeug、Jinja2、Click、itsdangerous、blinker。

Opcional: instalar python-dotenv

python-dotenvTe permite, mediante un.envy.flaskenvarchivo, gestionar las variables de entorno y simplificar el uso de los comandos de Flask:

(.venv) $ pip install python-dotenv

Aunque no es obligatorio, se recomienda encarecidamente en el desarrollo real. Te ahorra tener que ingresar cada vez el--appparámetro, y también facilita compartir la configuración del entorno entre el equipo.


Estructura del directorio del proyecto

Antes de comenzar a codificar, es útil conocer la estructura de directorios estándar de un proyecto Flask:

myflaskapp/
├── .venv/          # 虚拟环境(不要提交到 Git)
├── app.py           # 应用入口文件
├── templates/       # Jinja2 模板文件目录
├── static/          # CSS、JS、图片等静态文件目录
├── .flaskenv        # Flask 环境变量(可选)
└── .gitignore       # 忽略 .venv 等不需要提交的文件

Directorio del entorno virtual.venvno debe enviarse a Git. En.gitignoreagrega.venv/simplemente.


Entorno de desarrollo

Entorno de desarrollo recomendado:

En China, Alibaba y ByteDance también tienen IDE de IA basados en VS Code:

Plataforma en línea de generación y desarrollo de aplicaciones de IA:

Otras extensiones