Installation de Pillow

Avant d'installer Pillow, veuillez vous assurer que :

  • Python 3.7 ou version ultérieure (dernière version recommandée)
  • gestionnaire de paquets pip (généralement installé avec Python)
  • Selon la plateforme, certaines bibliothèques système et certains outils de développement supplémentaires peuvent être nécessaires.

Version de Python

Pillow nécessite Python 3.7 ou une version ultérieure.

Vous pouvez vérifier votre version de Python avec la commande suivante :

python --version
# 或
python3 --version

Outil pip

pip est l'outil de gestion des paquets de Python, généralement installé avec Python.

Vérifiez si pip est disponible :

pip --version
# 或
pip3 --version

Si pip n'est pas installé, vous pouvez consulter leguide d'installation officiel de pippour l'installer.


Installer Pillow

Méthode d'installation de base

La méthode la plus simple consiste à installer avec pip :

pip install pillow

Ou spécifiez explicitement Python 3 :

pip3 install pillow

Si vous utilisez la distribution Python Anaconda :

conda install -c anaconda pillow

Installer une version spécifique

Si vous avez besoin d'installer une version spécifique de Pillow :

pip install pillow==9.0.0

Installer dans un environnement virtuel

Il est recommandé d'installer Pillow dans un environnement virtuel pour éviter les conflits de dépendances :

# 创建虚拟环境
python -m venv pillow_env

# 激活虚拟环境
# Windows:
pillow_env\Scripts\activate

# 安装 Pillow
pip install Pillow

Installer à partir du code source

Pour les utilisateurs avancés, vous pouvez installer à partir du code source :

Téléchargez le code source :

git clone https://github.com/python-pillow/Pillow.git
cd Pillow

Installer les dépendances :

pip install -r requirements.txt

Compilez et installez :

python setup.py install

Vérifier l'installation

Après l'installation, vous pouvez vérifier si Pillow a été installé avec succès à l'aide des méthodes suivantes :

Méthode 1 : environnement interactif Python

Exemple

import PIL
print(PIL.__version__)

Méthode 2 : vérification en ligne de commande

python3 -c "import PIL; print(PIL.__version__)"

Si l'installation réussit, le numéro de version de Pillow sera affiché.


Dépannage des problèmes courants

1. Échec de l'installation

Causes possibles :

  • Bibliothèques de dépendances manquantes (telles que zlib, libjpeg, etc.)
  • Problèmes de permissions

Solutions :

Les utilisateurs de Linux/macOS peuvent avoir besoin d'installer d'abord les dépendances système :

Exemple

# Ubuntu/Debian
sudo apt-get install python3-dev python3-setuptools
 
# Fedora
sudo dnf install python3-devel

# macOS (avec Homebrew)
brew install zlib jpeg

Utilisez le paramètre --user pour éviter les problèmes de permissions :

pip install --user pillow

2. Erreur d'importation

Si vous rencontrezImportError: cannot import name '_imaging' from 'PIL'et d'autres erreurs, essayez :

pip uninstall pillow
pip install --no-cache-dir pillow

3. Problèmes de performance

Pour le traitement d'images à grande échelle, envisagez d'installer une version optimisée :
pip install pillow-simd

Votre premier programme Pillow

Après avoir installé Pillow avec succès, vous pouvez commencer à explorer ses puissantes fonctionnalités de traitement d'image :

Exemple

from PIL import Image

# Ouvrir l'image
img = Image.open("example.jpg")

# Afficher l'image
img.show()

# Convertir le format d'image
img.save("example.png")

# Redimensionner
small_img = img.resize((100, 100))
small_img.save("small_example.jpg")

Explication du code :

  1. Importer le module

    • from PIL import Image→ Importer le module Image de Pillow

  2. Ouvrir l'image

    • img = Image.open("example.jpg")→ Charger le fichier image au chemin spécifié

    • Formats pris en charge : JPG/PNG/GIF/BMP, etc.

  3. Afficher l'image

    • img.show()→ Ouvrir avec la visionneuse d'images par défaut du système

    • Uniquement pour le débogage, non recommandé pour les environnements de production

  4. Enregistrer l'image

    • img.save("example.png")→ Enregistrer au format spécifié

    • Le format est déterminé par l'extension du fichier (par ex., .jpg/.png)

  5. Redimensionner

    • small_img = img.resize((100,100))→ Forcer le redimensionnement à 100×100 pixels

    • Remarque : cela modifiera le rapport d'aspect de l'image d'origine.

  6. Enregistrer la nouvelle image

    • small_img.save("small_example.jpg")→ Enregistrer l'image redimensionnée

    • Vous pouvez ajouter le paramètre quality pour contrôler la qualité JPEG.

Extensions supplémentaires