Instalación de FastAPI y configuración del entorno

FastAPI requiere Python 3.8 o superior. Esta sección explica cómo instalar FastAPI y configurar el entorno de desarrollo.


Verificar la versión de Python

Antes de instalar FastAPI, primero verifica tu versión de Python:

$ python --version
Python 3.11.0

# 或者
$ python3 --version
Python 3.11.0

Si tu versión de Python es inferior a 3.8, actualiza Python primero.


Crear un entorno virtual

Se recomienda instalar FastAPI en un entorno virtual para evitar conflictos con los paquetes de Python del sistema:

# 创建虚拟环境
$ python -m venv venv

# 激活虚拟环境(macOS/Linux)
$ source venv/bin/activate

# 激活虚拟环境(Windows)
$ venv\Scripts\activate

Los entornos virtuales son una buena práctica en el desarrollo de Python. Usar un entorno virtual independiente para cada proyecto evita conflictos de dependencias entre distintos proyectos.


Instalar FastAPI

Instala FastAPI con pip:

$ pip install fastapi

Este comando solo instala el paquete principal de FastAPI. Si necesitas instalar FastAPI y todas sus dependencias opcionales de una sola vez, puedes usar:

$ pip install "fastapi[all]"

fastapi[all]Se instalarán los siguientes componentes:

Nombre del paqueteUso
uvicorn[standard]Servidor ASGI, utilizado para ejecutar aplicaciones FastAPI
python-multipartSoporte para datos de formularios y carga de archivos
jinja2Motor de plantillas HTML
python-jose[cryptography]Soporte de tokens JWT
passlib[bcrypt]Hash de contraseñas y cifrado
python-dotenvGestión de variables de entorno

Instalar Uvicorn

FastAPI es un framework ASGI que requiere un servidor ASGI para ejecutarse. El más utilizado es Uvicorn:

$ pip install "uvicorn[standard]"

[standard]Instalará uvloop (bucle de eventos de alto rendimiento) y httptools (analizador HTTP de alto rendimiento), lo que mejora significativamente el rendimiento.

ASGI (Asynchronous Server Gateway Interface) es la interfaz estándar entre los servidores web asíncronos de Python y las aplicaciones, y es la versión asíncrona de WSGI. Los frameworks tradicionales como Flask usan WSGI (síncrono), mientras que FastAPI usa ASGI (asíncrono), lo que permite manejar solicitudes concurrentes de manera más eficiente.


Ejecutar la primera aplicación FastAPI

Después de la instalación, crea un archivo llamadomain.py:

Ejemplo

from fastapi import FastAPI

# Crear una instancia de la aplicación FastAPI
app = FastAPI()

# Definir la ruta GET de la raíz
@app.get("/")
async def root():
    return {"message": "Hello World"}

Inicia la aplicación en la línea de comandos:

$ uvicorn main:app --reload

Descripción de parámetros:

ParámetroDescripción
main:appmainSe refiere al nombre del archivo main.py,appSe refiere al nombre de la variable de instancia de FastAPI creada en el archivo
--reloadModo de desarrollo, recarga automáticamente el servidor cuando el código cambia (solo para el entorno de desarrollo)

Después de un inicio exitoso, la terminal mostrará:

INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process
INFO:     Started server process
INFO:     Waiting for application startup.
INFO:     Application startup complete.

Abre el navegador y visitahttp://127.0.0.1:8000, verás la siguiente respuesta JSON:

{"message": "Hello World"}

Al mismo tiempo, FastAPI genera automáticamente documentación interactiva de API:

DirecciónTipo de documentoDescripción
http://127.0.0.1:8000/docsSwagger UIInterfaz de documentación para probar la API de forma interactiva
http://127.0.0.1:8000/redocReDocInterfaz de documentación más enfocada en la experiencia de lectura

Usar FastAPI CLI

Las versiones nuevas de FastAPI proporcionanfastapiherramienta de línea de comandos, que permite ejecutar aplicaciones de manera más conveniente:

# 开发模式(自动重载)
$ fastapi dev

# 生产模式
$ fastapi run

fastapi devBuscará automáticamente la aplicación FastAPI en el proyecto y iniciará el servidor de desarrollo, equivalente auvicorn main:app --reload。


Herramientas de desarrollo recomendadas

HerramientaDescripción
VS CodeGratuito y ligero, con los complementos de Python y Pylance ofrece una excelente experiencia de desarrollo de FastAPI
PyCharmIDE profesional de Python, con plantillas de proyectos FastAPI integradas y potentes funciones de depuración
Alibaba QoderIDE de programación con IA lanzado por Alibaba, profundamente personalizado basado en VS Code
ByteDance TraeHerramienta de desarrollo impulsada por IA lanzada por ByteDance, con soporte integrado de Python
Se recomienda usar VS Code + el complemento de Python, que ofrece el mejor soporte para anotaciones de tipos y autocompletado de FastAPI, y es completamente gratuito.
Otras extensiones