Установка Pillow
Перед установкой Pillow, пожалуйста, убедитесь, что:
- Python 3.7 или выше (рекомендуется последняя версия)
- менеджер пакетов pip (обычно устанавливается вместе с Python)
- В зависимости от платформы могут потребоваться дополнительные системные библиотеки и инструменты разработки.
Версия Python
Pillow требует Python 3.7 или выше.
Проверить версию Python можно с помощью следующей команды:
python --version # 或 python3 --version
Инструмент pip
pip — это инструмент управления пакетами Python, обычно устанавливается вместе с Python.
Проверьте, доступен ли pip:
pip --version # 或 pip3 --version
Если pip не установлен, вы можете обратиться кофициальному руководству по установке pip, чтобы установить его.
Установка Pillow
Базовый способ установки
Проще всего установить с помощью pip:
pip install pillow
Или явно указать Python 3:
pip3 install pillow
Если вы используете дистрибутив Python Anaconda:
conda install -c anaconda pillow
Установка определённой версии
Если вам нужно установить конкретную версию Pillow:
pip install pillow==9.0.0
Установка в виртуальном окружении
Рекомендуется устанавливать Pillow в виртуальном окружении, чтобы избежать конфликтов зависимостей:
# 创建虚拟环境 python -m venv pillow_env # 激活虚拟环境 # Windows: pillow_env\Scripts\activate # 安装 Pillow pip install Pillow
Установка из исходного кода
Для опытных пользователей можно установить из исходного кода:
Скачайте исходный код:
git clone https://github.com/python-pillow/Pillow.git cd Pillow
Установите зависимости:
pip install -r requirements.txt
Скомпилируйте и установите:
python setup.py install
Проверка установки
После установки вы можете проверить, успешно ли установлен Pillow, с помощью следующих способов:
Способ 1: Интерактивная среда Python
Пример
print(PIL.__version__)
Способ 2: Проверка в командной строке
python3 -c "import PIL; print(PIL.__version__)"
Если установка прошла успешно, будет отображён номер версии Pillow.
Устранение распространённых проблем
1. Сбой установки
Возможные причины:
- Отсутствуют библиотеки зависимостей (такие как zlib, libjpeg и т. д.)
- Проблемы с правами доступа
Решения:
Пользователям Linux/macOS, возможно, потребуется сначала установить системные зависимости:
Пример
sudo apt-get install python3-dev python3-setuptools
# Fedora
sudo dnf install python3-devel
# macOS (с использованием Homebrew)
brew install zlib jpeg
Используйте параметр --user, чтобы избежать проблем с правами доступа:
pip install --user pillow
2. Ошибка импорта
Если вы столкнулись сImportError: cannot import name '_imaging' from 'PIL'и другими ошибками, попробуйте:
pip uninstall pillow pip install --no-cache-dir pillow
3. Проблемы с производительностью
Для крупномасштабной обработки изображений рассмотрите установку оптимизированной версии:pip install pillow-simd
Ваша первая программа с Pillow
После успешной установки Pillow вы можете начать изучать её мощные возможности обработки изображений:
Пример
# Открыть изображение
img = Image.open("example.jpg")
# Отобразить изображение
img.show()
# Преобразовать формат изображения
img.save("example.png")
# Изменение размера
small_img = img.resize((100, 100))
small_img.save("small_example.jpg")
Пояснение кода:
Импорт модуля
from PIL import Image→ Импорт модуля Image библиотеки Pillow
Открыть изображение
img = Image.open("example.jpg")→ Загрузить файл изображения по указанному путиПоддерживаемые форматы: JPG/PNG/GIF/BMP и т. д.
Отобразить изображение
img.show()→ Открыть в системном просмотрщике изображений по умолчаниюТолько для отладки, не рекомендуется для производственных сред
Сохранить изображение
img.save("example.png")→ Сохранить в указанном форматеФормат определяется расширением файла (например, .jpg/.png)
Изменить размер
small_img = img.resize((100,100))→ Принудительно изменить размер до 100×100 пикселейПримечание: это изменит соотношение сторон исходного изображения.
Сохранить новое изображение
small_img.save("small_example.jpg")→ Сохранить масштабированное изображениеВы можете добавить параметр quality для управления качеством JPEG.