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 paquete | Uso |
|---|---|
uvicorn[standard] | Servidor ASGI, utilizado para ejecutar aplicaciones FastAPI |
python-multipart | Soporte para datos de formularios y carga de archivos |
jinja2 | Motor de plantillas HTML |
python-jose[cryptography] | Soporte de tokens JWT |
passlib[bcrypt] | Hash de contraseñas y cifrado |
python-dotenv | Gestió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
# 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ámetro | Descripción |
|---|---|
main:app | mainSe refiere al nombre del archivo main.py,appSe refiere al nombre de la variable de instancia de FastAPI creada en el archivo |
--reload | Modo 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ón | Tipo de documento | Descripción |
|---|---|---|
| http://127.0.0.1:8000/docs | Swagger UI | Interfaz de documentación para probar la API de forma interactiva |
| http://127.0.0.1:8000/redoc | ReDoc | Interfaz 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
| Herramienta | Descripción |
|---|---|
| VS Code | Gratuito y ligero, con los complementos de Python y Pylance ofrece una excelente experiencia de desarrollo de FastAPI |
| PyCharm | IDE profesional de Python, con plantillas de proyectos FastAPI integradas y potentes funciones de depuración |
| Alibaba Qoder | IDE de programación con IA lanzado por Alibaba, profundamente personalizado basado en VS Code |
| ByteDance Trae | Herramienta 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