Django Python Tutoriel Débutant Web Development

Comment créer un projet Django from scratch : guide complet (Windows, Linux, macOS)

Django est l'un des frameworks web Python les plus populaires au monde. Que vous souhaitiez créer une application web, une API REST ou un site e-commerce, Django vous offre tout l'outillage nécessaire dès l'installation. Dans ce tutoriel complet, nous allons voir étape par étape comment démarrer un projet Django sur Windows, Linux et macOS — de l'installation de Python à l'exécution de votre premier serveur local.

1. Prérequis : vérifier Python et pip

Django est un framework Python. Avant toute chose, vous devez disposer de Python 3.10 ou supérieur et de son gestionnaire de paquets pip. Sélectionnez votre système d'exploitation ci-dessous.

🪟 Windows

🐧 Linux

🍎 macOS

Installer Python sur Windows

Rendez-vous sur python.org/downloads et téléchargez la dernière version stable (3.12 recommandée). Lors de l'installation, cochez impérativement l'option "Add Python to PATH".

Vérifiez ensuite l'installation dans l'invite de commandes (cmd) :

python --version
pip --version

⚠ Si la commande n'est pas reconnue, relancez le terminal ou ajoutez manuellement Python à votre variable d'environnement PATH.

Installer Python sur Linux

Sur la plupart des distributions Linux (Ubuntu, Debian), Python 3 est préinstallé. Mettez à jour vos paquets puis vérifiez la version :

sudo apt update && sudo apt upgrade -y
python3 --version
pip3 --version

Si pip n'est pas disponible, installez-le :

sudo apt install python3-pip -y

Installer Python sur macOS

macOS inclut Python 2 par défaut. Nous recommandons d'utiliser Homebrew pour gérer Python 3 proprement :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install python

python3 --version
pip3 --version

2. Créer un environnement virtuel (venv)

L'environnement virtuel est une bonne pratique indispensable en Python. Il permet d'isoler les dépendances de chaque projet et d'éviter les conflits de versions entre vos différents projets Django.

🪟 Windows

🐧 Linux

🍎 macOS

Créer et activer le venv sur Windows

Ouvrez un terminal dans le dossier de votre choix :

python -m venv env

Activez l'environnement virtuel :

env\Scripts\activate

Votre invite de commande affichera (env) en préfixe une fois activé.

Créer et activer le venv sur Linux

python3 -m venv env
source env/bin/activate

Pour désactiver l'environnement à tout moment : deactivate

Créer et activer le venv sur macOS

python3 -m venv env
source env/bin/activate

Le nom env est conventionnel. Vous pouvez l'appeler autrement, mais pensez à ajouter ce dossier à votre .gitignore.

3. Installer Django via pip

Une fois l'environnement virtuel activé, installez Django avec pip. La commande est identique sur les trois systèmes :

pip install django

Vérifiez la version installée :

django-admin --version

💡 Bonne pratique : sauvegardez toujours vos dépendances dans un fichier requirements.txt avec la commande pip freeze > requirements.txt. Cela facilite le déploiement et le travail en équipe.

4. Initialiser votre projet Django

Django fournit un outil en ligne de commande django-admin pour générer automatiquement la structure d'un projet. Remplacez monprojet par le nom de votre application :

django-admin startproject monprojet .

⚠ Le point . à la fin est important : il indique à Django de créer le projet dans le répertoire courant, évitant ainsi un dossier imbriqué redondant.

5. Comprendre la structure générée

Après l'initialisation, voici l'arborescence de fichiers générée par Django :

monprojet/
  ├── monprojet/
  │   ├── __init__.py
  │   ├── settings.py   ← configuration globale
  │   ├── urls.py      ← routage des URLs
  │   ├── asgi.py
  │   └── wsgi.py
  └── manage.py     ← point d'entrée CLI

Voici le rôle de chaque fichier clé :

settings.py — Centralise toute la configuration : base de données, applications installées, clé secrète, langues, fichiers statiques…

urls.py — Fichier de routage principal. Il associe les URLs aux vues correspondantes.

manage.py — Outil de gestion en ligne de commande propre à votre projet. C'est lui que vous utiliserez pour lancer le serveur, créer des migrations, créer un superuser, etc.

6. Lancer le serveur de développement

Django embarque un serveur de développement léger. Pour le démarrer :

python manage.py migrate
python manage.py runserver

La commande migrate applique les migrations initiales (création des tables système de Django). Ensuite, ouvrez votre navigateur à l'adresse :

http://127.0.0.1:8000/

Vous devriez voir la page d'accueil Django avec la fusée 🚀. Votre projet est opérationnel !

💡 Par défaut, le serveur écoute sur le port 8000. Vous pouvez le changer avec python manage.py runserver 8080. Ce serveur est exclusivement destiné au développement local — ne l'utilisez jamais en production.

7. Créer votre première application Django

Dans Django, un projet est composé de plusieurs applications (apps). Chaque app est un module indépendant qui gère une fonctionnalité précise (blog, authentification, boutique…). Créez votre première app :

python manage.py startapp blog

Ensuite, déclarez cette app dans votre fichier settings.py en l'ajoutant à la liste INSTALLED_APPS :

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',   # ← votre nouvelle application
]

Votre app blog contient désormais les fichiers suivants :

blog/
  ├── models.py     ← modèles de données (BDD)
  ├── views.py      ← logique et rendu
  ├── urls.py       ← URLs spécifiques à l'app
  ├── admin.py      ← déclaration interface admin
  └── apps.py

Conclusion et prochaines étapes

Félicitations ! Vous avez initialisé votre premier projet Django, créé un environnement virtuel isolé, lancé un serveur de développement et généré votre première application. Vous avez maintenant une base solide pour aller plus loin.

Dans les prochains articles, nous verrons comment créer des modèles de données, configurer l'interface d'administration Django, et construire vos premières vues et templates. Restez connectés !

Mots-clés : créer projet Django, tutoriel Django débutant, installer Django Python, django-admin startproject, environnement virtuel Python, framework Django 2024