Le terminal, les dossiers et votre premier projet

Le problème que nous résolvons

Dans le chapitre précédent, vous avez installé Python et exécuté un fichier. Mais quelque chose s'est passé discrètement au milieu — lorsque vous avez exécuté le fichier, le terminal était déjà ouvert dans ce dossier précis. VS Code s'en est chargé pour vous.

Ce ne sera pas toujours le cas. Quand le terminal se trouve dans un dossier différent, vous devez vous rendre vous-même dans le dossier du fichier. Ce « déplacement » piège plus de débutants que tout le reste. Le code est correct, Python est correct, mais le terminal se trouve dans un autre dossier — et Python indique alors que le fichier n'existe pas.

Au travail, vous ferez cela quelques centaines de fois par jour. Aujourd'hui, nous allons donc transformer le terminal, ce sombre écran qui vous est étranger, en un outil que vous maîtrisez.

À la fin de ce chapitre, vous pourrez

• Dire dans quel dossier se trouve actuellement le terminal
• Passer d'un dossier à un autre et remonter d'un niveau
• Créer un dossier de projet et y exécuter un fichier
• Ouvrir et fermer l'interpréteur interactif de Python (le REPL)
• Expliquer la différence entre le REPL et un fichier .py — cette confusion seule fait perdre beaucoup de temps

Prérequis : Installer Python et exécuter votre premier programme.

Ce qu'est réellement le terminal

Le terminal est un endroit où vous donnez des ordres à l'ordinateur en tapant plutôt qu'en cliquant. Et chaque fenêtre de terminal se trouve toujours « debout » dans un dossier. Ce dossier s'appelle le répertoire courant.

Voilà l'idée principale. Lorsque vous tapez python hello.py, vous dites en réalité : « Exécute le fichier `hello.py` dans le dossier où je me trouve actuellement. » Si le fichier se trouve dans un autre dossier, Python ne le trouvera pas — car il ne regarde nulle part ailleurs.

Les commandes de ce chapitre sont presque identiques sous Windows PowerShell, le Terminal de macOS et le Terminal de Linux. Lorsqu'elles diffèrent, les deux versions sont indiquées.

Ouvrez PowerShell sous Windows et vous verrez généralement quelque chose comme :

PS C:\Users\Rafi>

Sous macOS, quelque chose comme :

rafi@MacBook ~ %

Sous Linux, quelque chose comme :

rafi@laptop:~$

Cette ligne s'appelle l'invite — le terminal attend votre commande. Sous Windows, la partie C:\Users\Rafi vous indique où vous vous trouvez. Sous macOS et Linux, le signe ~ signifie votre dossier personnel.

Quatre commandes pour faire le travail

pwd — où suis-je ?

pwd

Sous Windows PowerShell, la réponse ressemble à ceci :

Path
----
C:\Users\Rafi

Sous macOS ou Linux, vous obtenez juste le chemin :

/home/rafi

(Sous macOS, le chemin est /Users/rafi.)

ls — que contient ce dossier ?

ls

Cette commande liste les dossiers et les fichiers. ls fonctionne sur les trois systèmes ; sous Windows, il existe aussi une commande plus ancienne pour faire la même chose : dir. Exécuter ls avant d'exécuter un fichier est une bonne habitude — cela vous permet de vérifier que le fichier que vous allez exécuter se trouve bien là.

cd — aller dans un autre dossier

cd python-lab

Deux points permettent de remonter d'un niveau :

cd ..

Et pour revenir directement à votre dossier personnel depuis n'importe où :

cd ~

Ces trois commandes fonctionnent de la même manière sous Windows, macOS et Linux.

Tapez moins. Écrivez les deux ou trois premières lettres du nom d'un dossier ou d'un fichier, puis appuyez sur Tab — le terminal complète le reste automatiquement. Taper les noms à la main est la plus grande source de fautes de frappe, et Tab l'élimine.

mkdir — créer un nouveau dossier

mkdir lesson-02

Créer un dossier de projet

Si vous dispersez vos fichiers sur le Bureau pendant votre apprentissage, vous ne retrouverez plus rien dans une semaine. Choisissez donc un seul endroit et donnez à chaque chapitre son propre dossier. Dans le chapitre précédent, vous avez créé python-lab dans votre dossier personnel ; créons maintenant le dossier de ce chapitre à l'intérieur :

cd ~
cd python-lab
mkdir lesson-02
cd lesson-02
pwd

Si python-lab n'existe pas encore, exécutez mkdir python-lab après cd ~. Ces commandes sont identiques sur les trois systèmes.

Sous Windows, cette dernière commande devrait donner :

Path
----
C:\Users\Rafi\python-lab\lesson-02

Sous Linux :

/home/rafi/python-lab/lesson-02

Sous macOS, le chemin commence par /Users/rafi. Votre propre nom d'utilisateur apparaîtra à la place de Rafi ou rafi.

Créez maintenant un fichier appelé notes.py dans ce dossier avec le contenu suivant :

print("Folder:", "lesson-02")
print("Squares:", 2 * 2, 3 * 3, 4 * 4)

Puis exécutez-le — sous Windows :

python notes.py

Sous macOS ou Linux :

python3 notes.py

Folder: lesson-02
Squares: 4 9 16

L'interpréteur interactif de Python

Tapez simplement python dans le terminal (python3 sous macOS et Linux), puis appuyez sur Entrée, et Python s'ouvre lui-même :

python3

Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

La première ligne sera différente sur votre ordinateur — elle indique votre version de Python, une date et le nom de votre système d'exploitation (sous Windows, elle se termine par on win32, sous macOS par on darwin). Le signe >>> est identique partout et signifie que Python attend une ligne de votre part. Tout ce que vous écrivez ici obtient une réponse immédiate :

>>> 2 + 3
5
>>> "Python"
'Python'
>>> len("terminal")
8

C'est ce qu'on appelle le REPL — Read, Eval, Print, Loop (lire, évaluer, afficher, boucler). Il est très utile pour vérifier quelque chose de petit : qu'un calcul est juste, ou ce que renvoie une fonction.

Pour quitter :

>>> exit()

La différence qui fait perdre des heures : dans le REPL, taper 2 + 3 vous affiche 5 tout seul. Mais si vous ne mettez que 2 + 3 dans un fichier .py et l'exécutez, rien ne s'affiche — Python fait le calcul, jette le résultat et reste silencieux. Dans un fichier, vous devez écrire print pour voir quoi que ce soit. Voilà la vraie différence entre le REPL et un script.

En cas de problème

python : The term 'python' is not recognized... (Windows) ou command not found: python (macOS, Linux) Sous Windows, Python n'est pas dans le PATH — consultez la section « En cas de problème » du chapitre précédent : relancez l'installeur et cochez la case sous Modify. Sous macOS et Linux, la commande s'appelle python3.

can't open file '...notes.py': [Errno 2] No such file or directory Le terminal se trouve dans le mauvais dossier, ou il y a une faute de frappe dans le nom du fichier. Exécutez pwd pour voir où vous êtes, puis ls pour vérifier si le fichier s'y trouve.

cd : Cannot find path ... because it does not exist (Windows) ou cd: no such file or directory (macOS, Linux) Le dossier n'a pas encore été créé, ou le nom est incorrect. Créez-le avec mkdir, et appuyez sur Tab la prochaine fois que vous tapez le nom.

Le terminal semble bloqué et n'affiche que >>> Vous vous trouvez à l'intérieur du REPL, pas dans le terminal. ls et python notes.py ne fonctionneront pas ici — ce sont des commandes du terminal, pas du Python. Tapez exit() pour en sortir.

Le nom du dossier contient des espaces Mettez le nom entier entre guillemets : cd "mon dossier python". Cela fonctionne sur les trois systèmes. Nommer les dossiers sans espaces évite entièrement le problème — c'est pourquoi python-lab et mes_notes sont de meilleures habitudes.

À vous de jouer

Depuis le terminal, en n'utilisant que des commandes :

1. Créez un dossier appelé practice à l'intérieur de python-lab
2. Déplacez-vous dans ce dossier et confirmez avec pwd
3. Créez-y un fichier appelé about.py qui affiche votre nom et la date du jour
4. Exécutez-le avec python about.py (python3 about.py sous macOS ou Linux)
5. Maintenant, remontez d'un niveau avec cd .. et exécutez à nouveau la même commande — que s'est-il passé ?

Cette dernière étape est la leçon essentielle. Une fois que vous aurez vu l'erreur volontairement, vous reconnaîtrez sa cause en une seconde lorsqu'elle se présentera dans un vrai contexte de travail.