Aller au contenu principal

Activer l'environnement virtuel dans Cursor

Les environnements virtuels Python fournissent un environnement de développement isolé pour chaque projet. Ce guide vous montrera comment configurer et activer un environnement virtuel dans Cursor IDE.

Qu'est-ce qu'un environnement virtuel ?​

Un environnement virtuel est un environnement isolé pour les projets Python qui permet :

  • La gestion des dépendances par projet
  • L'isolation des versions Python
  • Le maintien d'un environnement de développement propre

Configuration de l'environnement virtuel dans Cursor​

1. Créer un nouvel environnement virtuel​

Exécutez la commande suivante dans le terminal :

# Accéder au répertoire du projet
cd votre-repertoire-projet

# Créer l'environnement virtuel
python -m venv venv

2. Activer l'environnement virtuel​

Utilisez différentes commandes selon votre système d'exploitation :

# Windows
.\venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

Une fois activé, vous verrez (venv) dans l'invite du terminal.

Utilisation de l'environnement virtuel dans Cursor​

1. Utiliser le terminal intégré​

Vous pouvez activer l'environnement virtuel dans le terminal intégré de Cursor :

  1. Appuyez sur `Ctrl + `` (backtick) pour ouvrir le terminal
  2. Exécutez la commande d'activation ci-dessus

2. Sélectionner l'interpréteur Python​

  1. Appuyez sur Ctrl + Shift + P pour ouvrir la palette de commandes
  2. Tapez "Python: Select Interpreter"
  3. Sélectionnez l'interpréteur Python de votre environnement virtuel

Gestion des paquets​

1. Installation des paquets​

Dans l'environnement virtuel activé :

# Mettre à jour pip
pip install --upgrade pip

# Installer un paquet
pip install nom-du-paquet

# Installer depuis requirements.txt
pip install -r requirements.txt

2. Gestion des dépendances​

# Exporter les dépendances actuelles
pip freeze > requirements.txt

# Désactiver l'environnement virtuel
deactivate

Meilleures pratiques​

  1. Environnement virtuel par projet

    • Utiliser un environnement virtuel distinct pour chaque projet
    • Ajouter le dossier de l'environnement virtuel à .gitignore

  2. Documentation des dépendances

    • Maintenir un fichier requirements.txt
    • Utiliser le verrouillage des versions : paquet==version

  3. Nommage des environnements virtuels

    • Utiliser des noms clairs (ex: venv, env, .venv)
    • Placer selon la structure du projet

Dépannage​

1. Échec d'activation de l'environnement virtuel​

# Vérifier la politique d'exécution sur Windows
Get-ExecutionPolicy
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. Problèmes d'installation des paquets​

# Nettoyer le cache pip
pip cache purge

# Recréer l'environnement virtuel
rm -rf venv
python -m venv venv

3. Problèmes de chemin Python​

# Vérifier le chemin Python
which python  # macOS/Linux
where python  # Windows

Configuration avancée​

1. Activation automatique de l'environnement virtuel​

Configurer l'activation automatique dans les paramètres de Cursor :

  1. Ouvrir settings.json
  2. Ajouter la configuration de l'environnement virtuel Python

2. Versions multiples de Python​

# Créer un environnement virtuel avec une version spécifique
python3.8 -m venv venv-py38
python3.9 -m venv venv-py39

Conclusion​

L'utilisation d'environnements virtuels dans Cursor permet un développement Python plus efficace et isolé. En suivant les étapes de ce guide, vous pouvez gérer efficacement les dépendances de votre projet et maintenir un environnement de développement propre.

Ressources supplémentaires :

Dernière mise à jour : Février 2025 - Ce guide couvre Cursor version 0.43 et Python 3.x.