Installation de FastAPI et configuration de l'environnement
FastAPI nécessite Python 3.8 ou une version ultérieure. Cette section explique comment installer FastAPI et configurer l'environnement de développement.
Vérifier la version de Python
Avant d'installer FastAPI, vérifiez votre version de Python :
$ python --version Python 3.11.0 # 或者 $ python3 --version Python 3.11.0
Si votre version de Python est inférieure à 3.8, mettez d'abord Python à niveau.
Créer un environnement virtuel
Il est recommandé d'installer FastAPI dans un environnement virtuel afin d'éviter les conflits avec les paquets Python du système :
# 创建虚拟环境 $ python -m venv venv # 激活虚拟环境(macOS/Linux) $ source venv/bin/activate # 激活虚拟环境(Windows) $ venv\Scripts\activate
Les environnements virtuels sont une bonne pratique en développement Python. Utiliser un environnement virtuel distinct pour chaque projet évite les conflits de dépendances entre projets.
Installer FastAPI
Installez FastAPI avec pip :
$ pip install fastapi
Cette commande installe uniquement le paquet principal de FastAPI. Si vous devez installer FastAPI et toutes ses dépendances optionnelles en une seule fois, vous pouvez utiliser :
$ pip install "fastapi[all]"
fastapi[all]Les composants suivants seront installés :
| Nom du package | Objectif |
|---|---|
uvicorn[standard] | Serveur ASGI, utilisé pour exécuter les applications FastAPI |
python-multipart | Prise en charge des données de formulaire et du téléversement de fichiers |
jinja2 | Moteur de modèles HTML |
python-jose[cryptography] | Prise en charge des jetons JWT |
passlib[bcrypt] | Hachage et chiffrement des mots de passe |
python-dotenv | Gestion des variables d'environnement |
Installer Uvicorn
FastAPI est un framework ASGI qui nécessite un serveur ASGI pour fonctionner. Le plus couramment utilisé est Uvicorn :
$ pip install "uvicorn[standard]"
[standard]Cela installera uvloop (une boucle d'événements haute performance) et httptools (un analyseur HTTP haute performance), améliorant considérablement les performances.
ASGI (Asynchronous Server Gateway Interface) est l'interface standard entre les serveurs Web asynchrones Python et les applications, et est la version asynchrone de WSGI. Les frameworks traditionnels tels que Flask utilisent WSGI (synchrone), tandis que FastAPI utilise ASGI (asynchrone), permettant une gestion plus efficace des requêtes concurrentes.
Exécutez votre première application FastAPI
Après l'installation, créez un fichier nommémain.pyFichier :
Exemple
# Créer une instance d'application FastAPI
app = FastAPI()
# Définir la route GET pour le chemin racine
@app.get("/")
async def root():
return {"message": "Hello World"}
Démarrez l'application en ligne de commande :
$ uvicorn main:app --reload
Description du paramètre :
| Paramètre | Description |
|---|---|
main:app | mainFait référence au nom du fichier main.py,appDésigne le nom de la variable d'instance FastAPI créée dans le fichier |
--reload | Mode développement : recharge automatiquement le serveur après les modifications du code (pour l'environnement de développement uniquement) |
Après un démarrage réussi, le terminal affichera :
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.
Ouvrez le navigateur pour accéder àhttp://127.0.0.1:8000, vous verrez la réponse JSON suivante :
{"message": "Hello World"}

Pendant ce temps, FastAPI génère automatiquement une documentation API interactive :
| Adresse | Type de document | Description |
|---|---|---|
| http://127.0.0.1:8000/docs | Swagger UI | Une interface de documentation pour tester l'API de manière interactive |
| http://127.0.0.1:8000/redoc | ReDoc | Une interface de documentation davantage axée sur l'expérience de lecture |
Utilisation de FastAPI CLI
La nouvelle version de FastAPI fournitfastapiun outil en ligne de commande qui rend le lancement des applications plus pratique :
# 开发模式(自动重载) $ fastapi dev # 生产模式 $ fastapi run
fastapi devIl trouvera automatiquement les applications FastAPI dans le projet et démarrera le serveur de développement, ce qui équivaut àuvicorn main:app --reload。
Outils de développement recommandés
| Outils | Description |
|---|---|
| VS Code | Gratuit et léger, offrant une excellente expérience de développement FastAPI avec les extensions Python et Pylance |
| PyCharm | Un IDE Python professionnel avec modèles de projet FastAPI intégrés et des fonctionnalités de débogage puissantes |
| Alibaba Qoder | Un IDE de programmation IA lancé par Alibaba, profondément personnalisé à partir de VS Code |
| ByteDance Trae | Un outil de développement piloté par l'IA lancé par ByteDance, avec prise en charge Python intégrée |
Il est recommandé d'utiliser VS Code + l'extension Python, qui offre le meilleur support pour les annotations de type FastAPI et l'autocomplétion, et qui est entièrement gratuit.autres extensions