Pour lire ou écrire un fichier texte en Python, on ouvre le fichier avec open() dans un bloc with, en précisant le mode ("r" pour lire, "w" pour écrire, "a" pour ajouter) et l'encodage (encoding="utf-8"). Le bloc with ferme le fichier tout seul, même si une erreur survient. Le reste tient en quelques méthodes : read(), l'itération ligne par ligne et write().
with open("notes.txt", "r", encoding="utf-8") as f:
contenu = f.read()
print(contenu)
Les modes d'ouverture de open()
Le deuxième argument de open() décide de ce que vous avez le droit de faire. Le mode par défaut est "r" (lecture en mode texte). Le piège classique est "w" : il vide le fichier dès l'ouverture, avant même que vous écriviez la première ligne.
| Mode | Usage | Si le fichier existe | S'il n'existe pas |
|---|---|---|---|
"r" | Lire | Lecture depuis le début | FileNotFoundError |
"w" | Écrire | Contenu effacé | Fichier créé |
"a" | Ajouter à la fin | Contenu conservé, écriture à la suite | Fichier créé |
"x" | Créer un nouveau fichier | FileExistsError | Fichier créé |
"r+" | Lire et écrire | Contenu conservé | FileNotFoundError |
Ajoutez "b" au mode ("rb", "wb") pour un fichier binaire comme une image ou un PDF. Python manipule alors des octets (bytes) et non du texte, et le paramètre encoding ne s'utilise plus.
Toujours préciser l'encodage
Un fichier texte n'est qu'une suite d'octets. L'encodage dit à Python comment les transformer en caractères. Si vous l'omettez, le résultat dépend de votre version de Python : depuis Python 3.15, UTF-8 est l'encodage par défaut, alors que les versions précédentes utilisaient celui du système. Sous Windows, cet ancien comportement donnait des accents illisibles ou une UnicodeDecodeError sur des fichiers créés ailleurs.
La règle simple : écrivez encoding="utf-8" à chaque open() en mode texte. Votre script se comportera de la même façon sur le poste d'un collègue, sur un serveur et dans une ancienne version de Python. Si un fichier vient d'un vieux logiciel et refuse de s'ouvrir, essayez encoding="cp1252" (encodage Windows d'Europe de l'Ouest) ou ajoutez errors="replace" pour repérer les caractères qui posent problème.
Lire un fichier texte : trois façons
Tout le contenu d'un coup avec read()
f.read() renvoie le fichier entier sous forme d'une seule chaîne. C'est pratique pour un fichier de configuration ou un modèle de texte. Évitez-le sur un journal de plusieurs gigaoctets : tout part en mémoire.
Ligne par ligne avec une boucle for
Pour un fichier long, parcourez l'objet fichier directement. La documentation Python présente cette méthode comme la plus économe en mémoire, la plus rapide et la plus lisible.
with open("acces.log", encoding="utf-8") as f:
for ligne in f:
ligne = ligne.rstrip("\n")
if "ERROR" in ligne:
print(ligne)
Chaque ligne lue conserve son retour à la ligne final \n. D'où le rstrip("\n"), oublié dans beaucoup de scripts qui affichent ensuite des lignes vides en trop. Si vous débutez avec les boucles, le guide sur l'écriture d'une boucle for ou while en Python reprend la syntaxe pas à pas.
Une liste de lignes avec readlines()
f.readlines() renvoie une liste dont chaque élément est une ligne. Utile pour compter les lignes ou accéder à la dixième. Le fichier est là aussi chargé en entier. Quant à f.readline() (sans s), il lit une seule ligne à chaque appel et renvoie une chaîne vide en fin de fichier.
Écrire et ajouter du texte
write() écrit la chaîne telle quelle et renvoie le nombre de caractères écrits. Il n'ajoute pas de retour à la ligne : à vous de mettre \n. Il n'accepte que du texte, donc un nombre doit être converti avec str() ou une f-string.
ventes = {"lundi": 12, "mardi": 9}
with open("rapport.txt", "w", encoding="utf-8") as f:
for jour, total in ventes.items():
f.write(f"{jour} : {total} ventes\n")
Pour compléter un fichier sans l'écraser, ouvrez-le en mode "a". Contrairement à ce qu'on lit parfois, il n'existe pas de méthode append() sur les fichiers : c'est le mode d'ouverture qui fait la différence, puis on appelle write() comme d'habitude.
from datetime import datetime
with open("journal.txt", "a", encoding="utf-8") as f:
f.write(f"{datetime.now():%Y-%m-%d %H:%M} import terminé\n")
Gérer les erreurs courantes
Trois exceptions reviennent sans cesse : FileNotFoundError (chemin faux ou fichier absent), PermissionError (fichier ouvert par un autre programme, souvent Excel sous Windows, ou dossier protégé) et UnicodeDecodeError (mauvais encodage). Attrapez-les séparément pour afficher un message utile plutôt qu'une trace illisible.
try:
with open("clients.txt", encoding="utf-8") as f:
lignes = f.readlines()
except FileNotFoundError:
print("clients.txt introuvable : vérifiez le dossier de lancement du script.")
except UnicodeDecodeError:
print("Encodage inattendu : essayez encoding='cp1252'.")
Le FileNotFoundError vient souvent du chemin relatif. Il se calcule à partir du dossier depuis lequel vous lancez le script, pas de celui où se trouve le fichier .py. Pour aller plus loin sur try, except et finally, consultez notre article sur la gestion des erreurs et exceptions dans un script Python.
pathlib : la version moderne pour les cas simples
Le module pathlib, inclus dans Python, manipule les chemins comme des objets. Ses méthodes read_text() et write_text() ouvrent, lisent ou écrivent et ferment le fichier en une ligne. write_text() écrase le fichier existant, comme le mode "w".
from pathlib import Path
dossier = Path(__file__).parent / "exports"
dossier.mkdir(parents=True, exist_ok=True)
(dossier / "bilan.txt").write_text("Bilan du jour\n", encoding="utf-8")
texte = (dossier / "bilan.txt").read_text(encoding="utf-8")
Construire le chemin à partir de Path(__file__).parent règle au passage le problème du dossier de lancement. Gardez open() pour lire ligne par ligne ou pour ajouter du contenu.
Cas pratique : nettoyer une liste d'e-mails
Un fichier contacts.txt contient une adresse par ligne, avec des doublons, des majuscules et des lignes vides. L'objectif : produire un fichier propre, trié et sans doublon.
from pathlib import Path
base = Path(__file__).parent
emails = set()
with open(base / "contacts.txt", encoding="utf-8") as f:
for ligne in f:
adresse = ligne.strip().lower()
if "@" in adresse:
emails.add(adresse)
with open(base / "contacts_propres.txt", "w", encoding="utf-8") as f:
f.write("\n".join(sorted(emails)) + "\n")
print(f"{len(emails)} adresses uniques enregistrées")
Le script lit en flux, nettoie chaque ligne, élimine les doublons grâce à un set et écrit le résultat dans un nouveau fichier. Le fichier d'origine reste intact. C'est une bonne habitude : on n'écrit jamais dans le fichier qu'on est en train de lire. Ce type de petit script est la base de l'automatisation de tâches répétitives avec Python.
Quand passer à un autre outil
Un fichier texte brut convient aux journaux, listes et notes. Dès que les données ont des colonnes séparées par des virgules ou des points-virgules, utilisez le module csv de la bibliothèque standard plutôt qu'un split(",") fait main, qui casse au premier champ contenant une virgule. Pour filtrer, regrouper ou calculer sur des milliers de lignes, l'analyse de données avec pandas fait le même travail en quelques lignes. Pour les fichiers de configuration structurés, le module json lit et écrit directement des dictionnaires.
Pour aller plus loin
Reprenez le cas pratique sur un vrai fichier de votre activité : un export de contacts, un journal d'application ou une liste de produits. Une fois la lecture, l'écriture et les erreurs maîtrisées, vous pouvez enchaîner sur l'automatisation de vos traitements. La formation Python orientée automatisation est construite autour de ce type de tâches, et la formation Python à distance préparant la certification TOSA va des bases du langage à Pandas et aux bases de données.