如何解决PyCharm中pip install安装Python报错ModuleNotFoundError: No module named ‘requests’问题

最新推荐文章于 2026-01-20 14:05:30 发布

原创最新推荐文章于 2026-01-20 14:05:30 发布 · 1.2k 阅读

25 ·

本内容遵循CC 4.0 BY-SA版权协议

@猫头虎

GEO检测

标签

#python #pycharm #pip #pytorch #人工智能

全栈Bug解决方案专栏专栏收录该内容

284 篇文章

订阅专栏

如何解决PyCharm中pip install安装Python报错ModuleNotFoundError: No module named 'requests’问题【Python系列】

摘要

在Python开发过程中，尤其是在使用PyCharm作为IDE时，开发者经常会遇到模块导入相关的错误。其中，ModuleNotFoundError: No module named 'requests' 是一个常见的异常，通常出现在尝试导入第三方库如requests时，但系统无法找到该模块。这可能源于安装失败、环境配置问题或代码导入方式不当等原因。该异常常出现在网络爬虫、API调用或数据获取的开发场景中，例如在编写一个简单的HTTP请求脚本时，如果requests库未正确安装或路径未被识别，就会触发此错误。从技术细节来看，这个错误本质上是Python解释器在sys.path搜索路径中未能定位到名为’requests’的模块文件或包目录，导致导入失败。本文将详细剖析问题成因，并提供多种解决方案，帮助开发者快速排查和修复。

【Python系列PyCharm控制台pip install报错】

开发环境概述

本文讨论的问题基于以下典型开发环境：

Python版本：Python 3.10 或更高（兼容性测试基于3.12）。
操作系统：macOS Ventura 或更高版本（兼容M1/M2芯片）。
IDE：PyCharm 2025 Professional Edition（支持虚拟环境管理）。

这些环境是常见的Python开发配置，如果你的环境不同（如Windows或Linux），解决方案原理类似，但命令可能需稍作调整。

问题分析：为什么会出现ModuleNotFoundError?

异常的触发机制

ModuleNotFoundError 是Python 3.6+版本引入的异常类型，用于替换旧版的ImportError。当你运行代码如import requests时，Python会按照以下流程搜索模块：

如果搜索失败，就会报错No module named 'requests'。在PyCharm中，这个错误常在控制台pip install后立即出现，或在运行脚本时弹出。

注意：这个错误不限于’requests’，任何未找到的模块都会类似触发。但’requests’作为热门HTTP库，常在初学者项目中暴露问题。

常见成因分类

根据经验，这个错误可能源于安装、配置或代码层面。以下是扩展的可能原因列表（基于参考方向并补充）：

模块未安装或包名拼写错误：最直接的原因是requests库根本没安装，或者安装时输入了错别字如’requerts’。
网络问题导致安装失败：pip默认从PyPI下载，如果网络不稳或墙阻挡，下载会中断。
忘记import或import语法错误：安装了但代码中未正确导入。
缺少__init__.py文件：在自定义包中，如果目录缺少此文件，Python不会视其为包。
包版本不兼容：安装的requests版本与Python或项目依赖冲突。
自定义包名冲突：你的项目中有一个名为’requests.py’的文件，导致导入本地文件而非库。
PYTHONPATH未设置：环境变量未包含模块路径。
模块路径不在sys.path中：虚拟环境隔离或路径配置不当。
相对导入不当：在多级目录项目中使用相对导入如from . import xxx时出错。
pip版本过旧：旧pip可能不支持某些源或有bug。
扩展原因：虚拟环境未激活：PyCharm中未切换到正确venv，导致安装到全局而非项目环境。
扩展原因：权限问题：macOS上安装时缺少sudo或用户权限不足。
扩展原因：PyCharm缓存问题：IDE索引未更新，导致即使安装了也识别不到。
扩展原因：多Python版本冲突：系统有多个Python安装，pip指向错的解释器。

Python系列PyCharm控制台pip install报错

解决方案详解

方案一：检查并正确安装模块

首先，确认包名无误。‘requests’是标准拼写，不是’requerts’。

在PyCharm终端运行：

pip install requests

如果失败，检查输出日志。扩展：使用--verbose查看详情：

pip install requests --verbose

成功后，验证安装：

import requests
print(requests.__version__)

方案二：切换国内源解决网络问题

国外PyPI慢或被墙？切换清华源：

在终端：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

或永久配置（macOS）：

编辑~/.pip/pip.conf（若无则创建）：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

提示：阿里源也行：https://mirrors.aliyun.com/pypi/simple/

方案三：确保正确import并检查语法

代码中添加：

import requests

避免常见误区：不要写成from requests import *（虽可但不推荐，易冲突）。

扩展：如果在Jupyter中使用，确保内核重启。

方案四：添加init.py文件

如果问题是自定义包，进入包目录，创建空文件__init__.py。

Python 3.3+虽不强制，但缺少可能导致导入失败，尤其在PyCharm中。

方案五：检查并升级包版本

查看当前版本：

pip show requests

不兼容？指定版本：

pip install requests==2.31.0

扩展：使用requirements.txt管理依赖：

requests>=2.25.0

然后pip install -r requirements.txt。

方案六：避免包名冲突

搜索项目中是否有’requests.py’文件，重命名它。

扩展：使用sys.modules调试：

import sys
print(sys.modules.get('requests'))

如果输出本地路径，确认冲突。

方案七：设置PYTHONPATH环境变量

macOS终端：

export PYTHONPATH=$PYTHONPATH:/path/to/your/module

PyCharm中：Run Configuration > Environment variables 添加PYTHONPATH=/path/to/module。

扩展：永久设置在~/.bash_profile或~/.zshrc。

方案八：确保模块路径在sys.path中

运行代码检查：

import sys
print(sys.path)

如果路径缺失，手动添加：

import sys
sys.path.append('/path/to/module')

但不推荐永久用，优先用虚拟环境。

方案九：修正相对导入

在包结构如：

project/
  __init__.py
  module_a.py
  subpackage/
    __init__.py
    module_b.py

从module_b导入module_a：from .. import module_a（注意双点）。

扩展：绝对导入更好：from project import module_a。

方案十：升级pip版本

检查版本：

pip --version

升级：

python -m pip install --upgrade pip

扩展：如果pip损坏，重装Python。

扩展方案十一：激活虚拟环境

PyCharm中：File > Settings > Project > Python Interpreter，选择venv。

终端激活：

source venv/bin/activate

然后再pip install。

扩展方案十二：处理权限问题

macOS上用：

sudo pip install requests

但优先用虚拟环境避免sudo。

扩展方案十三：清除PyCharm缓存

PyCharm：File > Invalidate Caches > Invalidate and Restart。

扩展：重启IDE后，重新索引项目。

扩展方案十四：解决多Python版本冲突

检查pip指向：

which pip

用特定pip：python3.10 -m pip install requests。

总结表格

以下表格总结常见原因与解决方案：

原因分类	具体描述	解决方案	优先级
安装问题	模块未安装或拼写错	pip install requests	高
网络问题	下载失败	切换国内源如清华	中
导入问题	忘了import或语法错	检查代码import语句	高
包结构问题	无__init__.py	添加空文件	中
版本冲突	包版本不兼容	指定版本安装	中
名冲突	自定义文件同名	重命名文件	高
路径问题	PYTHONPATH未设	export PYTHONPATH	中
sys.path	路径不在搜索列表	sys.path.append	低
相对导入	使用不当	改用绝对导入	中
pip旧版	版本过旧	升级pip	低
虚拟环境	未激活	source venv/bin/activate	高
权限	安装无权	sudo pip	低
缓存	IDE缓存失效	Invalidate Caches	低
多Python	解释器冲突	用pythonX -m pip	中