答案是环境不匹配导致模块查找失败:pip与python指向不同解释器、虚拟环境未激活、Python版本与Selenium不兼容(如4.15+需3.8~3.12)、IDE解释器路径配置错误或安装缓存损坏。

报错不是“pip命令写错了”,而是你当前 Python 解释器压根没拿到 selenium 模块——哪怕终端显示 Successfully installed selenium-4.15.0,也可能装到了另一个 Python 环境里。
确认 pip 和 python 是同一个环境的
这是最常被忽略的一步。Windows 上常见 pip 指向系统 Python,而你在 PyCharm 或 VS Code 里用的是虚拟环境里的 python;macOS 上可能用了 brew 安装的 Python,但 pip 还是系统自带的老版本。
- 运行
which python(macOS/Linux)或where python(Windows),记下路径 - 再运行
which pip或where pip,对比两者是否在同一个目录下(比如都含venv或都含miniconda3) - 如果不一致,强制用解释器调用 pip:
python -m pip install selenium—— 这能确保模块装进当前python对应的site-packages
安装时连接超时或报 HTTPSConnectionPool 错误
这类报错本质是 pip 拿不到 PyPI 的包文件,不是 Selenium 本身有问题,而是网络卡在了下载环节。错误信息里一定含 Connection to files.pythonhosted.org timed out 或 Max retries exceeded。
- 优先换国内源安装:
python -m pip install selenium -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn - 如果仍失败,先升级 pip:
python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 某些企业网络会拦截 HTTPS 请求,可临时加
--trusted-host files.pythonhosted.org(不推荐长期用,仅调试)
装完 import 还报 ModuleNotFoundError: No module named 'selenium'
说明模块确实没进当前解释器的 sys.path。常见于 PyCharm、Jupyter、VS Code 等 IDE 场景,它们默认不读系统终端的 pip 安装结果。
从QuickView趋势笔记生成韩语AI播客包,含双人主持脚本(Callie×Nick)、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版(15~20分钟)和压缩版(5~7分钟)。
- 在代码开头加两行诊断:
import sys
print('\n'.join(sys.path))
看输出里有没有你期望的 site-packages 路径(比如含 venv/lib/python3.11/site-packages)
Settings → Project → Python Interpreter,确认右上角显示的解释器路径和你 python -c "import sys; print(sys.executable)" 输出一致;不一致就点齿轮 → Add... → 选对路径python -m pip uninstall selenium 再重装,避免缓存干扰Python 版本与 Selenium 不兼容
Selenium 4.15+ 已不支持 Python 3.7 及更早版本,而 3.x 系列又不支持 Python 3.12+。装错版本会导致 pip install 表面成功,但 import selenium 时找不到核心模块(比如 selenium/webdriver 目录为空)。
- 查当前 Python 版本:
python --version - 查兼容表:
selenium 4.15.x仅支持Python 3.8 ~ 3.12;若你是 3.7,得降级:python -m pip install "selenium - 装完后验证:
python -c "import selenium; print(selenium.__version__)"—— 如果这步报错,说明版本根本没加载成功
真正卡住人的从来不是“怎么装”,而是“装给谁”。每次执行 pip install 前,先问一句:这个命令最终影响的是哪个 python?它和你写代码时运行的 python 是同一个吗?漏掉这层确认,后面所有重装、换源、清缓存都是在原地打转。

















