首页/资讯中心/详情

Python+Selenium自动化测试环境搭建全攻略：从零到稳定运行

Python+Selenium自动化测试环境搭建全攻略：从零到稳定运行
📅 发布时间：2026/7/1 21:15:40

1. 项目概述：为什么需要搭建一个稳定的自动化测试环境？

如果你是一名测试工程师、开发人员，或者正在学习自动化测试，那么“环境搭建”这四个字对你来说一定不陌生。它就像盖房子前打地基，地基不稳，后面砌再漂亮的墙也容易塌。Python + Selenium 这套组合，是目前 Web 端自动化测试领域最经典、应用最广泛的方案之一。它门槛相对较低，社区资源丰富，功能强大，从简单的页面元素操作到复杂的业务流程模拟都能胜任。

然而，我见过太多新手，甚至是有些经验的朋友，在第一步“环境搭建”上就栽了跟头。不是 Python 版本不对，就是浏览器驱动不匹配，或者 Selenium 库安装失败，一个简单的pip install selenium背后可能藏着各种依赖冲突和网络问题。这直接导致学习热情被浇灭，项目进度被拖延。因此，搭建一个清晰、稳定、可复现的自动化测试环境，绝不是可有可无的步骤，而是保证后续所有自动化脚本能够稳定运行的前提。这篇文章，我将结合我多年的踩坑经验，为你拆解从零开始搭建 Python + Selenium 自动化测试环境的每一个细节，目标是让你一次成功，避开所有我当年掉进去的“坑”。

2. 环境搭建的核心思路与工具选型

在动手之前，我们先理清思路。一个完整的 Python + Selenium 自动化测试环境，核心包含三个部分：编程语言与运行环境、自动化测试库、浏览器与驱动。这三者必须版本兼容，协同工作。

2.1 核心组件解析与选型理由

1. Python：为什么是 Python 而不是 Java 或 C#？Python 语法简洁，学习曲线平缓，对于测试人员特别友好。其庞大的生态库（如requests,pytest,allure）能轻松支撑起一个完整的自动化测试框架。对于自动化测试这种偏重业务逻辑和快速迭代的场景，Python 的脚本特性和丰富的第三方库提供了无与伦比的效率。我们选择当前稳定的版本，如 Python 3.8 或 3.9，避免使用太老（如 Python 2.7）或太新（可能库兼容性未跟上）的版本。

2. Selenium：WebDriver 的本质是什么？Selenium 不是一个单一工具，而是一个项目集合。我们通常说的 Selenium 指的是 Selenium WebDriver。它的核心原理是：通过各浏览器官方提供的驱动（如 ChromeDriver、geckodriver），调用浏览器原生的自动化接口，实现真正的浏览器操控。这不同于基于 JavaScript 注入的早期 Selenium RC，WebDriver 更稳定、更强大。我们通过pip安装的selenium包，就是一个与这些驱动进行通信的客户端库。

3. 浏览器与驱动：版本同步是生命线这是环境搭建中最容易出错的一环。你必须保证浏览器版本、浏览器驱动版本、Selenium 库版本三者大致兼容。通常，Selenium 库的更新会跟上主流浏览器，所以矛盾主要出现在浏览器和其驱动之间。例如，你安装了 Chrome 版本 115，就必须使用兼容 Chrome 115 的 ChromeDriver，用 114 或 116 的驱动很可能无法工作。我们的策略是：优先确定浏览器版本，然后为其寻找匹配的驱动。

2.2 环境管理方案：虚拟环境的必要性

强烈建议使用 Python 的虚拟环境（如venv或conda）来管理本项目依赖。这能带来两个核心好处：

  • 环境隔离：为每个自动化项目创建独立的 Python 环境，避免不同项目间依赖包版本冲突。比如项目A需要 Selenium 4.0，项目B需要 Selenium 3.14，它们可以和平共处。
  • 环境可复现：通过requirements.txt文件记录所有依赖包及其精确版本，在新机器上可以一键重建完全相同的环境，这对于团队协作和持续集成至关重要。

很多初学者直接在系统全局 Python 中安装包，初期看似方便，但随着项目增多，迟早会陷入“依赖地狱”。从开始就养成好习惯，事半功倍。

3. 详细搭建步骤与实操要点

接下来，我们进入实操环节。我会以 Windows 系统为例，同时兼顾 macOS/Linux 的关键差异点。目标是搭建一个用于 Chrome 浏览器的自动化测试环境。

3.1 第一步：安装与配置 Python

  1. 下载 Python：访问 Python 官网，下载 Windows 安装程序。务必勾选“Add Python 3.x to PATH”选项，这会将 Python 和 Pip 添加到系统环境变量，让你能在任何命令行窗口直接使用python和pip命令。
  2. 验证安装：打开命令提示符（CMD）或 PowerShell，输入python --version和pip --version。正确显示版本号即表示安装成功。
    C:\Users\YourName>python --version Python 3.9.13 C:\Users\YourName>pip --version pip 22.0.4 from ... (python 3.9)

注意：如果遇到“python 不是内部或外部命令”的错误，说明环境变量未正确配置。你需要手动将 Python 的安装目录（如C:\Python39）和脚本目录（如C:\Python39\Scripts）添加到系统的 PATH 变量中。

3.2 第二步：创建并激活虚拟环境

在你的项目目录下（例如D:\AutoTestProject）进行操作：

  1. 创建虚拟环境：

    # 进入项目目录 D:\>cd AutoTestProject # 创建名为 'venv' 的虚拟环境 D:\AutoTestProject>python -m venv venv

    这会在当前目录下生成一个venv文件夹，里面包含了一个独立的 Python 解释器和 pip。

  2. 激活虚拟环境：

    • Windows (CMD):
      D:\AutoTestProject>venv\Scripts\activate.bat
    • Windows (PowerShell):
      D:\AutoTestProject>venv\Scripts\Activate.ps1
    • macOS/Linux:
      $ source venv/bin/activate

    激活成功后，命令行提示符前会出现(venv)标识，表示你已进入该虚拟环境，后续所有 pip 操作都只影响这个环境。

3.3 第三步：安装 Selenium 库

在激活的虚拟环境中，执行安装命令。建议使用国内镜像源加速下载。

(venv) D:\AutoTestProject>pip install selenium -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，可以通过pip list查看已安装的包，确认selenium及其版本。

3.4 第四步：部署浏览器驱动（以 Chrome/Chromium 为例）

这是最关键也最容易出错的一步。

  1. 查看 Chrome 浏览器版本：打开 Chrome，点击右上角三个点 -> 帮助 -> 关于 Google Chrome。记下版本号（例如：版本 115.0.5790.170）。

  2. 下载对应版本的 ChromeDriver：

    • 访问 ChromeDriver 官方下载站或国内镜像站。
    • 核心原则：驱动的版本号必须与你的 Chrome主版本号一致。例如 Chrome 是 115.x.x.x，你就需要下载版本号为 115.x.x.x 的 ChromeDriver。
    • 根据你的操作系统（Win32, Win64, mac64, linux64）下载对应的压缩包。

  3. 配置驱动路径（三种常用方法，推荐方法一）：

    • 方法一：放置到系统 PATH 目录（最简单）。将下载的chromedriver.exe文件，直接放入 Python 安装目录下的Scripts文件夹（该目录已在 PATH 中），或者放入虚拟环境的Scripts目录。
    • 方法二：放置到项目目录。将chromedriver.exe放在你的项目根目录下，然后在代码中指定绝对路径。
    • 方法三：使用webdriver-manager库（最省心）。在虚拟环境中安装webdriver-manager，它会在运行时自动下载和匹配对应版本的驱动。
      pip install webdriver-manager
      代码中用法：
      from selenium import webdriver from webdriver_manager.chrome import ChromeDriverManager from selenium.webdriver.chrome.service import Service service = Service(ChromeDriverManager().install()) driver = webdriver.Chrome(service=service)

3.5 第五步：编写并运行第一个验证脚本

在项目目录下创建一个test_demo.py文件，写入以下代码：

from selenium import webdriver from selenium.webdriver.chrome.service import Service from selenium.webdriver.common.by import By import time # 如果你使用方法一或二配置驱动，且驱动已在PATH中，可以这样初始化 # driver = webdriver.Chrome() # 如果你将chromedriver.exe放在了项目目录，或想明确指定路径 # service = Service(executable_path=r'D:\AutoTestProject\chromedriver.exe') # driver = webdriver.Chrome(service=service) # 如果你使用了webdriver-manager（推荐） from webdriver_manager.chrome import ChromeDriverManager service = Service(ChromeDriverManager().install()) driver = webdriver.Chrome(service=service) try: # 打开百度首页 driver.get("https://www.baidu.com") # 等待页面加载 time.sleep(2) # 找到搜索框，输入“Selenium” search_box = driver.find_element(By.ID, 'kw') search_box.send_keys('Selenium') # 找到“百度一下”按钮并点击 search_button = driver.find_element(By.ID, 'su') search_button.click() # 等待结果加载 time.sleep(3) # 打印当前页面标题 print("当前页面标题是：", driver.title) finally: # 等待5秒后关闭浏览器 time.sleep(5) driver.quit()

在虚拟环境的命令行中运行这个脚本：

(venv) D:\AutoTestProject>python test_demo.py

如果一切顺利，你会看到 Chrome 浏览器自动打开，访问百度，执行搜索，然后在命令行输出标题，最后关闭。恭喜你，基础环境搭建成功！

4. 进阶配置与最佳实践

基础环境能跑起来只是第一步。要让这个环境真正健壮、高效，适合项目开发，还需要进行一些进阶配置。

4.1 浏览器选项配置：让自动化更稳定

直接使用webdriver.Chrome()会打开一个带有“正受到自动测试软件控制”提示的浏览器，且是全新用户数据目录。我们可以通过Options进行优化：

from selenium import webdriver from selenium.webdriver.chrome.options import Options chrome_options = Options() # 常用配置 chrome_options.add_argument('--headless') # 无头模式，不显示浏览器UI，适合服务器执行 chrome_options.add_argument('--disable-gpu') # 禁用GPU加速，某些环境下需要 chrome_options.add_argument('--no-sandbox') # 在Linux Docker环境中常需要此参数 chrome_options.add_argument('--disable-dev-shm-usage') # 解决Linux共享内存问题 chrome_options.add_argument('--window-size=1920,1080') # 设置初始窗口大小 chrome_options.add_experimental_option('excludeSwitches', ['enable-logging']) # 禁止无关日志 # 禁止显示“正受到自动测试软件控制”的提示栏（非绝对必要，根据需求） chrome_options.add_experimental_option('excludeSwitches', ['enable-automation']) chrome_options.add_experimental_option('useAutomationExtension', False) # 使用配置项创建驱动 driver = webdriver.Chrome(options=chrome_options)

4.2 依赖管理：使用 requirements.txt

在项目根目录，生成记录所有依赖包的文件：

(venv) D:\AutoTestProject>pip freeze > requirements.txt

这个requirements.txt文件应该被提交到版本控制系统（如 Git）。当你的同事拉取代码后，只需要创建虚拟环境并执行：

pip install -r requirements.txt

就能一键安装所有正确版本的依赖，保证环境一致。

4.3 集成开发环境配置

虽然可以在命令行运行脚本，但使用 IDE 能极大提升效率。以 VS Code 为例：

  1. 安装 VS Code 和 Python 扩展。
  2. 打开项目文件夹。
  3. 按Ctrl+Shift+P，输入 “Python: Select Interpreter”，选择你项目中虚拟环境下的 Python 解释器（路径类似./venv/Scripts/python.exe）。
  4. 现在你可以在 VS Code 中直接运行和调试 Python 脚本，并且智能提示会基于虚拟环境中的库。

5. 常见问题排查与解决实录

即使按照步骤操作，你也可能会遇到一些问题。这里记录了几个最常见的问题和解决方案。

5.1 浏览器驱动相关问题

问题1：SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version XX

  • 原因：ChromeDriver 版本与 Chrome 浏览器版本不匹配。
  • 解决：
    1. 确认你的 Chrome 浏览器版本。
    2. 访问 ChromeDriver 下载站，下载对应主版本号的驱动。如果找不到完全一致的，尝试下载版本号最接近的。
    3. 终极方案：使用webdriver-manager库，让它自动处理版本匹配。

问题2：WebDriverException: Message: ‘chromedriver’ executable needs to be in PATH.

  • 原因：系统找不到chromedriver.exe。
  • 解决：
    1. 检查chromedriver.exe是否已下载并解压（下载的是压缩包）。
    2. 确认其存放路径是否已添加到系统的 PATH 环境变量中，或者你是否在代码中通过Service指定了正确的绝对路径。
    3. 一个快速测试方法：在命令行直接输入chromedriver，如果提示“无法将 ‘chromedriver’ 识别为内部或外部命令”，则说明 PATH 配置不正确。

5.2 浏览器启动与元素定位问题

问题3：浏览器闪退，或脚本执行后浏览器立即关闭

  • 原因：脚本执行完毕，Python 进程结束，驱动和浏览器随之关闭。代码中没有足够的等待时间或没有正确处理退出。
  • 解决：
    1. 在脚本最后添加time.sleep(10)进行临时观察。
    2. 更好的方法是使用 Selenium 的显式等待，而不是固定的time.sleep。
    3. 确保driver.quit()放在finally块或异常处理中，保证无论脚本是否出错，浏览器都能被正确关闭，释放资源。

问题4：NoSuchElementException: Unable to locate element

  • 原因：脚本执行速度比页面加载速度快，在元素尚未出现时就尝试定位它。
  • 解决：永远不要依赖固定的time.sleep。使用显式等待。
    from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.common.by import By # 等待最多10秒，直到ID为‘kw’的元素出现 element = WebDriverWait(driver, 10).until( EC.presence_of_element_located((By.ID, "kw")) ) element.send_keys('test')
    显式等待是编写健壮自动化脚本的基石。

5.3 网络与安装问题

问题5：pip install速度慢或超时

  • 原因：默认的 PyPI 源在国外。
  • 解决：使用国内镜像源。
    pip install selenium -i https://pypi.tuna.tsinghua.edu.cn/simple
    或者永久修改 pip 源。

问题6：虚拟环境激活失败（PowerShell 执行策略限制）

  • 现象：在 PowerShell 中执行Activate.ps1时报错，提示“无法加载文件...因为在此系统上禁止运行脚本”。
  • 解决：以管理员身份打开 PowerShell，执行Set-ExecutionPolicy RemoteSigned，选择Y。这更改的是当前用户的执行策略，允许运行本地签名的脚本。完成后即可正常激活虚拟环境。

6. 从环境到框架：下一步的方向

成功搭建环境并运行第一个脚本，只是一个开始。要将其用于实际项目，你还需要考虑更多：

  • 测试框架集成：将 Selenium 操作封装到unittest或pytest测试用例中，利用框架提供的测试发现、夹具、断言等功能。pytest因其灵活性和强大插件生态，目前是主流选择。
  • 页面对象模型：这是 Selenium 自动化测试的核心设计模式。将每个页面封装成一个类，页面的元素定位和操作作为类的方法。这能极大提高代码的可读性、可维护性和复用性。
  • 数据驱动：将测试数据（如登录用户名密码）从代码中分离出来，存放在 Excel、JSON、YAML 或数据库中，实现一套脚本执行多组数据测试。
  • 报告与日志：集成Allure或HTMLTestRunner等报告工具，生成直观的测试报告。同时，使用 Python 的logging模块记录详细的执行日志，便于排查问题。
  • 持续集成：将你的自动化测试脚本接入 Jenkins、GitLab CI 等持续集成工具，实现代码提交后自动触发测试，并查看测试结果。

环境搭建是这一切的起点。一个干净、稳定、配置清晰的环境，能让你在后续学习和开发中免受干扰，把精力集中在测试逻辑和业务本身。我个人的习惯是，每开始一个新项目，或者换一台新电脑，第一件事就是按照一个固定的清单（也就是本文的步骤）把基础环境快速搭起来，这已经成了肌肉记忆。希望这份详细的指南，也能帮你建立起这样一份可靠的清单。