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.pyourandom.pyna 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 emsys.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.