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
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
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
# 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 :
Importer le module
from PIL import Image→ Importer le module Image de Pillow
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.
Afficher l'image
img.show()→ Ouvrir avec la visionneuse d'images par défaut du systèmeUniquement pour le débogage, non recommandé pour les environnements de production
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)
Redimensionner
small_img = img.resize((100,100))→ Forcer le redimensionnement à 100×100 pixelsRemarque : cela modifiera le rapport d'aspect de l'image d'origine.
Enregistrer la nouvelle image
small_img.save("small_example.jpg")→ Enregistrer l'image redimensionnéeVous pouvez ajouter le paramètre quality pour contrôler la qualité JPEG.