Comment configurer Flask dans Visual Studio Code avec un exemple d’API

Ce tutoriel s’adresse à ceux qui ont essayé d’exécuter Flask dans VS Code, mais qui se sont heurtés à des obstacles, que ce soit à cause d’erreurs d’importation, de difficultés de démarrage du serveur ou simplement d’un sentiment de dépassement de la configuration. Flask est léger et flexible, ce qui est un atout, mais cela rend la prise en main un peu difficile si vous n’êtes pas familier avec les frameworks Python. En résumé, il s’agit de faire en sorte que Flask soit reconnu et fonctionne correctement sur votre machine, afin que vous puissiez commencer à créer des API ou des applications web sans souci.

Comment réparer un Flask non reconnu ou ne pouvant pas s’exécuter dans VS Code

Méthode 1 : Installer correctement Flask avec pip

C’est le problème habituel : si Flask n’est pas installé dans votre environnement Python actuel, VS Code pique une crise. Parfois, c’est simplement parce que vous avez installé Python mais pas Flask, ou parce que VS Code n’utilise pas le bon interpréteur Python. Installer Flask via pip résout généralement ce problème. Lorsque Flask n’est pas reconnu, vous verrez souvent un soulignement rouge dans votre code ou des erreurs telles que « ModuleNotFoundError ».

Ouvrez le terminal dans VS Code via Terminal > Nouveau terminal. Assurez-vous d’être dans le bon répertoire ou ouvrez-le simplement dans le dossier de votre projet. Pour installer Flask, exécutez :

pip install flask

Si cette commande ne fonctionne pas en raison d’une commande introuvable ou d’un problème similaire, vous devrez peut-être confirmer la version Python à laquelle votre pip est lié. Parfois, vous devrez exécuter la python -m pip install flaskcommande ou spécifier explicitement la version Python, python3 -m pip install flaskselon votre système.

Une fois installé, rechargez votre fenêtre VS Code ou redémarrez l’éditeur. Sur certaines configurations, les modules Flask ne sont toujours pas reconnus juste après l’installation. Soyez attentif à cela.

Méthode 2 : S’assurer que VS Code utilise le bon interpréteur Python

Il s’agit d’un problème récurrent : Flask est installé globalement ou dans un environnement, mais VS Code utilise un interpréteur Python différent. Vérifiez le coin inférieur gauche de VS Code ; il affiche généralement la version ou l’environnement Python sélectionné. S’il ne s’agit pas de celui où vous avez installé Flask, cliquez dessus et sélectionnez le bon interpréteur (par exemple, un environnement virtuel ou celui où Flask est installé).

Vous pouvez également accéder à la palette de commandes ( Ctrl + Maj + P ), saisir « Python : Sélectionner un interpréteur » et choisir le bon interpréteur dans la liste. C’est assez embêtant, car VS Code utilise souvent par défaut le Python système, sur lequel Flask n’est peut-être pas installé. Confirmez en exécutant :

python -m pip show flask

Si les détails s’affichent, tout va bien. Sinon, vous devez changer d’interpréteur ou réinstaller Flask dans cet environnement.

Méthode 3 : Utilisation d’environnements virtuels pour une configuration plus propre

Bien sûr, Windows rend la tâche plus complexe que nécessaire. Pour gérer les dépendances et éviter de perturber votre installation Python globale, il est judicieux de configurer un environnement virtuel. Dans le dossier de votre projet, exécutez :

python -m venv venv

Ensuite, activez-le — sous Windows, c’est :

.\venv\Scripts\activate

(Sur Mac/Linux, c’est source venv/bin/activate.) Une fois activé, exécutez :

pip install flask

De cette façon, Flask est installé uniquement dans cet environnement et VS Code devrait le détecter automatiquement si vous avez sélectionné le bon interpréteur.

Méthode 4 : exécutez correctement votre application Flask

Après l’installation, assurez-vous que votre application Flask fonctionne correctement. Il arrive que les utilisateurs exécutent une commande incorrecte ou oublient de définir des variables d’environnement. Votre application test.pydevrait ressembler à ceci :

from flask import Flask app = Flask(__name__) @app.route('/') def hello_world(): return 'Hello, World!'

Ou, si vous utilisez l’approche de la variable d’environnement, définissez FLASK_APP avant l’exécution :

set FLASK_APP=test.py (on Windows) export FLASK_APP=test.py (on Mac/Linux)

Et puis, exécutez :

flask run

Si votre commande Flask n’est pas reconnue, c’est probablement parce que pip n’installe pas les outils CLI dans votre environnement, ou que vous n’êtes pas dans le bon environnement. Vérifiez en exécutant pip show flasket assurez-vous que le répertoire bin de votre environnement se trouve dans le chemin d’accès de votre système. Sur certaines configurations, vous devrez peut-être invoquer explicitement python -m flask run.

Conseils supplémentaires et éléments courants à vérifier

Assurez-vous que votre terminal utilise le même interpréteur que VS Code : les environnements incompatibles provoquent des maux de tête sans fin.
Redémarrez VS Code après l’installation des packages : c’est parfois le seul moyen pour que VS Code voie les nouveaux modules.
Vérifiez le chemin Python dans Paramètres > Python > Interpréteur. Il est fréquent que VS Code pointe vers la mauvaise version de Python.
Si Flask n’est toujours pas détecté, essayez d’exécuter pip listou pip freezede confirmer que Flask est installé.

Conclure

Faire fonctionner Flask dans VS Code peut s’avérer complexe si l’environnement n’est pas correctement configuré, mais une fois le problème résolu, c’est assez simple. Les principaux problèmes sont généralement des problèmes d’installation ou un mauvais choix d’interpréteur. Une fois ces problèmes résolus, vos applications Flask devraient fonctionner de manière fiable. Franchement, une fois que tout fonctionne, tout se déroule sans problème.

Résumé

Assurez-vous que Flask est installé dans l’environnement actif ( pip install flaskou python -m pip install flask)
Définir l’interpréteur Python correct dans VS Code ( Python : sélectionner l’interpréteur )
Activer les environnements virtuels pour une gestion plus propre des dépendances
Exécutez Flask avec flask runoupython test.py
Redémarrez VS Code si nécessaire après les modifications