~ / hub / erros / ModuleNotFoundError: No module named
4 out 2026errosguia de solução

ModuleNotFoundError: No module named

Quase sempre é o pip instalando em um Python e você rodando outro.

1. Significado

ModuleNotFoundError: No module named 'requests'

O interpretador Python que executou o script não encontrou esse módulo nos caminhos onde procura. Na imensa maioria dos casos, o pacote foi instalado em outro Python (ou outro ambiente virtual).

2. Verifique qual Python e qual pip você usa

which python3 pip     # Linux/macOS
where python pip      # Windows
python3 -m pip --version
python3 -c "import sys; print(sys.executable)"

Se o caminho do pip não está no mesmo diretório/ambiente do python, são instalações diferentes. A forma segura de instalar é sempre pelo próprio interpretador:

python3 -m pip install requests

3. Use um ambiente virtual por projeto

python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
python -m pip install -r requirements.txt

Veja o passo a passo em Python venv. Lembre-se de selecionar o interpretador do .venv no editor (VS Code, PyCharm); sem isso o editor usa outro Python.

4. Causas que enganam

  • Nome do pacote ≠ nome do módulo: pip install pillow → import PIL; pip install opencv-python → import cv2; pip install beautifulsoup4 → import bs4.
  • Arquivo seu com o mesmo nome do módulo: um requests.py ou random.py na pasta sobrescreve o módulo real.
  • Módulo local fora do caminho: ao importar código do próprio projeto, rode como pacote (python -m app.main) ou ajuste a estrutura em vez de mexer em sys.path.
  • Cron, systemd ou Docker usam outro ambiente: use o caminho completo do Python do venv (/app/.venv/bin/python).

5. Confirmar se foi instalado

python3 -m pip list | grep -i requests
python3 -m pip show requests   # mostra o local da instalação
REGRA Use python -m pip em vez de pip solto. Isso elimina o erro de “instalei, mas não acha” em quase todos os casos.

Continue explorando

← erros · Python venv · Python · Roadmap Python · Curso de Python

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →