当前位置： 首页 > news >正文

Selenium UI自动化测试环境搭建：Python+ChromeDriver实战指南

news 2026/6/19 0:55:49

1. 项目概述：为什么UI自动化测试是开发者的必修课？

如果你是一名开发者或者测试工程师，还在手动一遍遍点击页面、填写表单来验证功能，那真的有点“复古”了。UI自动化测试，尤其是基于Selenium的自动化，早已不是大厂的专利，它正成为提升个人和团队交付效率的标配技能。简单来说，它就是用代码模拟人的操作，让浏览器自动执行点击、输入、跳转等行为，从而完成对Web应用界面的功能验证。想象一下，每次代码更新后，你只需要点一下运行，然后去喝杯咖啡，回来就能看到一份详尽的测试报告，告诉你哪些功能正常，哪些出现了问题。这种解放双手、提升信心的感觉，是手动测试无法比拟的。

Selenium作为这个领域的“老大哥”，其地位至今难以撼动。它支持多种主流浏览器（Chrome, Firefox, Edge等）和编程语言（Python, Java, C#等），生态成熟，社区活跃，资料丰富。无论是想快速入门自动化测试的新手，还是需要构建复杂测试框架的资深工程师，Selenium都是一个绕不开的起点。本系列教程的第一篇，我们就从最基础，但也最容易踩坑的环节开始——环境安装与配置。我会带你一步步走通整个流程，并分享那些官方文档里不会写的“血泪教训”，确保你一次成功，少走弯路。

2. 环境准备：构建稳固的自动化测试地基

在开始写第一行自动化脚本之前，一个正确且稳定的环境是成功的一半。很多新手在第一步就卡住了，不是因为步骤多复杂，而是因为一些细节没注意到，导致后续问题频发。我们这里选择最主流、对新手最友好的组合：Python + Selenium + Chrome浏览器。这个组合入门快，社区支持好，出了问题也容易找到解决方案。

2.1 Python环境安装与配置

Python是我们的脚本语言，是驱动Selenium的“大脑”。虽然系统可能自带Python，但我强烈建议你使用Anaconda或从Python官网安装独立的版本，以避免与系统自带的Python产生冲突。

第一步：下载与安装访问Python官网，下载最新的稳定版本（如Python 3.11或3.12）。安装时，务必勾选“Add Python to PATH”这个选项，这是为了能在命令行中直接使用python和pip命令。如果不勾选，后续你会遇到“python不是内部或外部命令”的错误，需要手动配置环境变量，对新手不太友好。

第二步：验证安装安装完成后，打开命令行（Windows上是CMD或PowerShell，Mac/Linux上是Terminal），输入以下命令：

python --version pip --version

如果两行命令都能正确返回版本号，说明Python和包管理工具pip安装成功。

注意：在部分系统或环境下，命令可能是python3和pip3。如果你同时安装了Python2和Python3，则需要用python3来明确指定版本。为了统一，本教程后续在命令行示例中均使用python和pip，请根据你的实际情况调整。

第三步：配置国内镜像源（加速下载）默认的pip源在国外，下载Python包（库）时速度可能很慢甚至失败。配置一个国内的镜像源能极大提升体验。常用的有清华源、阿里云源等。这里以配置清华源为例：

  1. 在用户目录下（如C:\Users\你的用户名\）新建一个名为pip的文件夹。
  2. 在pip文件夹内新建一个文本文件，命名为pip.ini（注意扩展名是.ini）。
  3. 用记事本打开pip.ini，写入以下内容并保存：
    [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn

配置完成后，后续使用pip install安装任何包都会从这个镜像站快速下载。

2.2 浏览器与驱动：自动化测试的“手”和“眼睛”

Selenium本身只是一个控制浏览器行为的库，它需要通过与一个名为“WebDriver”的中间件通信，来实际操控浏览器。你可以把Selenium想象成大脑（发出指令），WebDriver是神经（传递指令），浏览器则是手脚（执行动作）。三者版本必须匹配，这是安装过程中最大的坑。

第一步：安装浏览器确保你安装了Google Chrome浏览器。建议使用官方稳定版，并记住你的Chrome版本号（在浏览器地址栏输入chrome://version/查看，第一行就是，例如120.0.6099.130）。

第二步：下载ChromeDriver这是最关键的一步。ChromeDriver的版本必须与你的Chrome浏览器主版本号完全一致（例如都是120.x.x.x）。

  1. 访问ChromeDriver的官方下载站或国内镜像站。官方地址有时访问困难，可以使用淘宝的镜像站。
  2. 根据你的操作系统（Windows, Mac, Linux）和Chrome版本号，下载对应的ChromeDriver压缩包。
  3. 对于Windows用户，下载的是一个名为chromedriver_win32.zip的文件。解压后，你会得到一个chromedriver.exe文件。

第三步：配置ChromeDriver路径下载的chromedriver.exe需要放在一个地方，并让系统或Python脚本能找到它。有三种常用方法，推荐第一种，最简单：

  • 方法一：放入Python脚本目录。这是最直接的方法。将chromedriver.exe文件直接复制到你的Python自动化脚本所在的同一个文件夹里。在代码中，你就可以用相对路径./chromedriver.exe来指定它。
  • 方法二：放入系统PATH路径。将chromedriver.exe放在一个固定的目录（例如C:\WebDriver\），然后将这个目录添加到系统的环境变量PATH中。这样，在任何地方运行脚本，Selenium都能自动找到它。具体添加PATH的方法可以搜索“Windows添加环境变量”获得。
  • 方法三：在代码中指定绝对路径。在初始化WebDriver时，直接传入chromedriver.exe的完整路径，如driver = webdriver.Chrome(executable_path=r‘C:\path\to\chromedriver.exe‘)。注意，Python字符串中的路径最好使用原始字符串（前缀r）或双反斜杠\\，以避免转义字符问题。

实操心得：我强烈建议新手使用方法一。在项目初期，把所有相关文件（脚本、驱动、测试数据）放在一个项目文件夹内管理，清晰且不易出错。等熟悉了整个流程，再考虑使用更全局的配置方法（方法二）。另外，务必养成一个好习惯：每次Chrome浏览器自动升级后，记得检查并更新对应的ChromeDriver，否则脚本会报错。

3. 核心安装步骤：让Selenium在你的机器上跑起来

环境准备好后，安装Selenium库本身反而是最简单的一步。但这一步也藏着一些优化技巧。

3.1 使用pip安装Selenium库

打开命令行，输入以下命令：

pip install selenium

如果你之前配置了清华镜像源，这个下载过程会非常快。安装完成后，可以通过pip show selenium来查看安装的版本信息。

版本选择建议：通常直接安装最新稳定版即可。但如果你需要与团队或历史项目保持一致，可以指定版本安装，例如pip install selenium==4.15.0。Selenium 4.x 版本相比 3.x 有较大改进，如更好的W3C协议支持、相对定位器等新特性，建议新项目直接使用4.x。

3.2 编写你的第一个验证脚本

安装完成不代表环境就通了，我们必须写一个简单的脚本，真正地启动浏览器并打开一个网页，这才算成功。在你的项目文件夹里，新建一个Python文件，例如first_test.py。

# first_test.py from selenium import webdriver from selenium.webdriver.common.by import By import time # 1. 创建WebDriver实例，启动Chrome浏览器 # 如果你的chromedriver.exe放在脚本同目录，这样写即可 driver = webdriver.Chrome() # 2. 使用get方法打开百度首页 driver.get("https://www.baidu.com") # 3. 等待2秒，让我们能看到页面加载 time.sleep(2) # 4. 在搜索框输入“Selenium” # 首先通过元素的ID属性找到搜索输入框 search_box = driver.find_element(By.ID, "kw") # 然后向输入框发送文本“Selenium” search_box.send_keys("Selenium") # 5. 找到“百度一下”按钮并点击 search_button = driver.find_element(By.ID, "su") search_button.click() # 6. 等待3秒，查看搜索结果 time.sleep(3) # 7. 关闭浏览器窗口 driver.quit() print("第一个Selenium自动化脚本执行成功！")

逐行解析与注意事项：

  • from selenium import webdriver：导入Selenium的核心模块。
  • from selenium.webdriver.common.by import By：导入定位元素的方式。在Selenium 4中，find_element_by_id这种旧写法已被弃用，官方推荐使用find_element(By.ID, “value”)这种更统一、清晰的方式。
  • driver = webdriver.Chrome()：这行代码会尝试启动Chrome浏览器。如果系统找不到chromedriver.exe，会抛出WebDriverException异常。如果成功，你将看到一个弹窗提示“Chrome正受到自动测试软件的控制”，并且打开一个全新的、干净的浏览器窗口（无缓存、无插件）。
  • driver.get(“url”)：命令浏览器导航到指定的网址。
  • time.sleep(seconds)：强制等待。这是一个非常初级但有效的等待方式，让脚本暂停执行几秒，以便页面有足够时间加载。但在实际项目中，应尽量避免滥用time.sleep，因为它效率低下且不稳定。我们后续会介绍更智能的“显式等待”。
  • find_element(By.ID, “kw”)：这是元素定位。By.ID表示通过HTML元素的id属性来查找，“kw”是百度搜索输入框的id值。你可以通过浏览器的开发者工具（F12）查看元素的这些属性。
  • send_keys(“text”)：向输入框模拟键盘输入。
  • click()：模拟鼠标点击动作。
  • driver.quit()：非常重要！这会关闭所有由WebDriver打开的浏览器窗口，并结束WebDriver进程。与之对应的还有一个driver.close()，它只关闭当前标签页。为了彻底释放资源，养成使用quit()的好习惯。

运行这个脚本。如果一切顺利，你会看到Chrome浏览器自动打开，访问百度，输入“Selenium”并搜索，然后关闭。控制台输出成功信息。恭喜你，你的Selenium环境已经成功搭建并验证通过！

4. 进阶配置与最佳实践

一次性的成功运行只是开始。为了让你的自动化测试环境更健壮、更易于维护，我们需要进行一些进阶配置。

4.1 浏览器启动选项配置

默认启动的浏览器会带有“受自动化测试控制”的提示，并且是一个全新的干净环境。有时我们需要定制浏览器的行为，比如禁用提示、设置窗口大小、启用无头模式等。这可以通过ChromeOptions来实现。

from selenium import webdriver from selenium.webdriver.chrome.options import Options from selenium.webdriver.chrome.service import Service # 创建ChromeOptions对象 chrome_options = Options() # 1. 禁用“Chrome正受到自动测试软件的控制”提示 chrome_options.add_experimental_option("excludeSwitches", ["enable-automation"]) chrome_options.add_experimental_option('useAutomationExtension', False) # 2. 设置浏览器窗口最大化 chrome_options.add_argument("--start-maximized") # 3. 启用无头模式（不显示浏览器界面，在后台运行） # chrome_options.add_argument("--headless=new") # Chrome 109以上版本推荐写法 # chrome_options.add_argument("--headless") # 旧版本写法 # 注意：无头模式下，某些需要渲染或交互的特性可能表现不同，调试时可先关闭。 # 4. 禁用沙盒模式（在某些Linux环境或Docker中可能需要） # chrome_options.add_argument("--no-sandbox") # 禁用/dev/shm使用（在某些Linux环境或Docker中可能需要） # chrome_options.add_argument("--disable-dev-shm-usage") # 5. 指定ChromeDriver路径（如果未加入PATH） service = Service(executable_path=r‘./chromedriver.exe‘) # 相对路径示例 # 将options和service传入，创建driver driver = webdriver.Chrome(service=service, options=chrome_options) driver.get("https://www.baidu.com") # ... 你的测试代码 driver.quit()

配置解析：

  • excludeSwitches和useAutomationExtension：这两个选项组合使用，可以有效去除浏览器顶部的自动化提示栏，让测试环境更接近真实用户环境。
  • --start-maximized：让浏览器启动时直接最大化，避免因窗口大小导致元素不可见而定位失败。
  • --headless：无头模式是自动化测试，特别是集成到CI/CD流水线中的关键。它不启动GUI界面，极大节省系统资源，可以在服务器上运行。但调试时建议关闭，以便观察页面实际状态。
  • --no-sandbox和--disable-dev-shm-usage：这两个是常见的在Linux服务器或Docker容器中运行Chrome时需要的参数，用于解决权限和共享内存问题。在Windows和Mac本地开发时通常不需要。

4.2 使用WebDriver Manager管理浏览器驱动

手动下载和管理ChromeDriver版本是一件繁琐且容易出错的事情。有一个非常棒的三方库叫webdriver-manager，它可以自动检测你本地安装的浏览器版本，并下载匹配的WebDriver，彻底解决版本匹配的烦恼。

安装WebDriver Manager：

pip install webdriver-manager

在代码中使用：

from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager # 使用ChromeDriverManager自动下载和管理驱动 service = Service(ChromeDriverManager().install()) # 创建driver时传入service driver = webdriver.Chrome(service=service) driver.get("https://www.baidu.com") # ... 你的测试代码 driver.quit()

第一次运行时，ChromeDriverManager().install()会检查本地Chrome版本，然后自动从镜像站下载对应的驱动到缓存目录。以后再次运行，如果版本没变，就直接使用缓存，非常方便。它同样支持Firefox、Edge等浏览器。

强烈推荐：对于所有新手和大多数项目，直接使用webdriver-manager是最佳实践。它能将你从“驱动版本不匹配”这个最常见的坑里彻底解救出来。

5. 常见问题与排查技巧实录

即使按照步骤操作，你也可能会遇到一些问题。下面是我在帮助无数新手解决问题后，总结出的最常见错误及其解决方案。

5.1 驱动相关问题

问题1：selenium.common.exceptions.WebDriverException: Message: ‘chromedriver‘ executable needs to be in PATH.

  • 现象：运行脚本时，程序报错，提示找不到chromedriver。
  • 原因：Selenium无法在系统的PATH环境变量或脚本当前目录中找到chromedriver.exe文件。
  • 解决方案：
    1. 检查放置位置：确认chromedriver.exe是否放在了你的Python脚本所在的同一个文件夹里。
    2. 检查文件名：确保文件名是chromedriver.exe（Windows）或chromedriver（Mac/Linux），没有多余的后缀或空格。
    3. 指定绝对路径：在代码中使用Service明确指定驱动路径，如Service(executable_path=r‘C:\full\path\to\chromedriver.exe‘)。
    4. 终极方案：使用webdriver-manager，一劳永逸。

问题2：selenium.common.exceptions.SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version XX

  • 现象：脚本之前能运行，某天突然报这个错。
  • 原因：Chrome浏览器自动升级了，但ChromeDriver没有随之更新，导致版本不匹配。
  • 解决方案：
    1. 查看当前Chrome版本（chrome://version）。
    2. 下载与该版本号主版本一致的ChromeDriver，替换旧的驱动文件。
    3. 或者，直接使用webdriver-manager，它会自动处理版本匹配。

5.2 浏览器启动与页面加载问题

问题3：浏览器闪退或打不开

  • 现象：运行脚本后，浏览器窗口一闪而过，或者根本没打开就报错了。
  • 原因：
    • 驱动版本严重不匹配。
    • 浏览器安装损坏或存在多个冲突版本。
    • 杀毒软件或防火墙拦截。
  • 解决方案：
    1. 首先确保使用的是webdriver-manager。
    2. 尝试以管理员身份运行你的IDE或命令行。
    3. 临时关闭杀毒软件或防火墙试试。
    4. 检查任务管理器，是否有残留的chrome.exe或chromedriver.exe进程，强制结束它们再试。

问题4：元素找不到（NoSuchElementException）

  • 现象：脚本在执行到find_element时抛出异常，提示找不到元素。
  • 原因：这是UI自动化中最常见的问题。
    1. 页面未加载完成：代码执行太快，元素还没渲染出来就去定位了。
    2. 定位方式错误：使用的定位器（如ID、XPath）写错了，或者该元素属性是动态生成的。
    3. 元素在iframe/frame内：目标元素嵌套在<iframe>标签内，需要先切换上下文。
    4. 元素在新窗口/标签页：点击某个链接后打开了新窗口，需要先切换窗口句柄。
  • 解决方案：
    1. 增加等待：不要只用time.sleep。学习使用显式等待（WebDriverWait），这是解决此类问题的标准做法。它会在指定时间内不断尝试查找元素，直到找到或超时。
      from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC # 等待最多10秒，直到ID为‘kw‘的元素出现 element = WebDriverWait(driver, 10).until( EC.presence_of_element_located((By.ID, “kw“)) ) element.send_keys(“Selenium“)
    2. 检查定位器：使用浏览器的开发者工具（F12 -> Elements），仔细检查元素的属性。优先使用稳定的属性，如id、name。如果都没有，再考虑使用XPath或CSS Selector。
    3. 处理iframe：如果元素在iframe里，必须先切换到该iframe。
      # 通过iframe的id或index切换 driver.switch_to.frame(“iframe_id“) # 操作iframe内的元素... # 操作完成后切换回主文档 driver.switch_to.default_content()
    4. 处理新窗口：获取所有窗口句柄并切换。
      # 点击打开新窗口的链接 driver.find_element(By.LINK_TEXT, “新窗口“).click() # 获取所有窗口句柄 all_handles = driver.window_handles # 切换到新窗口（最后一个通常是新打开的） driver.switch_to.window(all_handles[-1]) # 在新窗口操作...

5.3 环境与依赖问题

问题5：ModuleNotFoundError: No module named ‘selenium‘

  • 现象：运行脚本时提示找不到selenium模块。
  • 原因：Selenium库没有安装，或者安装在了另一个Python环境下（比如你系统有多个Python）。
  • 解决方案：
    1. 确认你运行脚本时使用的Python环境，和用pip install selenium安装时的是同一个。在命令行中，where python（Windows）或which python（Mac/Linux）可以查看当前使用的Python路径。
    2. 在当前的Python环境下重新安装：pip install selenium。
    3. 如果你使用PyCharm等IDE，检查项目的Python解释器设置是否正确。

问题6：脚本在无头模式下运行失败或有差异

  • 现象：在普通模式下运行正常的脚本，开启--headless后失败，或者页面截图显示异常。
  • 原因：无头模式下的浏览器环境（如窗口大小、用户代理、某些特性支持）与有界面模式可能存在细微差异。
  • 解决方案：
    1. 设置窗口大小：在无头模式下，默认的窗口大小可能较小，导致某些响应式布局的元素不可见。添加参数--window-size=1920,1080。
    2. 添加用户代理：有些网站会检测无头浏览器。可以添加一个常见的用户代理字符串来伪装：chrome_options.add_argument(‘user-agent=Mozilla/5.0 ...‘)。
    3. 调试：在关键步骤添加页面截图driver.save_screenshot(‘debug.png‘)，查看无头模式下的页面状态，与有界面模式对比。

环境搭建是自动化测试的第一步，也是最容易让人沮丧的一步，因为任何一个环节的小问题都可能导致失败。但请相信，一旦你成功跨过这个门槛，后面编写自动化脚本、设计测试用例的乐趣和成就感会远远超过这点前期的麻烦。记住核心要点：Python环境装好、浏览器驱动版本匹配、使用WebDriver Manager省心、遇到元素找不到优先考虑显式等待。把这些基础打牢，你已经为成为一名高效的UI自动化测试工程师迈出了最坚实的一步。下一篇教程，我们将深入Selenium的核心——元素定位，这是你与网页进行一切交互的基础。

http://www.gsyq.cn/news/1551078.html

相关文章：

  • TWR-WIFI-AR4100评估板硬件手册深度解析与嵌入式Wi-Fi集成实战
  • Gemini Ultra技术解析：统一多模态、确定性推理与云边端协同架构
  • 构建可复现的GPU大模型训练机：A100+EPYC分布式基础设施实践
  • 国产化环境下的kkFileView实战指南：ARM架构文件预览服务部署与优化
  • 终极指南：如何在Windows 10上免费安装Windows Subsystem for Android
  • Microchip 93系列EEPROM选型指南：从命名规则到实战应用
  • OpCore Simplify：3个关键步骤让黑苹果配置从复杂变简单
  • 三相升流与单相逐相测试的差异
  • Microchip EERAM安全操作指南：规避数据损坏与状态机陷阱
  • MCP6H系列低功耗精密运放：选型、电路设计与实战应用
  • 155、平台 Camera 性能剖析工具：Systrace、Perfetto、Snapdragon Profiler 的使用
  • TWiLight Menu++：在任天堂掌机上体验终极复古游戏合集
  • MPC509外部总线接口：嵌入式系统数据高速公路的时序与配置详解
  • AI六类偏见实战防御指南：从历史到评估的系统性避坑
  • 终极USB设备安全弹出方案：告别Windows“设备正在使用中“困扰
  • 25AA256与25LC256 SPI EEPROM选型、驱动开发与生产导入全指南
  • 基于CPLD寄存器映射的多DSP系统管理与Verilog实现详解
  • Python进化算法终极指南：Geatpy如何让复杂优化问题变得简单？
  • 宁波江北AI推广公司评测：核心实力与服务适配性对比 - 起跑123
  • MSC8101PFC开发板硬件设计解析：多DSP+FPGA架构的电信级语音处理方案
  • 嵌入式开发如何高效利用Microchip技术支持网络：从资源矩阵到实战指南
  • 橙色手册：LLM Agent 循环工程的完整实践指南
  • 国内正规口碑GEO服务商技术实力对比与选择指南 - 起跑123
  • Anthropic 的FABLE5到底有什么魅力？为什么这么强？
  • 物流AI落地实操：从调度优化到异常干预的工程化路径
  • 监管合规MLOps：高风险AI交付的可追溯性与模型锁定实践
  • LSTM股价方向预测实战：从数据清洗到事件驱动回测
  • Python长时序植被遥感动态分析、物候提取、时空变异归因及RSEI生态评估
  • 2026银川黄金回收乱象解析 靠谱门店推荐 - 余生黄金回收
  • AlbionOnline-StatisticsAnalysis实战指南：数据驱动决策的效率提升方案