Python

Comment importer et utiliser une bibliothèque Python ?

Résumer avec l'IA ChatGPT Claude
On importe une bibliothèque Python avec import nom (ou from nom import fonction, ou import nom as alias) en haut du script. Les bibliothèques tierces comme pandas doivent d'abord être installées avec python -m pip, de préférence dans un environnement virtuel. ModuleNotFoundError vient le plus souvent d'une installation manquante ou faite pour un autre interpréteur.

Pour utiliser une bibliothèque Python, on l'importe en haut du script avec import nom, puis on appelle ses fonctions avec la notation nom.fonction(). Si la bibliothèque ne fait pas partie de Python (pandas, requests, NumPy…), il faut d'abord l'installer avec pip, idéalement dans un environnement virtuel. La plupart des erreurs viennent de cette étape d'installation, pas de l'instruction import elle-même.

Module, paquet, bibliothèque : de quoi parle-t-on ?

Un module est un simple fichier .py qui contient des fonctions, des classes ou des variables. Un paquet est un dossier qui regroupe plusieurs modules. « Bibliothèque » est le terme courant pour désigner un ensemble de modules ou de paquets que vous réutilisez plutôt que de tout coder vous-même.

Il en existe deux familles. La bibliothèque standard est livrée avec Python : math, datetime, csv, json, pathlib s'importent sans rien installer. Les bibliothèques tierces, comme pandas ou requests, sont publiées sur PyPI et doivent être installées avant le premier import.

Les quatre façons d'importer

La forme de base charge le module et vous oblige à préfixer chaque appel par son nom :

import math
print(math.sqrt(16))  # 4.0

Avec from … import, vous récupérez un nom précis, utilisable sans préfixe :

from datetime import date
print(date.today())

Le mot-clé as donne un alias. Certaines bibliothèques ont des alias devenus des conventions que tout le monde reconnaît :

import pandas as pd
import numpy as np
import matplotlib.pyplot as plt

Reste from module import *, qui importe tous les noms publics d'un coup. Le tutoriel officiel sur les modules le déconseille : on ne sait plus d'où vient chaque nom, et un import peut écraser une variable déjà définie. Réservez-le à des tests rapides dans la console.

Quelle forme choisir ?

SituationForme conseilléeExemple
Vous utilisez plusieurs fonctions d'un moduleimport moduleimport os puis os.listdir()
Vous utilisez une ou deux fonctions, souventfrom module import nomfrom pathlib import Path
Le nom du module est long ou a un alias d'usageimport module as aliasimport pandas as pd
Deux modules ont une fonction du même nomimport module pour garder le préfixemath.log et numpy.log

Une idée reçue à corriger : importer une seule fonction avec from math import sqrt ne rend pas le programme plus rapide. Le module est chargé en entier dans les deux cas, seul le nom disponible dans votre script change. Le choix est une question de lisibilité. Autre détail utile : un module n'est importé qu'une fois par session, même si l'instruction import apparaît plusieurs fois.

Installer une bibliothèque tierce proprement

Avant d'importer pandas ou requests, installez-les. La méthode recommandée par la documentation Python sur les environnements virtuels consiste à créer un environnement par projet, pour que chaque projet ait ses propres versions :

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

python -m pip install pandas
python -m pip freeze > requirements.txt

Le fichier requirements.txt liste les versions installées. Un collègue, ou vous-même sur un autre poste, recrée le même environnement avec python -m pip install -r requirements.txt. Écrire python -m pip plutôt que pip garantit que le paquet s'installe pour le Python que vous utilisez réellement. Le détail des commandes pip est expliqué dans notre guide pour installer et utiliser pip.

ModuleNotFoundError et autres erreurs d'import

Le message ModuleNotFoundError: No module named 'xxx' est l'erreur la plus fréquente. Elle a quatre causes principales.

CauseComment le vérifierCorrection
La bibliothèque n'est pas installéepython -m pip show pandas ne renvoie rienpython -m pip install pandas
Elle est installée pour un autre PythonVotre éditeur utilise un interpréteur différent de celui du terminalActiver l'environnement virtuel et sélectionner le même interpréteur dans l'éditeur
Le nom d'installation diffère du nom d'importLa documentation du paquet indique un autre nompip install scikit-learn puis import sklearn ; pip install Pillow puis import PIL ; pip install beautifulsoup4 puis import bs4
Faute de frappe ou de casseRelire le nom exactLes noms d'import sont sensibles à la casse

Un piège plus discret : nommer votre propre fichier comme une bibliothèque. Si votre script s'appelle pandas.py ou random.py, Python le trouve en premier, car le dossier du script passe avant les bibliothèques installées dans l'ordre de recherche. L'import charge alors votre fichier au lieu de la vraie bibliothèque, avec des erreurs du type AttributeError. Renommez le fichier et supprimez le dossier __pycache__ s'il en reste une trace.

Importer vos propres modules

Le même mécanisme sert à organiser votre code. Placez vos fonctions Python réutilisables dans un fichier outils.py, au même niveau que votre script, puis importez-les :

# outils.py
def calculer_ttc(prix_ht, taux_tva=0.2):
    return round(prix_ht * (1 + taux_tva), 2)

if __name__ == "__main__":
    print(calculer_ttc(100))  # test rapide, ignoré lors d'un import
# main.py
from outils import calculer_ttc
print(calculer_ttc(250))

Le bloc if __name__ == "__main__": ne s'exécute que si vous lancez outils.py directement. Quand le fichier est importé, ce code est ignoré. C'est l'endroit idéal pour un petit test du module.

Les bibliothèques à connaître pour un usage pro

BesoinBibliothèqueÀ installer ?
Lire et écrire des fichiers CSV ou JSONcsv, jsonNon, bibliothèque standard
Manipuler des datesdatetimeNon
Parcourir des dossiers et fichierspathlib, osNon
Analyser des tableaux de donnéespandasOui
Calcul numérique sur des tableauxNumPyOui
Créer des graphiquesMatplotlibOui
Appeler une API webrequestsOui
Lire et écrire des fichiers ExcelopenpyxlOui

Commencez par la bibliothèque standard : elle couvre déjà beaucoup de besoins d'automatisation sans aucune installation. Pour aller plus loin, voyez comment analyser des données avec pandas ou tracer un premier graphique avec Matplotlib.

Prochaine étape

Créez un dossier de projet, un environnement virtuel, installez pandas et importez-le dans un script qui lit un fichier CSV de votre activité. Si l'import échoue, reprenez le tableau des causes ci-dessus dans l'ordre. Pour progresser avec un formateur jusqu'à l'analyse de données, la formation Python à distance préparant la certification TOSA couvre les bases du langage, pandas, les bases de données et les graphiques, et elle est éligible au CPF.

Les formations liées à cet article

Pour aller plus loin sur le sujet, avec un formateur SENZA.

Ils ont suivi une formation avec SENZA

Les avis de nos apprenants.

Autres articles similaires

Python Comment utiliser Python pour analyser des données avec pandas ? 19 février 2026 · 7 minutes de lecture Python Comment gérer les erreurs et exceptions dans un script Python ? 23 octobre 2025 · 7 minutes de lecture Python Comment manipuler des fichiers texte avec Python (ouvrir, lire, écrire) ? 3 octobre 2025 · 7 minutes de lecture

E-book gratuit

Téléchargez notre programme de formation

Formation Python