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 packageObjectif
uvicorn[standard]Serveur ASGI, utilisé pour exécuter les applications FastAPI
python-multipartPrise en charge des données de formulaire et du téléversement de fichiers
jinja2Moteur de modèles HTML
python-jose[cryptography]Prise en charge des jetons JWT
passlib[bcrypt]Hachage et chiffrement des mots de passe
python-dotenvGestion 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

from fastapi import FastAPI

# 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ètreDescription
main:appmainFait référence au nom du fichier main.py,appDésigne le nom de la variable d'instance FastAPI créée dans le fichier
--reloadMode 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 :

AdresseType de documentDescription
http://127.0.0.1:8000/docsSwagger UIUne interface de documentation pour tester l'API de manière interactive
http://127.0.0.1:8000/redocReDocUne 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

OutilsDescription
VS CodeGratuit et léger, offrant une excellente expérience de développement FastAPI avec les extensions Python et Pylance
PyCharmUn IDE Python professionnel avec modèles de projet FastAPI intégrés et des fonctionnalités de débogage puissantes
Alibaba QoderUn IDE de programmation IA lancé par Alibaba, profondément personnalisé à partir de VS Code
ByteDance TraeUn 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