HOWTO · Python
Lister tous les fichiers du répertoire et des sous-répertoires en Python
Ce didacticiel montre comment répertorier tous les fichiers d'un répertoire et de sous-répertoires en Python.
Sur cette page
Pour récupérer les chemins de tous les fichiers situés sous un répertoire de départ, utilisez os.walk() en Python. Cette fonction parcourt l’arborescence et fournit, pour chaque répertoire visité, son chemin, les noms de ses sous-répertoires et ceux de ses fichiers. Joignez le chemin du répertoire courant à chaque nom de fichier pour construire son chemin. Les exemples présentés ici répertorient les fichiers, et non toutes les entrées des répertoires.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
import os
import tempfile
with tempfile.TemporaryDirectory() as temporary_directory:
root = Path(temporary_directory) / "project"
(root / "reports").mkdir(parents=True)
for relative_path in ("notes", "data.csv", "reports/summary.txt", "reports/2025.csv"):
(root / relative_path).write_text("sample", encoding="utf-8")
for current, directories, filenames in os.walk(root):
directories.sort()
for filename in sorted(filenames):
print(Path(current, filename).relative_to(root))
data.csv
notes
reports/2025.csv
reports/summary.txt
Cet exemple temporaire crée sa propre arborescence, avec notamment un fichier sans extension, puis affiche les chemins relatifs au répertoire de départ. Pour construire des chemins complets, utilisez plutôt Path(current, filename) ou os.path.join(current, filename). Un chemin relatif est pratique pour enregistrer les résultats ; un chemin absolu est utile lorsque vous transmettez les fichiers à un autre code. Le séparateur de chemin utilisé dépend du système d’exploitation.
Utiliser os.walk() pour répertorier les fichiers de manière récursive
La boucle ci-dessus utilise os.walk() comme méthode par défaut pour répertorier simplement les fichiers de manière récursive. À chaque itération, la première valeur est le chemin du répertoire courant, la deuxième est une liste modifiable des noms de ses sous-répertoires et la troisième contient les noms des fichiers de ce répertoire. Parcourez cette troisième valeur pour ne pas inclure les répertoires. Triez les noms des sous-répertoires si vous avez besoin d’un ordre de parcours stable. Par défaut, les erreurs de parcours sont ignorées ; fournissez onerror si votre application doit les signaler.
Utiliser os.listdir() pour effectuer un parcours récursif personnalisé
os.listdir(path) renvoie les noms des entrées d’un seul répertoire ; cette fonction ne parcourt pas ses sous-répertoires. Pour effectuer un parcours personnalisé, gardez une pile des chemins à examiner. Pour chaque chemin, parcourez les résultats de os.listdir(path), joignez chaque nom à son répertoire parent avec os.path.join(), ajoutez les fichiers au résultat et placez les répertoires dans la pile. Vérifiez la nature des entrées avec os.path.isfile() et os.path.isdir(). Cette méthode vous permet de contrôler l’ordre du parcours et le filtrage, mais votre code doit gérer lui-même la récursion et les erreurs du système de fichiers.
Utiliser os.scandir() pour examiner les entrées d’un répertoire
os.scandir(path) fournit des objets DirEntry correspondant aux entrées d’un seul répertoire. Leurs méthodes is_file() et is_dir() permettent de déterminer facilement les éléments à récupérer et les sous-répertoires à parcourir. Reprenez le parcours avec une pile décrit ci-dessus et ouvrez chaque répertoire avec with os.scandir(path) as entries: afin que l’itérateur soit correctement fermé. Cette méthode est utile lorsque le type ou les métadonnées d’une entrée influencent votre décision.
Utiliser glob.glob() pour rechercher des fichiers selon un motif
Pour sélectionner des fichiers selon un motif, glob.glob(os.path.join(root, "**", "*"), recursive=True) recherche les noms à toute profondeur, y compris ceux des fichiers sans extension. Lorsque recursive=True est activé, le composant ** permet de parcourir les sous-répertoires. Les résultats de glob peuvent inclure des répertoires : filtrez-les avec os.path.isfile(path) si vous ne voulez obtenir que des fichiers. Utilisez un motif plus précis, tel que "**/*.csv", pour sélectionner un type de fichier ; "*.*" exclut les noms qui ne contiennent pas de point.
Utiliser pathlib.Path pour répertorier les fichiers de manière récursive
pathlib.Path(root).rglob("*") fournit récursivement les chemins situés sous le répertoire racine. Filtrez les résultats avec path.is_file() pour exclure les répertoires. Les objets renvoyés sont des instances de Path ; vous pouvez donc utiliser des méthodes comme relative_to(root) et name sans joindre manuellement des chaînes. Utilisez str(path) lorsqu’une API attend un chemin sous forme de chaîne.
Choisir une méthode selon la tâche
Choisissez os.walk() comme solution générale lorsque vous voulez distinguer clairement les noms de fichiers de ceux des sous-répertoires. Préférez os.scandir() si vous devez examiner le type ou les métadonnées des entrées pendant le parcours. Utilisez glob.glob() pour rechercher des fichiers selon un motif, et pathlib.Path.rglob() si vous travaillez avec des objets chemin. Choisissez os.listdir() lorsque vous avez besoin d’une stratégie de parcours personnalisée et êtes prêt à l’implémenter. Ces méthodes renvoient des chemins ou des noms, et non le contenu des fichiers ; ouvrez séparément un chemin pour lire ou traiter un fichier. Si le répertoire de départ est absent ou illisible, gérez les erreurs du système de fichiers selon l’API utilisée et le comportement requis par votre application.