Установка 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

Пример

import PIL
print(PIL.__version__)

Способ 2: Проверка в командной строке

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

Если установка прошла успешно, будет отображён номер версии Pillow.


Устранение распространённых проблем

1. Сбой установки

Возможные причины:

  • Отсутствуют библиотеки зависимостей (такие как zlib, libjpeg и т. д.)
  • Проблемы с правами доступа

Решения:

Пользователям Linux/macOS, возможно, потребуется сначала установить системные зависимости:

Пример

# Ubuntu/Debian
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 вы можете начать изучать её мощные возможности обработки изображений:

Пример

from PIL import Image

# Открыть изображение
img = Image.open("example.jpg")

# Отобразить изображение
img.show()

# Преобразовать формат изображения
img.save("example.png")

# Изменение размера
small_img = img.resize((100, 100))
small_img.save("small_example.jpg")

Пояснение кода:

  1. Импорт модуля

    • from PIL import Image→ Импорт модуля Image библиотеки Pillow

  2. Открыть изображение

    • img = Image.open("example.jpg")→ Загрузить файл изображения по указанному пути

    • Поддерживаемые форматы: JPG/PNG/GIF/BMP и т. д.

  3. Отобразить изображение

    • img.show()→ Открыть в системном просмотрщике изображений по умолчанию

    • Только для отладки, не рекомендуется для производственных сред

  4. Сохранить изображение

    • img.save("example.png")→ Сохранить в указанном формате

    • Формат определяется расширением файла (например, .jpg/.png)

  5. Изменить размер

    • small_img = img.resize((100,100))→ Принудительно изменить размер до 100×100 пикселей

    • Примечание: это изменит соотношение сторон исходного изображения.

  6. Сохранить новое изображение

    • small_img.save("small_example.jpg")→ Сохранить масштабированное изображение

    • Вы можете добавить параметр quality для управления качеством JPEG.

Дополнительные расширения