Ошибка from ddg_images_api import search в Python 3.11: как разобрать и исправить

Если Python падает на строке from ddg_images_api import search, значит интерпретатор не смог найти модуль, функцию внутри модуля или совместимую версию пакета в текущем окружении. Это не обязательно ошибка в самой строке кода: чаще проблема в том, что пакет не установлен, установлен не туда, называется иначе или уже не подходит под Python 3.11

Такую ошибку нельзя чинить вслепую командой из случайного комментария. Сначала нужно понять, что именно сообщает Python: ModuleNotFoundError, ImportError, ошибка установки пакета или ошибка совместимости

Сначала посмотрите на последнюю строку ошибки

Типичный вариант выглядит так

ModuleNotFoundError: No module named 'ddg_images_api'

Это значит, что Python вообще не видит модуль ddg_images_api в текущем окружении

Другой вариант

ImportError: cannot import name 'search' from 'ddg_images_api'

Здесь модуль найден, но внутри него нет функции search с таким именем. Такое бывает, если библиотека изменила API или в уроке использована другая версия

Еще один вариант

SyntaxError

Тогда проблема уже не в установке пакета, а в самом коде: лишние символы, неправильные кавычки, скопированный мусор после строки импорта

Проверьте, что вы импортируете именно ddg_images_api

В запросах часто встречается искаженный вариант ввп_images_api. Это похоже не на название Python-пакета, а на ошибку раскладки или автозамены. Python не поймет кириллическое ввп как ddg

Проверьте строку в файле

from ddg_images_api import search

В ней должны быть латинские буквы d, d, g, а не русские символы. Если строка была скопирована из мессенджера или PDF, лучше удалить ее полностью и набрать руками

Проверьте, установлен ли пакет в текущем Python

Запустите команду именно через тот Python, которым запускаете проект

python -m pip show ddg-images-api

Если команда ничего не показала, пакет не установлен в этом окружении

Попробуйте посмотреть список установленных пакетов

python -m pip list

Если у вас на компьютере несколько Python, обычная команда pip install ... может установить пакет в одну версию, а проект запускаться в другой. Поэтому безопаснее использовать python -m pip, а не просто pip

Проверьте, какой Python запускает ваш файл

Создайте рядом с проектом файл check_python.py

import sys

print(sys.executable)
print(sys.version)

Запустите его

python check_python.py

Вы увидите путь к интерпретатору и версию Python. Если там Python 3.11, а пакет был установлен в Python 3.10 или в другое виртуальное окружение, импорт не сработает

Установка может называться не так, как импорт

В Python имя пакета для установки и имя модуля для импорта не всегда совпадают. Например, пакет может устанавливаться через одно имя, а импортироваться через другое. Поэтому нельзя угадывать команду установки только по строке импорта

Что проверить

• откуда взят код с ddg_images_api
• есть ли у проекта requirements.txt
• указана ли там нужная библиотека
• есть ли документация к пакету
• поддерживает ли пакет Python 3.11

Если код взят из чужого репозитория, сначала посмотрите файл requirements.txt или pyproject.toml

python -m pip install -r requirements.txt

Так вы установите именно те зависимости, которые ожидал автор проекта

Если библиотека устарела или не находится

Иногда проблема не в вас. Небольшие библиотеки для поиска картинок могут устареть, исчезнуть из PyPI или перестать работать после изменений на стороне поискового сервиса

В таком случае лучше не пытаться любой ценой воскресить конкретную строку, а заменить подход

Для учебного проекта можно сделать функцию-заглушку, чтобы остальной код продолжил работать

def search(query):
    return [
        "https://example.com/image-1.jpg",
        "https://example.com/image-2.jpg"
    ]

images = search("python")
print(images)

Это не ищет настоящие картинки, но помогает проверить логику проекта: цикл, вывод, сохранение ссылок, обработку результата

Для рабочего проекта нужно выбрать актуальную библиотеку или официальный API, который имеет документацию и правила использования

Как временно обернуть импорт, чтобы программа не падала сразу

Если проект большой, можно сделать понятное сообщение вместо непонятного traceback

try:
    from ddg_images_api import search
except ImportError as error:
    print("Не удалось импортировать ddg_images_api")
    print("Проверьте установку пакета и виртуальное окружение")
    print(error)
    raise

Такой код не скрывает ошибку, но объясняет, куда смотреть. Для новичка это намного полезнее, чем голая строка ModuleNotFoundError

Диагностика по шагам

Используйте короткий чек-лист

1. Проверьте, что в строке импорта нет русских букв вместо латинских
2. Посмотрите последнюю строку ошибки
3. Запустите python --version
4. Запустите python -m pip show ddg-images-api
5. Проверьте requirements.txt проекта
6. Убедитесь, что запускаете файл из того же виртуального окружения
7. Проверьте документацию пакета и поддержку Python 3.11
8. Если пакет устарел, замените библиотеку или сделайте временную функцию-заглушку

Что делать, если ошибка появилась в строке line 8

Сообщение line 8 in <module> означает только место, где Python остановился. Это не значит, что ошибка всегда именно в восьмой строке как в синтаксисе. Если на восьмой строке стоит импорт, причина может быть в окружении или библиотеке

Пример

File "main.py", line 8, in <module>
    from ddg_images_api import search
ModuleNotFoundError: No module named 'ddg_images_api'

Здесь восьмая строка — место вызова импорта. Исправлять нужно не номер строки, а отсутствие модуля

Мини-практика

Создайте файл import_check.py

import sys

print("Python:", sys.version)
print("Путь:", sys.executable)

try:
    from ddg_images_api import search
    print("Импорт работает")
except ImportError as error:
    print("Импорт не работает")
    print(error)

Запустите его из той же папки, где лежит ваш проект. Если импорт не работает, вы получите понятную диагностику и сможете проверить установку пакета уже осознанно

Частые ошибки

Устанавливать пакет не в то окружение

Команда pip install может относиться к другому Python. Используйте python -m pip install ...

Копировать строку с русскими буквами

ввп_images_api и ddg_images_api выглядят похоже не для Python. В имени модуля должны быть латинские символы

Не смотреть на тип ошибки

ModuleNotFoundError, ImportError и SyntaxError чинятся по-разному. Последняя строка traceback важнее общего ощущения, что «что-то сломалось»

Использовать устаревшую библиотеку без проверки

Если пакет давно не обновлялся и не поддерживает Python 3.11, лучше выбрать актуальную замену или официальный API

Что почитать дальше по Python

Если нужен общий маршрут по теме, откройте рубрику Python. Для соседних задач пригодятся эти разборы:

• Python сразу закрывает браузер: как исправить в Selenium и обычном запуске
• Как исправить SyntaxError: invalid syntax в Python
• Face recognition Python: как установить и что делать при ошибках dlib
• Pandas и Matplotlib с Python: основы анализа данных