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: