Python: как исправить ошибку 'No module named requests'

kirilljsx

Ошибка ModuleNotFoundError: No module named ‘requests’ — одна из самых частых проблем, с которой сталкиваются разработчики на Python. Она появляется, когда вы пытаетесь импортировать библиотеку requests, но интерпретатор её не находит. Звучит просто, но на практике причин может быть несколько, и не все они очевидны с первого взгляда.

В этой статье разберём, почему возникает эта ошибка, какие её источники и как быстро вернуться к работе. Если вы новичок в Python или только начинаете работать с requests для HTTP-запросов, эта информация вам точно пригодится.

Что означает эта ошибка и почему она возникает

Requestss — это не встроенная библиотека Python. Это сторонний пакет, который нужно устанавливать отдельно перед использованием. Когда Python видит команду import requests, он ищет этот модуль в определённых местах на вашем компьютере. Если находит — отлично, импорт проходит без проблем. Если не находит — выдаёт ошибку.

Ошибка возникает не потому, что Python «не любит» requests, а потому что вы либо его не установили, либо установили, но в не том месте, либо используете другую версию Python, чем та, для которой его устанавливали. Иногда проблема скрывается в конфликте между разными окружениями или в неправильной конфигурации путей поиска модулей.

Вот основные причины:

Библиотека requests вообще не установлена на компьютер
Вы работаете в виртуальном окружении, где requests не установлен
На компьютере несколько версий Python, и вы устанавливали requests для одной, а используете другую
Проблемы с правами доступа при установке пакета
Путь к Python неправильно указан в переменных окружения системы

Самое быстрое решение: установка через pip

В 90% случаев проблема решается за одну команду. Откройте командную строку (не Python-консоль, а системную консоль) и выполните:

pip install requests

Или, если у вас стоит Python 3:

pip3 install requests

После этого закройте редактор кода полностью, перезагрузите его и попробуйте снова импортировать requests. Обычно этого достаточно.

Почему именно так? Потому что pip — это встроенный менеджер пакетов Python. Он берёт нужный пакет из интернета, скачивает его и кладёт в то место, где Python его ищет. Это стандартный способ установки любых сторонних библиотек.

Ключевые моменты при установке:

Команду нужно вводить в системную консоль, а не в Python-интерпретатор
На Windows это может быть cmd, PowerShell или встроенная консоль VS Code
На Mac и Linux это терминал
Если команда не работает, убедитесь, что при установке Python вы выбрали опцию “Add Python to PATH”

Когда простая установка не помогает

Иногда вводишь команду, pip говорит, что всё установилось, но в коде ошибка остаётся. Это может быть связано с несколькими факторами. Первое, что нужно проверить — используется ли виртуальное окружение.

Виртуальные окружения в Python — это изолированные пространства, где у каждого проекта есть свои модули и зависимости. Если вы работаете в виртуальном окружении, то установка requests в системный Python не поможет. Нужно установить requests именно в то виртуальное окружение, которое использует ваш проект.

Как проверить, активно ли виртуальное окружение? Посмотрите на командную строку — если перед путём есть название окружения в скобках (например, (venv)), значит, оно активно. Если его нет, нужно активировать.

Степени для работы с виртуальным окружением:

На Windows: откройте командную строку, перейдите в папку проекта и выполните venv\Scripts\activate
На Mac и Linux: в терминале выполните source venv/bin/activate
После этого введите pip install requests — пакет установится в изолированное окружение
Если виртуального окружения нет, создайте его: python -m venv venv

Вторая частая проблема — несоответствие версий Python. Предположим, на компьютере установлены Python 2.7 и Python 3.10. Вы установили requests для Python 3.10, но в VS Code или другом редакторе случайно выбран интерпретатор Python 2.7. Результат: ошибка.

Как проверить, какой интерпретатор используется:

В VS Code откройте палитру команд (Ctrl+Shift+P) и найдите “Select Interpreter”
Убедитесь, что выбран тот же Python, для которого вы устанавливали requests
Если списка нет, возможно, Python вообще не обнаружен — нужно переустановить Python с опцией “Add to PATH”

Диагностика и проверка путей

Если вы уже установили requests, но ошибка всё ещё вас беспокоит, пора переходить к более глубокой диагностике. Python ищет модули в определённых директориях, которые указаны в переменной sys.path. Если requests находится не в одной из этих директорий, Python его не найдёт.

Проверить пути можно прямо из Python-консоли:

import sys
print(sys.path)

Вы увидите список директорий. Requests должен находиться в одной из них, обычно в папке site-packages. Если вывод очень длинный, не пугайтесь — это нормально.

Ещё одна хитрая проблема — когда в текущей директории лежит файл requests.py. Python первым делом ищет модули в текущей папке, и если там есть файл с таким названием, он возьмёт его вместо нужной библиотеки. Проверьте, нет ли в папке проекта файла requests.py и удалите его, если найдёте.

Дополнительные способы диагностики:

Проверьте, что модуль действительно установлен: pip list — выведет все установленные пакеты
Убедитесь, что вы не опечатались в названии: это requests, а не request (без буквы s в конце)
Попробуйте переустановить пакет: pip install --upgrade requests
Если ничего не помогает, удалите и переустановите: pip uninstall requests затем pip install requests

Особые случаи и специфические решения

Бывают ситуации, когда стандартные решения не срабатывают. Например, в некоторых Unix-системах Python встроен в операционную систему, и у него могут быть ограничения на установку пакетов. В таких случаях система иногда требует использовать pip с флагом --user:

pip install --user requests

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

Если вы работаете с проектом, в котором уже есть файл requirements.txt, не нужно устанавливать пакеты по одному. Этот файл содержит список всех зависимостей проекта. Просто выполните:

pip install -r requirements.txt

Pip автоматически установит все нужные пакеты одной командой. Это удобно, когда вы скачали проект из интернета или клонировали его из Git-репозитория.

И последний нюанс — если вы работаете с IDE типа PyCharm, там может быть встроенный интерпретатор. PyCharm часто может предложить установить недостающие пакеты автоматически. Если вы видите жёлтую полоску с предложением установить пакет, кликните на неё — это обычно решает проблему гораздо быстрее.

Что попробовать, если уже всё испробовали

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

Также стоит проверить, нет ли в пути к проекту или пути к Python кириллицы или специальных символов. Иногда это вызывает проблемы с поиском модулей. Если в названии директорий стоит русский текст, попробуйте переместить проект в папку с латинскими буквами.

Если вы используете корпоративный компьютер с ограничениями, возможно, администратор системы заблокировал установку пакетов через pip. В этом случае нужно либо обратиться в IT-отдел, либо использовать виртуальное окружение с флагом --system-site-packages.

Используемые методы в приоритетном порядке:

Перезагрузить редактор кода и командную строку
Убедиться, что активно нужное виртуальное окружение
Переустановить пакет: pip uninstall requests && pip install requests
Проверить интерпретатор Python в редакторе кода
Проверить, нет ли файла requests.py в текущей директории
Использовать флаг --user при установке
Обновить pip: python -m pip install --upgrade pip

Автоматизация и предотвращение проблем

Добрая практика — всегда работать в виртуальном окружении и использовать файл requirements.txt. Это не только помогает избежать проблем с установкой, но и облегчает совместную работу в команде. Когда вы отправляете код коллеге, вместе с кодом идёт файл с информацией о всех нужных пакетах. Коллега просто выполнит pip install -r requirements.txt, и у него установится всё необходимое.

Создать requirements.txt можно автоматически:

pip freeze > requirements.txt

Эта команда выведет все установленные в текущем окружении пакеты с версиями. Обычно в требования добавляют только нужные пакеты, но pip freeze выведет и их зависимости, что тоже полезно для воспроизводимости.

Ещё один совет — используйте современные инструменты управления зависимостями типа Poetry или Pipenv. Они упрощают работу с виртуальными окружениями и требованиями, автоматизируют многие процессы и делают жизнь разработчика проще. Но на начальном уровне обычного pip вполне достаточно.

Когда виртуальное окружение правильно настроено и requirements.txt актуален, проблемы с импортом модулей практически исчезают. Это особенно полезно при работе на разных компьютерах или при передаче проекта другим разработчикам.

Почему стоит разобраться с этой ошибкой сразу

Ошибка No module named requests может показаться мелочью, но она указывает на более глубокое понимание того, как Python управляет зависимостями. Разобравшись с ней один раз, вы поймёте, как работают виртуальные окружения, менеджер пакетов pip и пути поиска модулей. Это знание применимо не только к requests, но и к любым другим библиотекам.

Большинство начинающих разработчиков тратят на эту проблему больше времени, чем нужно, просто потому, что не знают, где искать ответ. Но как только вы поймёте логику, дальнейшая работа с Python-зависимостями станет гораздо проще и понятнее.