如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘selenium’ 问题

Python系列Bug修复PyCharm控制台pip install报错：如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘selenium’ 问题

摘要

在日常 Python 开发中，尤其是使用 PyCharm 2025 作为 IDE 时，我们常常会在控制台中遇到 pip install 的各种报错。例如，最典型的场景就是在项目中引入 selenium 时，执行 import selenium 却提示 ModuleNotFoundError: No module named 'selenium'。

这种问题经常困扰新手和老手开发者，原因可能是：环境配置不对、网络问题、包管理混乱、PYTHONPATH 设置缺失、或者 pip 版本老旧。本文将对出现该问题的 开发场景、环境差异、常见原因、解决方案 做一个超详细的总结，并结合流程图、表格、Mermaid 图等方式，帮助你快速定位问题与修复。

---

一、开发场景说明

这个问题通常出现在以下典型场景：

在 PyCharm 的项目控制台运行 import selenium 时，Python 报错：
ModuleNotFoundError: No module named 'selenium'

这种情况经常出现在：

• 新创建的虚拟环境（venv/conda）中
• requirements.txt 没有被正确安装
• 本地网络环境不稳定，pip 安装失败
• 使用多版本 Python，pip 和 python 不一致

---

二、开发环境

• 操作系统：macOS Ventura
• Python 版本：Python 3.11
• IDE：PyCharm 2025 专业版
• 包管理器：pip 24.0

---

三、问题出现的常见原因与解决方案

1. 模块未安装或包名错误

很多时候问题就是——根本没有安装 selenium。

pip install selenium

⚠️ 注意：一定要确认 PyCharm 项目使用的虚拟环境 与命令行执行 pip 的环境一致。

---

2. 网络问题：切换国内源

在中国大陆地区，使用官方源容易超时。可以配置国内常用源：

pip.conf（Linux/Mac）

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

pip.ini（Windows）

[global]
index-url = https://mirrors.aliyun.com/pypi/simple

📌 常见源列表：

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple
豆瓣(douban)	https://pypi.doubanio.com/simple

---

3. 忘记 import

即使包已安装，如果代码中忘记 import selenium，同样会报错。

# 正确写法
from selenium import webdriver

---

4. 没有 __init__.py 文件

如果是自定义包，缺少 __init__.py 会导致 Python 无法识别为模块。

my_project/├── selenium/   # 自建包│   ├── __init__.py│   └── driver.py

---

5. 版本不兼容

某些情况下，安装的 selenium 版本和 Python 版本不兼容。

pip install selenium==4.10.0

---

6. 包名冲突

如果你本地项目目录就叫 selenium，那么 Python 导入时会误认为是本地目录而不是第三方包。

解决方法：修改自建目录名，避免与第三方包同名。

---

7. 没设置 PYTHONPATH

当模块路径不在 PYTHONPATH 下时，Python 无法找到模块。

export PYTHONPATH=$PYTHONPATH:/your/project/path

---

8. 相对导入错误

在包中使用 from ..module import xxx 时，可能出现导入错误。建议用绝对导入，或者在 __main__.py 中运行。

---

9. pip 版本过旧

很多人忽视 pip 本身的版本问题。升级 pip 是解决包安装问题的关键。

pip install --upgrade pip

---

四、解决问题的完整流程图

---

五、总结表格

问题类型	解决方案	备注
包未安装/包名错误	pip install 正确包名	区分 selenium vs selenuim（拼写错误）
网络问题	配置国内源	TUNA、阿里云、豆瓣
import 忘写	添加 import	IDE 自动补全可减少错误
缺少 __init__.py 文件	新增该文件	标记为 Python 包
版本不对	指定版本安装	pip install selenium==x.x.x
包名冲突	修改自定义包名	避免与第三方重名
PYTHONPATH 未设置	设置环境变量	export PYTHONPATH=...
相对导入错误	使用绝对导入	推荐规范化路径
pip 版本老旧	升级 pip	保持最新

---

六、更多扩展解决方案

• 使用 conda install selenium 避免 pip 与环境冲突
• 检查 requirements.txt 并一次性安装依赖
• 在 PyCharm 配置 正确的解释器（Preferences → Project Interpreter）
• 使用 virtualenv 或 poetry 统一管理依赖

---

七、温馨提示🔔

更多Bug解决方案请查看==> 全栈Bug解决方案专栏 https://blog.csdn.net/lyzybbs/category_12988910.html

---

作者✍️名片

---