Plan du cours
Mettre en place son environnement de développement
Opération courante sous environnement python
Pour conclure
Une des plus grandes confusions quand on débute en Python est de mélanger son propre code avec les fichiers du système. Découvrons ensemble comment structurer proprement vos dossiers et séparer votre travail.
01
La racine du projet — votre espace de travail
C'est votre dossier principal (par exemple C:\dev\MonProjet). C'est ici que vous vivez en tant que développeur. Voici ce qu'on y trouve :
STRUCTURE DU PROJET
main.py
Votre code — le point d'entrée de votre application. C'est là que vous écrivez, là que vous passez votre temps.
requirements.txt
La liste exacte de toutes les bibliothèques dont votre projet a besoin. Permet à un collègue de recréer votre environnement identique en une commande (pip install -r requirements.txt).
.gitignore
Indique à Git ce qu'il ne doit jamais envoyer en ligne — notamment le dossier .venv/ qui peut peser plusieurs centaines de Mo.
build/ & dist/
Créés automatiquement par PyInstaller si vous compilez votre code en .exe. build/ est le brouillon de travail, dist/ contient le logiciel final prêt à distribuer.
02
Le dossier .venv — le moteur qu'on n'ouvre pas
Ce dossier est au même niveau que les autres, mais vous ne devez jamais coder dedans. C'est l'environnement virtuel que Python gère entièrement pour vous. Voici ce qu'il contient :
| Dossier / Fichier | À quoi ça sert ? |
|---|---|
Scripts/ | Contient les "moteurs" : le clone de python.exe, l'outil pip.exe pour installer des paquets, et le script d'activation Activate.ps1. |
Lib/ | La bibliothèque. Quand vous tapez pip install pandas, c'est dans ce dossier précis que les milliers de fichiers de Pandas se téléchargent. C'est lui qui rend ce dossier très lourd. |
Include/ | Souvent vide pour les débutants. Sert à stocker des fichiers en langage C si une bibliothèque complexe doit être compilée nativement. |
pyvenv.cfg | Le fichier de configuration. Indique la version de Python utilisée et fait le lien entre cet environnement et le Python principal de votre ordinateur. |
.gitignoreAutomatique | Ajouté automatiquement par Python — ordonne à Git de ne jamais envoyer le contenu de ce lourd dossier sur internet. Un filet de sécurité offert d'office. |
La Règle d'Or — on allume le .venv, et ensuite on n'y touche plus !
L'erreur la plus courante est de vouloir enregistrer ses propres fichiers (main.py…) à l'intérieur du dossier .venv. Ne faites jamais ça !
Le dossier .venv
= le moteur de la voiture. Il tourne en arrière-plan une fois activé. On ne s'assoit pas dedans.
La racine du projet
= l'habitacle. C'est là que vous êtes assis, que vous codez et que vous conduisez votre application.
Bonne pratique
Dans VS Code, ouvrez toujours le dossier racine du projet (Fichier → Ouvrir le dossier…), pas un fichier individuel. VS Code détectera automatiquement votre .venv et vous proposera de l'utiliser comme interpréteur Python.
À retenir
- La racine du projet = votre espace de travail (code, données, config)
- Le dossier .venv = le moteur géré par Python — on l'active, on n'y touche plus
Lib/contient vos bibliothèques installées ·Scripts/contient python.exe et pip- Le
.gitignoredans.venv/empêche Git d'envoyer des centaines de Mo inutiles en ligne
Cours mis à jour en mars 2026.