Sous-sections de Installation
Installer Thonny + Pgzero
Installation rapide
Télécharge le script pour ton système d’exploitation. Un double-clic et il installe Python, uv, Thonny, pgzero, pygame-ce et tout le code de départ pour toi. Prêt en 5 à 10 minutes.
Ton système d'exploitation est en cours de détection...
⬇️ Télécharger pour macOS / Linux
Fichier : install_linux_mac.sh — ouvre un terminal dans le dossier de téléchargement et exécute :
chmod +x install_linux_mac.sh && ./install_linux_mac.sh
Afficher tous les téléchargements
Astuce
Le script est sûr : il installe seulement les mêmes programmes que les étapes manuelles ci-dessous. Tu peux consulter le code source en ouvrant le fichier dans le Bloc-notes ou dans un éditeur de texte.
Installation manuelle
Thonny est un éditeur Python gratuit, spécialement conçu pour les débutants. Il installe Python automatiquement. Après l’installation, vérifie quelle version de Python tu as : ton jeu fonctionne avec Python 3.13, 3.14 ou 3.15.
Installer Thonny
Va sur thonny.org et télécharge la version pour ton système d’exploitation.
Windows
Télécharge le fichier .exe et double-clique dessus. Suis les étapes d’installation (clique simplement sur “Next”). Ensuite, tu retrouves Thonny dans le menu Démarrer.
macOS
Télécharge le fichier .pkg et ouvre-le. Glisse Thonny dans ton dossier Applications. La première fois que tu l’ouvres, clique avec le bouton droit et choisis “Open” (pour que macOS lui fasse confiance).
Linux
Ouvre un terminal et tape :
bash <(wget -qO - https://thonny.org/installer-for-linux)
Ou utilise ton gestionnaire de paquets si Thonny y est disponible (par ex. sudo apt install thonny sur Ubuntu).
Remarque
Utilise la version de thonny.org, pas celle de l’app store. Elle est parfois obsolète.
Vérifier la version de Python
Pygame-ce et pgzero ont des versions prêtes à l’emploi pour Python 3.13, 3.14 et 3.15. Les versions plus récentes (3.16 ou plus) ne fonctionnent pas encore.
- Ouvre Thonny.
- Regarde en bas à droite de la fenêtre. La version active de Python y est affichée, par ex.
Python 3.14.8. - Tu vois 3.13, 3.14 ou 3.15 ? Alors tout va bien. Tu vois autre chose ? Installe alors Python 3.14 avec les étapes ci-dessous.
Astuce
Tu vois Python 3.13, 3.14 ou 3.15 ? Saute le reste de cette partie et passe à Installer Pygame-ce.
Installer Python 3.14 et faire pointer Thonny dessus
- Va sur python.org/downloads et clique sur “All releases”. Cherche Python 3.14 dans la liste et télécharge l’installeur pour ton système d’exploitation.
- Windows : choisis le Windows installer (64-bit) et laisse la case “Add Python to PATH” cochée.
- macOS : choisis le macOS 64-bit universal2 installer.
- Linux : utilise ton gestionnaire de paquets, par ex.
sudo apt install python3.14.
- Déroule l’installation et termine-la.
- Ouvre Thonny et clique en bas à droite sur le nom de la version de Python (ou va dans Tools → Options → Interpreter).
- Choisis “Interpréteur Python 3 alternatif ou environnement virtuel”.
- Clique sur l’icône de dossier et navigue jusqu’à l’exécutable Python 3.14 :
- Windows :
C:\Users\<tonnom>\AppData\Local\Programs\Python\Python314\python.exe - macOS :
/Library/Frameworks/Python.framework/Versions/3.14/bin/python3 - Linux :
/usr/bin/python3.14
- Clique sur OK et redémarre Thonny.
En bas à droite, tu vois maintenant Python 3.14. Passe à l’installation de Pygame-ce.
Installer Pygame-ce
Pgzero a besoin de Pygame pour fonctionner. On utilise pygame-ce, la version communautaire maintenue qui fonctionne aussi sur Python 3.14 et 3.15. Dans ton code, ça reste simplement import pygame.
- Ouvre Thonny.
- Clique en haut sur Tools → Manage packages…
- Tape dans le champ de recherche :
pygame-ce - Clique sur le résultat de recherche et ensuite sur Install.
- Attends la fin de l’installation (tu vois “Done” en bas).
Installer Pgzero
Pgzero est la bibliothèque avec laquelle tu crées des petits jeux. Voici comment l’installer :
- Retourne dans Tools → Manage packages…
- Tape dans le champ de recherche :
pgzero - Clique sur le résultat de recherche et ensuite sur Install.
Vérifie ensuite que la version est 1.2 ou plus. Tu vois la version à droite du nom dans la liste des paquets.
Remarque
L’installation de pgzero bloque sur Python 3.14 ou 3.15 ? C’est parce que pgzero entraîne automatiquement l’ancien pygame, qui n’a pas de version prête à l’emploi pour ces versions. Utilise alors le script d’installation en un clic en haut de cette page, ou choisis Python 3.13 dans Thonny.
Tester si tout fonctionne
Crée un nouveau fichier dans Thonny et colle ce code dedans :
# test_setup.py
import pgzrun
WIDTH = 400
HEIGHT = 300
def draw():
screen.fill((30, 30, 60))
screen.draw.text("Pgzero fonctionne !", center=(200, 150), color="white")
pgzrun.go()
Enregistre-le sous test_setup.py et clique sur le bouton vert Run dans Thonny.
Si tout va bien, une fenêtre s’ouvre avec un fond bleu foncé et le texte “Pgzero fonctionne !”. Ferme la fenêtre en cliquant sur la croix.
Ça ne marche pas ?
Pas de panique ! Va voir la page de résolution de problèmes pour les erreurs les plus courantes et comment les résoudre.
VS Code (parcours avancé)
Tu as déjà fait quelques sessions de Python et tu veux plus de contrôle sur ton code ? Alors VS Code est un bon pas suivant. C’est l’éditeur que les vrais programmeurs utilisent aussi.
Quand changer ?
Seulement quand Thonny te paraît trop limité, par exemple si tu veux gérer plusieurs fichiers à la fois, utiliser Git, ou si tu es juste curieux de voir comment les développeurs professionnels travaillent.
Changer n’est pas obligatoire. Thonny reste parfait pour les débutants et les sessions courtes.
Astuce : essaie VS Code quand tu as déjà suivi au moins 3 sessions et que tu es à l’aise avec les bases de Python.
Installer VS Code
Télécharge VS Code via code.visualstudio.com. Choisis l’installeur pour ton système d’exploitation (Windows, macOS ou Linux) et suis les étapes d’installation.
Installer l’extension Python
VS Code fonctionne avec des extensions. Pour Python, tu as besoin de l’extension officielle de Microsoft :
- Ouvre VS Code.
- Clique sur l’onglet Extensions dans la barre latérale (ou appuie sur
Ctrl+Shift+X). - Cherche
ms-python.python. - Clique sur Install.
Après l’installation, VS Code reconnaît automatiquement les fichiers Python et tu obtiens l’autocomplétion, les messages d’erreur et plus encore.
Installer uv
uv est un gestionnaire de paquets Python rapide, bien plus simple à utiliser que le pip standard. Installe-le via astral.sh/uv.
Windows (PowerShell) :
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
macOS / Linux :
curl -LsSf https://astral.sh/uv/install.sh | sh
Redémarre ton terminal après l’installation pour que la commande uv soit disponible.
Installer le projet
Ouvre un terminal dans VS Code (`Ctrl+`` ou via Terminal → New Terminal) et exécute ces commandes dans ton dossier de projet :
# Utilise Python 3.13, 3.14 ou 3.15
uv init --python 3.14
uv add pgzero pygame-ce pygbag
Remarque
Utilise Python 3.13, 3.14 ou 3.15. On installe pygame-ce au lieu de pygame : c’est la version communautaire qui fonctionne aussi sur les Python les plus récents. Pgzero demande cependant encore l’ancien pygame.
Mets donc cette ligne dans ton pyproject.toml, pour que uv ignore cet ancien pygame :
[tool.uv]
exclude-dependencies = ["pygame"]
Ensuite, tu dois dire à VS Code quelle version de Python le projet utilise :
- Appuie sur
Ctrl+Shift+P et tape Python: Select Interpreter. - Choisis l’interpréteur qui se trouve dans ton dossier
.venv (il ressemble à .venv/bin/python ou .venv\Scripts\python.exe).
VS Code utilise maintenant le bon environnement avec tous les packages que tu viens d’installer.
Lancer Pgzero
Ouvre un terminal dans VS Code et utilise :
Ou crée un launch.json dans le dossier .vscode/ pour pouvoir démarrer avec F5 :
{
"version": "0.2.0",
"configurations": [
{
"name": "Pgzero: run current file",
"type": "debugpy",
"request": "launch",
"module": "pgzero",
"args": ["${file}"],
"console": "integratedTerminal"
},
{
"name": "Pygame: run current file",
"type": "debugpy",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
Crée le dossier .vscode/ dans ton dossier de projet s’il n’existe pas encore, et enregistre le fichier sous launch.json. Tu vois ensuite les configurations dans le panneau Run and Debug (Ctrl+Shift+D).
Lancer Pygame
Pour les projets Pygame normaux (sans pgzrun), tu utilises :
Ou choisis dans le panneau Run and Debug la configuration “Pygame: run current file” si tu as créé le launch.json.
PyCharm (parcours avancé)
PyCharm est un IDE complet de JetBrains. Tu n’en as pas besoin pour te lancer avec Pgzero ou Pygame, mais si tu veux continuer à progresser comme programmeur, c’est un pas utile. Pense à un débogueur intégré, à la complétion de code intelligente et à de puissants outils de refactoring.
Quand changer ?
Continue simplement à travailler avec Thonny tant que ça te va bien. N’envisage PyCharm que si tu veux :
- inspecter des variables pendant que ton code est en pause (débogueur),
- renommer rapidement des fonctions ou des variables dans tout ton projet (refactoring), ou
- une autocomplétion qui connaît aussi les types de tes variables.
Pour les débutants et la plupart des sessions de la dojo, Thonny est largement suffisant.
Télécharge l’édition Community gratuite sur jetbrains.com/pycharm. Choisis Community, pas Professional. Professional est payant et tu n’en as pas besoin.
- Va sur la page de téléchargement et clique sur Community-Free.
- Lance le programme d’installation et garde tous les réglages par défaut.
- Démarre PyCharm. Tu ne dois pas créer de compte JetBrains.
Quand tu démarres PyCharm pour la première fois, tu choisis New Project.
PyCharm 2024.1 ou plus récent avec uv :
Si tu as déjà uv sur ton système (voir le guide Thonny), PyCharm le reconnaît automatiquement. Choisis dans Python version l’option 3.13, 3.14 ou 3.15 et laisse PyCharm créer un environnement uv.
Version plus ancienne ou sans uv avec venv :
- Choisis comme Interpreter type l’option Virtualenv.
- Sélectionne dans Base interpreter l’installation de Python sur ton système (le plus souvent
python3 ou python3.x). - Laisse la case Create a main.py welcome script cochée ou décoche-la. Ça n’a pas d’importance.
Clique ensuite sur Create. PyCharm crée l’environnement et ouvre le projet.
Installer des paquets
Tu installes pgzero, pygame-ce et pygbag via les réglages :
- Ouvre File → Settings (sur macOS : PyCharm → Preferences).
- Va dans Project: <nom> → Python Interpreter.
- Clique en bas à droite sur l’icône +.
- Cherche
pgzero dans le champ de recherche et clique sur Install Package. Fais de même pour pygame-ce et pygbag. - Ferme la fenêtre quand les trois sont terminés.
Vérifie que tout a réussi : à droite dans la liste, tu vois maintenant pgzero, pygame-ce et pygbag avec leurs numéros de version.
Remarque
Le bouton Install Package pour pgzero ne fonctionne pas sur Python 3.14 ou 3.15 ? C’est parce que pgzero entraîne l’ancien pygame. Utilise alors le terminal intégré avec uv add pgzero pygame-ce et mets [tool.uv] exclude-dependencies = ["pygame"] dans ton pyproject.toml. Voir aussi Installer Thonny + Pgzero.
Configuration d’exécution pour Pgzero
Pgzero fonctionne autrement qu’un script Python normal : tu le démarres comme un module et tu passes le nom de ton fichier comme argument.
- Clique en haut sur Add Configuration… (ou ouvre Run → Edit Configurations…).
- Clique sur l’icône + et choisis Python.
- Remplis :
- Name :
Pgzero - Run : mets le choix sur Module name (pas Script path)
- Module name :
pgzero - Parameters :
main.py - Working directory : le dossier de ton projet (s’il est encore vide, clique sur l’icône de dossier et choisis ton dossier de projet)
- Clique sur OK.
Sélectionne ensuite la configuration Pgzero dans le menu déroulant en haut et appuie sur le bouton vert de lecture pour lancer ton jeu.
Configuration d’exécution pour Pygame
Pygame, tu le démarres bien comme un script normal :
- Ouvre à nouveau Run → Edit Configurations… et clique sur + → Python.
- Remplis :
- Name :
Pygame - Run : laisse le choix sur Script path
- Script path : navigue jusqu’à
main.py dans ton dossier de projet - Working directory : ton dossier de projet
- Clique sur OK.
Choisis la configuration Pygame dans le menu déroulant et appuie sur le bouton de lecture.
Voilà. Tu as maintenant deux configurations d’exécution prêtes à l’emploi : une pour les jeux Pgzero et une pour les jeux Pygame. Change simplement de configuration dans le menu déroulant en haut selon ce que tu es en train de construire.
Astuces utiles
- Utiliser le débogueur : place un point d’arrêt en cliquant à gauche d’un numéro de ligne (point rouge). Démarre ensuite ta configuration avec le bouton bug au lieu du bouton de lecture. PyCharm met en pause à cette ligne pour que tu puisses regarder tes variables.
- Import automatique : si PyCharm souligne en rouge un nom que tu viens d’écrire, appuie sur Alt+Enter pour ajouter automatiquement la bonne instruction
import en haut. - Terminal : en bas, tu peux ouvrir un terminal intégré (View → Tool Windows → Terminal). Pratique pour
uv add ou pour exécuter pygbag et publier.
Environnements virtuels (venv)
Imagine : tu pars en camp et tu dois préparer ton sac à dos. Pour un camp de sport, tu y mets d’autres choses que pour un camp de musique. Si tu mélanges tout, tu ne retrouves plus rien.
C’est pareil avec les projets Python. Chaque projet a besoin de son propre « sac à dos » : un environnement virtuel avec exactement ce qu’il faut dedans.
Qu’est-ce qu’un environnement virtuel ?
Un environnement virtuel (en abrégé venv, prononce : « ven-vee ») est un dossier séparé sur ton ordinateur qui contient Python et tous les paquets supplémentaires d’un seul projet.
Suppose que tu as deux projets :
- Projet A utilise Pygame version 2.5
- Projet B utilise Pygame version 2.6
Sans environnements virtuels, tu ne pourrais installer qu’une seule version de Pygame sur ton ordinateur. L’un des projets ne fonctionnerait alors plus. Avec des environnements virtuels, chaque projet a sa propre boîte fermée avec la bonne version dedans. Ils ne se gênent pas.
Métaphore : un environnement virtuel, c’est comme un sac à dos personnel par projet. Tu y mets exactement ce dont ce projet a besoin, et les sacs à dos sont rangés séparément dans l’armoire.
Pourquoi les utiliser ?
- Pas de conflit entre projets. Les versions 2.5 et 2.6 peuvent exister toutes les deux, chacune dans son propre environnement.
- Partager est facile. Si tu partages ton projet avec un ami (ou une amie), tu ne dois pas envoyer tous les paquets. Ton ami (ou amie) crée simplement son propre environnement virtuel et installe les mêmes paquets.
- Ton ordinateur reste rangé. Tu n’installes rien « comme ça » sur tout ton ordinateur. Tout reste bien dans le sac à dos du bon projet.
uv est le gestionnaire de paquets Python qu’on utilise à la CoderDojo. Il peut créer et gérer des environnements virtuels.
Étape 1 : ouvrir un terminal
- Windows : appuie sur
⊞ Windows, tape cmd et ouvre “Invite de commandes” (ou utilise PowerShell). - macOS / Linux : ouvre “Terminal”.
Étape 2 : aller dans le dossier de ton projet
cd chemin/vers/ton/dossier-de-projet
Astuce
Remplace chemin/vers/ton/dossier-de-projet par le vrai chemin, par exemple cd Bureau/mon-jeu.
Étape 3 : créer l’environnement virtuel
uv crée maintenant un petit dossier .venv dans ton dossier de projet. Il contient une installation Python séparée.
Tu veux utiliser une version précise de Python ? C’est possible aussi :
Pourquoi faire ça ? Pour être sûr d’utiliser une version de Python qui fonctionne avec nos bibliothèques de jeux. Choisis 3.13, 3.14 ou 3.15.
Étape 4 : activer l’environnement virtuel
L’environnement existe, mais tu dois encore l’“allumer”. C’est ce qu’on appelle activer.
Windows (Invite de commandes ou PowerShell) :
macOS / Linux :
source .venv/bin/activate
Après l’activation, tu vois (.venv) apparaître à gauche dans ton terminal. C’est le signe que tu travailles maintenant dans ton environnement virtuel.
(.venv) seppe@computer:~/project$
Étape 5 : installer des paquets
Maintenant que ton environnement est actif, tu peux installer des paquets. Ils arrivent uniquement dans ce seul sac à dos :
Remarque
pygame-ce est la version communautaire de Pygame et fonctionne aussi sur Python 3.14 et 3.15. Pgzero demande cependant encore l’ancien pygame.
Mets donc aussi cette ligne dans ton pyproject.toml :
[tool.uv]
exclude-dependencies = ["pygame"]
Étape 6 : désactiver
Tu as fini de programmer ? Tape simplement :
Le signe (.venv) disparaît et tu retravailles avec le Python normal de ton ordinateur.
À quoi faire attention ?
⚠️ N’oublie pas d’activer l’environnement
L’erreur la plus fréquente : tu ouvres un nouveau terminal et tu oublies d’activer l’environnement virtuel. Python se plaint alors de ne pas trouver les paquets, alors que tu les as bien installés.
Solution : active toujours d’abord avec .venv\Scripts\activate (Windows) ou source .venv/bin/activate (macOS/Linux) avant de lancer ton programme.
⚠️ Mets .venv dans .gitignore
Le dossier .venv est gros (parfois des centaines de Mo). Tu ne dois pas le partager via Git ou GitHub. Mets .venv dans ton fichier .gitignore, pour que Git l’ignore :
Ton ami (ou amie) crée simplement son propre .venv avec uv venv et installe les mêmes paquets via le fichier pyproject.toml qui, lui, est bien dans Git.
⚠️ Utilise uv run comme raccourci
Pas envie d’activer et de désactiver à chaque fois ? uv a un raccourci pratique :
Il exécute python main.py à l’intérieur de l’environnement virtuel, même s’il n’est pas activé. uv comprend tout seul quel environnement va avec le projet.
⚠️ Terminaux différents, environnements différents
Si tu actives l’environnement dans un terminal, il n’est pas actif automatiquement dans un autre terminal. Tu dois activer séparément chaque terminal où tu veux utiliser l’environnement.
En résumé
| Action | Commande (Windows) | Commande (macOS/Linux) |
|---|
| Créer | uv venv | uv venv |
| Activer | .venv\Scripts\activate | source .venv/bin/activate |
| Désactiver | deactivate | deactivate |
| Raccourci | uv run python main.py | uv run python main.py |
La règle d’or : tu vois (.venv) dans ton terminal ? Alors tout va bien. Tu ne le vois pas ? Active d’abord, programme ensuite.
Quelle est la différence avec virtualenv et pip ? Avant uv, il existait déjà d’autres outils comme virtualenv (pour les environnements) et pip (pour les paquets). Avec eux, tu pouvais faire la même chose, mais tu devais utiliser deux commandes séparées et ça marchait beaucoup plus lentement. uv fait tout en une fois, est bien plus rapide, et est bien plus simple pour les débutants. À la CoderDojo, on préfère donc uv.
Tu as des problèmes avec ton environnement virtuel ? Va voir Résolution de problèmes pour les erreurs fréquentes.
Résolution de problèmes
Ton code ne fonctionne pas et tu ne sais pas pourquoi ? Pas de panique : presque chaque problème a une solution simple. Parcours la liste ci-dessous et regarde si ton message d’erreur y figure.
Pgzero ou pygame ne peut pas être installé
Tu vois une erreur comme No matching distribution found ou Package not found quand tu installes pgzero ou pygame.
Cause : tu utilises une version de Python pour laquelle la bibliothèque n’a pas encore de version prête à l’emploi. Ça arrive avec Python 3.16 ou plus, et avec l’ancien pygame sur Python 3.14 et 3.15. Utilise Python 3.13, 3.14 ou 3.15 et la version communautaire pygame-ce au lieu de pygame.
Ubuntu 26.04 a Python 3.14 par défaut. Le script d’installation en un clic règle ça automatiquement :
- Un Python 3.13, 3.14 ou 3.15 existant est utilisé ; s’il n’y en a pas, Python 3.14 est installé (via le PPA deadsnakes,
ppa:deadsnakes/ppa, si apt n’a pas cette version) - Thonny est détecté via PATH, snap, pip ou flatpak
- Si Thonny est installé en snap, la configuration est écrite dans le bon dossier (
~/snap/thonny/current/.config/Thonny/) - Si
apt install thonny ne marche pas, le script essaie pip install --user thonny
Solution : utilise Python 3.13, 3.14 ou 3.15 comme interpréteur actif :
- Thonny : voir Installer Thonny + Pgzero → Vérifier la version de Python.
- VS Code : recrée ton environnement avec
uv venv --python 3.14. - PyCharm : crée un nouvel interpréteur et sélectionne Python 3.14 dans Base interpreter.
pgzrun: command not found
Ça veut dire que Pgzero n’est pas installé, ou que tu utilises une mauvaise version de Python.
Solution : ouvre Thonny, va dans Tools → Manage Packages, cherche pgzero et clique sur Install. Redémarre Thonny ensuite et réessaie.
ModuleNotFoundError: No module named 'pygame'
Python ne trouve pas la bibliothèque pygame. C’est presque toujours parce que Thonny utilise le mauvais interpréteur Python.
Solution : regarde en bas à droite dans la barre d’état de Thonny quel interpréteur est actif. Choisis le même interpréteur que celui utilisé pendant l’installation. Réinstalle ensuite pygame-ce via Tools → Manage Packages.
La fenêtre s’ouvre et se ferme tout de suite
La fenêtre du programme apparaît une seconde puis disparaît.
- Pgzero : il te faut
WIDTH et HEIGHT comme variables séparées en haut de ton fichier, en dehors de toute fonction. Sans ces variables, Pgzero ne sait pas quelle taille la fenêtre doit avoir et s’arrête tout de suite. - Pygame : il te faut une boucle d’événements qui appelle
pygame.event.get() à chaque frame. Sans cet appel, la fenêtre se fige et le système d’exploitation la ferme.
Les sons ne font rien
Tu appelles sounds.jump.play() mais on n’entend rien.
Vérifie ceci :
- Y a-t-il un dossier
sounds/ à côté de ton main.py ? Le dossier doit être exactement au même endroit. - Les noms de fichiers sont-ils en minuscules et utilises-tu des underscores au lieu d’espaces ? Par exemple
jump.wav, pas Jump.wav ni jump sound.wav. - Pgzero n’accepte que des fichiers
.wav dans le dossier sounds/. Pgzero les charge automatiquement, donc tu n’as rien à importer toi-même.
Le son ne marche pas dans pygame (session 5 et plus)
Tu utilises pygame.mixer.Sound(...) mais on n’entend rien, sans message d’erreur ; le jeu démarre simplement sans son.
Cause : Python cherche le fichier audio relativement au dossier depuis lequel tu démarres le script, pas au dossier où se trouve main.py. Si tu ouvres VS Code depuis la racine du projet et que ton script est dans un sous-dossier, Python cherche sounds/hit.wav dans la racine du projet et ne le trouve pas. Le try/except du starter attrape cette erreur en silence.
Solution : utilise __file__ pour rendre le chemin absolu :
import os
_DIR = os.path.dirname(os.path.abspath(__file__))
snd_hit = pygame.mixer.Sound(os.path.join(_DIR, 'sounds/hit.wav'))
__file__ est toujours le chemin vers main.py lui-même, peu importe d’où tu démarres le script. Les fichiers de départ à partir de la session 5 le font déjà. Ajoute les deux lignes juste au-dessus du chargement des sons si ton propre jeu ne le fait pas encore.
Les images ne s’affichent pas
Ton actor ou ton arrière-plan n’est pas visible.
Vérifie ceci :
- Y a-t-il un dossier
images/ à côté de ton main.py ? - Tous les noms de fichiers sont-ils en minuscules ?
player.png fonctionne ; Player.png non. - Utilise de préférence des fichiers
.png, car ce sont eux qui marchent le plus sûrement avec Pgzero.
KeyError avec une image
Tu obtiens un KeyError quand tu crées un Actor ou charges une image.
Cause : le nom que tu passes doit correspondre exactement au nom du fichier, sans extension. Actor('basket') cherche images/basket.png. Une faute de frappe ou une majuscule en trop suffit à provoquer l’erreur.
Solution : vérifie le nom du fichier dans le dossier images/ et assure-toi qu’il correspond exactement à ce que tu as écrit dans le code.
Chromebook ou pas de droits d’installation
Tu ne peux pas installer Thonny ou Pgzero parce que tu n’as pas les droits d’administrateur sur l’ordinateur.
Solution : travaille avec quelqu’un qui a déjà Thonny, parce que le pair-programming est de toute façon une bonne idée ! À la maison, tu peux continuer avec la version pygbag : elle fait tourner ton projet Pygame directement dans le navigateur, sans installation.
L’antivirus bloque l’installation
Ta tentative d’installation est interrompue ou bloquée par un antivirus.
Solution : désactive temporairement l’antivirus pendant l’installation, ou demande à un coach de mettre une version portable de Thonny sur une clé USB. Cette version n’a pas besoin d’installation et fonctionne directement depuis la clé.
Toujours bloqué ?
Pas de problème. Demande simplement à un coach pendant la session, ou poste ta question dans le chat CoderDojo. Donne le message d’erreur exact (copie et colle le texte de Thonny), on pourra t’aider plus vite.