Miniconda3搭建Selenium的python虚拟环境全攻略

用 Miniconda3 创建独立 Python 环境学习 Selenium 的 全流程指南，包含 环境配置、依赖安装、测试验证 三大核心环节，解决版本冲突、网络加速等痛点：

一、Miniconda3 安装（Windows/macOS/Linux 通用）

1. 下载 Miniconda3 安装包

• 国内高速下载（推荐）：
  访问 清华大学镜像站，选择与系统匹配的安装包（如 Windows 选 Miniconda3-latest-Windows-x86_64.exe）。
• 官网下载：
  访问 Miniconda 官网，点击对应系统的安装包。

2. 安装 Miniconda3（以 Windows 为例）

• 双击安装包 → 勾选 I Agree → 选择 All Users（管理员权限） → 设置安装路径（如 C:\miniconda3） → 勾选 Add Miniconda3 to PATH environment variable（自动配置环境变量）。
• 验证安装：
  按 Win+R 输入 cmd，执行：

  conda --version  # 若显示版本号（如 conda 23.9.0），则安装成功
  

二、创建 Selenium 专属虚拟环境

1. 打开命令行工具

• Windows：
  按 Win+X 选择 Windows 终端（管理员）。
• macOS/Linux：
  打开 终端（Terminal）。

2. 创建环境并激活

# 创建环境（指定 Python 3.8 + 环境名 selenium_env）
conda create -n selenium_env python=3.8 -y
# 激活环境
conda activate selenium_env  # 激活后命令行前缀会显示 (selenium_env)

-- 可以是指定目录安装：
# 语法：conda create --prefix 目标路径 python=版本号 -y
conda create --prefix "D:\python_envs\selenium_env" python=3.8 -y

# 激活指定路径环境的语法：conda activate 环境完整路径
conda activate D:\python_envs\selenium_env

注意：

• Windows 路径格式：D:\folder\env_name（用反斜杠 \ 或正斜杠 / 均可）
• macOS/Linux 路径格式：/Users/yourname/envs/selenium_env（必须用正斜杠 /）
• 路径含空格时需用引号包裹（不推荐，易出问题）

3. 配置国内镜像源（加速下载）

# 配置 conda 镜像（清华源）
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --set show_channel_urls yes

# 配置 pip 镜像（阿里云源）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

三、安装 Selenium 及兼容依赖

1. 安装 Selenium 3.141.0（稳定版）

pip install selenium==3.141.0

2. 安装兼容的 urllib3 库

pip install urllib3==1.25.11  # 与 Selenium 3.141.0 完全兼容

3. 安装浏览器驱动管理工具（选其一）

• 方案 A：自动管理驱动（推荐）
  安装 webdriver-manager，自动下载匹配浏览器版本的驱动：

  pip install webdriver-manager==3.8.5  # 固定版本避免兼容性问题
  

• 方案 B：手动安装驱动（需自行下载）
  访问 ChromeDriver 官网，下载与 Chrome 浏览器版本匹配的驱动，解压后将 chromedriver.exe 放在任意目录（如 C:\tools），并将路径添加到系统环境变量的 PATH 中。

四、pycharm关联虚拟环境

1、打开 PyCharm 项目（新建或已有项目均可）

1. 若新建项目：打开 PyCharm → 点击「New Project」。
2. 若已有项目：打开项目后，点击顶部菜单栏「File」→「Settings」（Windows/Linux）或「PyCharm」→「Preferences」（macOS）。

2、进入「Python 解释器」设置界面

情况 1：新建项目时添加环境（推荐新手）

• 在「New Project」页面，点击「Python Interpreter」右侧的「Add Interpreter」→ 选择「Add Local Interpreter…」。

情况 2：为已有项目添加环境

• 打开「Settings」后，左侧导航栏展开「Project: 你的项目名」→ 点击「Python Interpreter」→ 右上角点击「齿轮图标」→ 选择「Add…」。

3、选择并关联 Conda 虚拟环境

1. 在弹出的「Add Python Interpreter」窗口中：

   • 左侧选择「Conda Environment」（Conda 环境）。
   • 右侧选择「Existing environment」（已存在的环境）→ 点击「…」（浏览按钮）。

2. 定位到你的 Conda 环境路径：

   • 在「浏览」窗口中，找到你创建的环境路径 E:\pyenv\selenium_env，进入该文件夹后，选择 python.exe（Windows 系统）或 bin/python（macOS/Linux）。
     • 示例完整路径：E:\pyenv\selenium_env\python.exe（确保选中的是环境根目录下的 python.exe，而非其他路径）。

3. 勾选「Make available to all projects」（可选，允许该环境被其他项目使用）→ 点击「OK」。

4、验证环境是否添加成功

1. 返回「Python Interpreter」页面，在解释器列表中会显示你添加的环境路径（如 Python 3.8 (selenium_env) E:\pyenv\selenium_env\python.exe）。
2. 点击「OK」关闭设置窗口，此时 PyCharm 右下角会显示当前使用的解释器（如 3.8 (selenium_env)），表示环境已生效。

5、测试环境（确保能运行 Selenium 代码）

1. 在项目中新建一个 Python 文件（如 test_conda_env.py），输入以下代码：

   import selenium
   import urllib3
   
   print("Selenium 版本：", selenium.__version__)  # 应输出 3.141.0
   print("urllib3 版本：", urllib3.__version__)    # 应输出 1.25.11
   

2. 右键点击代码 → 选择「Run ‘test_conda_env’」，若控制台输出正确版本号，说明环境关联成功且依赖正常。

常见问题解决

1. PyCharm 找不到 Conda 环境的 python.exe？

   • 检查路径是否正确：确保是 E:\pyenv\selenium_env 根目录下的 python.exe，而非子文件夹（如 Scripts）。
   • 若路径含中文/空格，可能导致识别失败，建议重命名环境路径（如 E:\pyenv\selenium_env 无特殊字符）。

2. 添加后运行代码提示「模块未安装」？

   • 确认已在该环境中安装依赖：在 PyCharm 底部的「Terminal」中输入（自动激活当前环境）：

     pip install selenium==3.141.0 urllib3==1.25.11
     

这样PyCharm 会完全使用你创建的 Conda 虚拟环境，确保 Selenium 及依赖版本与环境一致，避免冲突。后续安装新库时，直接在 PyCharm 的 Terminal 中用 pip install 即可（自动安装到当前关联的环境）。

四、测试环境是否正常工作

1. 编写测试脚本（test_selenium.py）

from selenium import webdriver
from webdriver_manager.chrome import ChromeDriverManager  # 仅方案 A 需要

# 方案 A：自动下载驱动
driver = webdriver.Chrome(ChromeDriverManager().install())

# 方案 B：手动指定驱动路径（需替换为实际路径）
# driver = webdriver.Chrome(executable_path="C:\\tools\\chromedriver.exe")

# 打开百度并验证
driver.get("https://www.baidu.com")
assert "百度" in driver.title, "页面标题验证失败"
print("测试通过！页面标题：", driver.title)
driver.quit()

2. 运行测试脚本

python test_selenium.py

• 预期结果：
  自动打开 Chrome 浏览器，访问百度，输出 测试通过！页面标题：百度一下，你就知道，浏览器自动关闭。

五、常见问题解决方案

1. 驱动版本不匹配

• 错误提示：
  SessionNotCreatedException: session not created: This version of ChromeDriver only supports Chrome version X
• 解决方法：
  • 方案 A：执行 webdriver-manager update 更新驱动。
  • 方案 B：手动下载对应版本驱动并替换路径。

2. 网络下载失败

• 错误提示：
  TimeoutError: [Errno 11001] getaddrinfo failed
• 解决方法：
  • 检查网络连接，或切换到手机热点。
  • 方案 A 中指定国内镜像下载驱动：

    from webdriver_manager.chrome import ChromeDriverManager
    driver = webdriver.Chrome(ChromeDriverManager(url="https://npm.taobao.org/mirrors/chromedriver").install())
    

3. 环境变量未生效

• 错误提示：
  'conda' 不是内部或外部命令
• 解决方法：
  • 重新打开命令行工具（确保生效）。
  • 手动将 Miniconda3 路径（如 C:\miniconda3\Scripts）添加到系统环境变量的 PATH 中。

4.pycharm中找不到新增的conda虚拟环境

本质原因：conda创建的虚拟python环境没有将目录添加到系统环境变量中
造成以上问题的原因有：
1、conda版本过低
低版本的conda在添加环境变量时有问题
解决：
1）手动将创建的python环境目录添加到系统环境变量中：

SET PATH=E:\pyenv\selenium_env;E:\pyenv\selenium_env\Scripts;%PATH%

2）升级你的conda版本->重新创建环境和激活环境

conda update -n base -c defaults conda --force-reinstall -y

3）卸载你的旧conda，按照步骤一下载新的conda，部分旧版本无法通过命令直接升级了

2、创建的python环境中存在空格或特殊字符
解决：将目录换成全英去掉空格。再重新创建环境和激活环境。

小知识：为什么创建的环境有上述问题，但conda env list能查询到虚拟环境，cmd输入where python以及pycharm导入环境时识别不到呢

5. conda创建python环境失败

5.1 报错信息：

Collecting package metadata (repodata.json): done
Solving environment: failed

1）简化下载渠道
找到C:\users[你的用户名]目录下的.condarc文件 和 conda安装目录下的.condarc文件
用记事本编辑内容：

channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
show_channel_urls: true
solver: classic  # 关键！切换回经典 solver，避免 libmamba 解析问题

2）清理缓存

conda clean --index-cache -y
conda clean --packages -y

3. 重新安装环境

conda create -p D:\miniconda3\envs\selenium_env python=3.9.18 -c conda-forge --solver=classic -y

5.2 在激活环境时 conda activate E:\pyenv\selenium_env
报错：
CondaError: Run ‘conda init’ before ‘conda activate’
解决：

conda init

然后再重新启动一个cmd窗口，激活

六、环境管理常用命令

通过以上步骤，你已拥有一个 纯净、独立、版本可控 的 Selenium 学习环境，可避免与其他项目的依赖冲突。后续学习中，可直接激活环境（conda activate selenium_env）并安装新库（如 pip install requests），无需担心版本污染问题喽。