news 2026/6/30 11:00:20

Selenium自动化测试入门：ChromeDriver配置全攻略与版本匹配详解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Selenium自动化测试入门：ChromeDriver配置全攻略与版本匹配详解

1. 项目概述：为什么ChromeDriver是Selenium的“启动钥匙”？

如果你正准备踏入自动化测试的大门，或者已经用Selenium写过几行代码，那么“ChromeDriver”这个词对你来说一定不陌生。它就像一个翻译官，一头连着你的Selenium脚本（用Python、Java等语言写的指令），另一头连着真实的Chrome浏览器。没有它，你的脚本就是一堆无法执行的字符，浏览器根本“听不懂”你在说什么。很多新手在兴致勃勃地安装好Selenium库后，第一个拦路虎往往就是ChromeDriver的配置报错，比如“WebDriverException: Message: ‘chromedriver’ executable needs to be in PATH”。这个指南的目的，就是帮你彻底跨过这第一步，在Windows和Mac两大主流系统上，把ChromeDriver这把“钥匙”稳稳地配好。

这个过程远不止是“下载一个文件”那么简单。它涉及到浏览器版本与驱动版本的严格匹配、系统环境变量的精准配置，以及不同操作系统下的路径管理逻辑。配置不当，轻则脚本无法运行，重则遇到各种诡异的浏览器行为，让你在调试脚本逻辑之前，先花上几个小时和驱动较劲。我见过太多团队，因为开发、测试人员的驱动环境不一致，导致同一份脚本在A的电脑上跑得飞起，在B的电脑上就原地崩溃。所以，把这第一步走扎实，是构建稳定、可复现的自动化测试环境的基础。无论你是想用Selenium做网页数据抓取、做日常的Web功能回归测试，还是为更复杂的测试框架铺路，搞定ChromeDriver都是无法绕开的必修课。

2. 核心思路拆解：版本匹配、路径管理与环境配置

在动手之前，我们必须先理清配置ChromeDriver的核心逻辑。整个过程可以归纳为三个环环相扣的关键步骤，理解它们能帮你避免90%的常见坑。

2.1 版本匹配：驱动与浏览器的“锁与钥匙”关系

这是最重要，也最容易出错的一步。ChromeDriver的版本必须与您系统上安装的Chrome浏览器主版本号完全一致。这里的“主版本号”指的是版本号最前面的数字，例如Chrome浏览器版本为124.0.6367.91，那么它的主版本号就是124。你必须寻找同样主版本号为124的ChromeDriver。

为什么这么严格？因为Chrome浏览器内部与驱动通信的协议（CDP，Chrome DevTools Protocol）会随着版本更新而发生变化。新版本的驱动了解新协议，能指挥新浏览器；如果你用旧版驱动去命令新版浏览器，或者反过来，两者就会因为“语言不通”而无法协作，直接抛出异常。

注意：Chrome的自动更新非常频繁。很可能你今天配好了，过几天Chrome自动升级了，驱动就又失效了。因此，养成“运行脚本前，先确认版本是否匹配”的习惯，或者编写自动检查版本的初始化脚本，是资深从业者的基本操作。

2.2 路径管理：系统如何找到你的“钥匙”

下载好正确版本的ChromeDriver（一个可执行文件，如chromedriver.exe或chromedriver）后，你需要告诉你的操作系统和Selenium脚本，去哪里找到这个文件。主要有两种方式：

  1. 添加到系统PATH环境变量：这是最一劳永逸的方法。将ChromeDriver所在的目录路径添加到系统的PATH变量中。这样，无论在命令行的任何位置，还是Selenium脚本中，系统都能自动搜索到这个可执行文件。这类似于你把一把万能钥匙挂在了全市所有警察都知道的钥匙串上，随时可用。
  2. 在代码中指定绝对路径：这种方法更直接，在初始化WebDriver时，通过代码明确指出驱动文件的完整路径。例如，在Python中：driver = webdriver.Chrome(executable_path=‘/你的路径/chromedriver’)。这种方式灵活性高，适合项目结构固定或需要隔离多版本驱动的场景，但缺点是路径硬编码，换台机器或移动了文件位置就需要修改代码。

对于新手，我强烈推荐第一种方法（配置PATH），因为它更符合“一次配置，处处运行”的预期，也减少了后续脚本编写的复杂度。

2.3 系统差异：Windows与Mac下的不同“战场”

Windows和Mac系统在文件系统、终端命令和环境变量设置界面上有显著不同。

  • 文件格式：Windows下是chromedriver.exe，Mac下是chromedriver（无扩展名）。
  • 权限问题：Mac/Linux系统下载后的驱动文件默认没有执行权限，必须通过终端命令chmod +x chromedriver赋予其可执行权限，这是一个经典的坑点。
  • 安装位置习惯：Windows用户习惯放在C:\Tools或用户目录下；Mac用户则常放在/usr/local/bin（需要管理员权限）或~/bin（用户目录下）这样的标准路径。选择一个合适的、有权限的、且便于管理的目录，是良好的开始。

理解了这三大核心思路，我们就可以进入实操环节了。下面的步骤将严格遵循这个逻辑展开。

3. 实操全流程：Windows系统配置详解

让我们先从Windows系统开始。请一步步跟随操作，并注意其中的细节。

3.1 第一步：确认Chrome浏览器版本

打开Chrome浏览器，点击右上角的三个点菜单，选择“帮助” -> “关于Google Chrome”。弹出的页面会显示当前版本号，例如“版本 124.0.6367.91（正式版本）”。请牢记主版本号124。

3.2 第二步：下载对应版本的ChromeDriver

  1. 访问ChromeDriver的官方下载站点。你可以通过搜索引擎查找“ChromeDriver Downloads”找到它，其域名通常包含“chromedriver.storage.googleapis.com”。这是最可靠的来源，避免从第三方网站下载可能被篡改的文件。
  2. 在网站列表中，找到与你的Chrome主版本号（如124）完全匹配的版本。如果列表中没有完全一致的124.x.x.x版本，就选择版本号最接近124但不超过124的最新版本（例如123.x.x.x）。切勿选择主版本号高于你浏览器的驱动。
  3. 根据你的系统类型下载。对于大多数现代Windows电脑，下载chromedriver_win32.zip即可，它兼容32位和64位系统。如果你的系统是ARM架构（如Surface Pro X），则需要下载chromedriver_win64.zip（注意查看压缩包内文件说明）。
  4. 下载完成后，你会得到一个ZIP压缩包（如chromedriver_win32.zip）。将其解压，里面只有一个文件：chromedriver.exe。这就是我们需要的驱动可执行文件。

3.3 第三步：规划与放置驱动文件

不要随意把chromedriver.exe放在桌面或下载文件夹。我建议在C盘根目录或你的用户目录下创建一个专门的工具文件夹，例如C:\AutomationTools。将解压出的chromedriver.exe移动到这个文件夹中。

这样做的好处是路径清晰、没有空格和中文（避免潜在编码问题），并且便于未来管理其他自动化工具。

3.4 第四步：将驱动路径添加到系统PATH环境变量

这是配置的核心环节，让系统能全局识别chromedriver命令。

  1. 在Windows搜索框输入“环境变量”，选择“编辑系统环境变量”。
  2. 在弹出的“系统属性”窗口中，点击右下角的“环境变量”按钮。
  3. 在下方的“系统变量”区域中，找到并选中名为Path的变量，点击“编辑”。
  4. 在弹出的“编辑环境变量”窗口中，点击“新建”，然后将你的驱动所在目录的完整路径（例如C:\AutomationTools）添加进去。
  5. 依次点击“确定”关闭所有窗口。

重要提示：添加PATH后，你需要关闭并重新打开所有正在使用的命令行窗口（如CMD、PowerShell、终端）或IDE（如PyCharm、VSCode）。因为新的环境变量只在新的会话中生效。

3.5 第五步：验证安装是否成功

  1. 打开一个新的命令行窗口（Win+R，输入cmd或powershell）。
  2. 输入命令chromedriver --version并回车。
  3. 如果配置成功，命令行会打印出ChromeDriver的版本信息，例如ChromeDriver 124.0.6367.91 (...)。这证明系统已经能够找到并执行这个驱动。
  4. 更进一步，你可以写一个最简单的Python脚本验证：
    from selenium import webdriver # 如果PATH配置正确，无需指定 executable_path driver = webdriver.Chrome() driver.get("https://www.baidu.com") print(driver.title) driver.quit()
    运行这个脚本，如果能自动打开Chrome浏览器并跳转到百度页面，随后打印出标题并关闭浏览器，那么恭喜你，Windows下的配置大功告成。

4. 实操全流程：macOS系统配置详解

macOS下的配置逻辑与Windows一致，但具体操作命令和权限处理有所不同。

4.1 第一步：确认Chrome浏览器版本

方法同Windows：打开Chrome -> 点击顶部菜单栏“Chrome” -> “关于Google Chrome”。记录主版本号。

4.2 第二步：下载与解压驱动文件

  1. 访问相同的ChromeDriver官方下载站点。
  2. 找到对应浏览器主版本的驱动，下载适用于macOS的版本，通常是chromedriver_mac64.zip（针对Intel芯片）或chromedriver_mac_arm64.zip（针对Apple Silicon M系列芯片）。请根据你的Mac电脑芯片类型选择正确版本。
  3. 下载的ZIP文件通常会在“下载”文件夹中。双击即可解压，得到一个名为chromedriver（没有扩展名）的文件。

4.3 第三步：处理文件权限与放置位置

这是Mac配置的关键区别点。

  1. 打开终端（Terminal），你可以通过聚焦搜索（Command+空格）输入“终端”找到它。
  2. 赋予执行权限：在终端中，首先进入下载目录，然后执行权限命令。
    cd ~/Downloads chmod +x chromedriver
    命令chmod +x的意思是给这个文件加上“可执行”的权限。没有这一步，系统会拒绝运行它，并可能报错“权限被拒绝”。
  3. 移动到标准路径：为了能在任何地方使用，最好将驱动移动到系统或用户的二进制文件目录。有两个常用选择：
    • 移动到/usr/local/bin（需要管理员权限，推荐）：
      sudo mv chromedriver /usr/local/bin/
      输入该命令后，系统会提示你输入电脑密码（输入时密码不可见），输入后回车即可。/usr/local/bin是macOS上存放用户安装程序的常用位置，已在系统的默认PATH中。
    • 移动到用户自定义目录（如~/bin）： 首先在用户主目录创建bin文件夹：mkdir ~/bin然后移动文件：mv ~/Downloads/chromedriver ~/bin/最后，需要将~/bin添加到你的PATH中（见下一步）。

4.4 第四步：配置Shell环境变量PATH（如果需要）

如果你选择了将驱动移动到~/bin或其他自定义目录，则需要将该目录添加到PATH。

  1. 确定你使用的Shell。新版macOS默认使用zsh，终端窗口标题或提示符通常能看出。你可以通过命令echo $SHELL确认，如果输出/bin/zsh就是zsh。
  2. 编辑Shell的配置文件。对于zsh，配置文件是~/.zshrc；对于较老系统可能用的bash，则是~/.bash_profile。
    # 使用nano编辑器打开配置文件（以zsh为例） nano ~/.zshrc
  3. 在文件末尾添加一行：
    export PATH="$HOME/bin:$PATH"
    这行代码的意思是将~/bin目录的路径添加到现有PATH变量的最前面。
  4. 按下Control + X退出nano，按Y确认保存，再按回车确认文件名。
  5. 让配置立即生效：执行source ~/.zshrc。

4.5 第五步：验证安装是否成功

  1. 打开一个新的终端窗口。
  2. 输入命令chromedriver --version。如果看到版本号输出，即表示成功。
  3. 同样，用一段简单的Python脚本进行终极测试：
    from selenium import webdriver driver = webdriver.Chrome() # 如果驱动在PATH中，无需指定路径 driver.get("https://www.google.com") print(driver.title) driver.quit()
    如果脚本能正常运行并打开浏览器，那么macOS下的配置也完成了。

5. 高级配置与最佳实践

完成基础安装后，为了应对更复杂的场景和提升稳定性，这里有一些进阶技巧。

5.1 使用WebDriver Manager自动化管理驱动

手动管理驱动版本确实繁琐。社区有一个非常优秀的Python库叫webdriver-manager，它可以自动检测你的浏览器版本，并下载、配置匹配的ChromeDriver，彻底解放双手。

安装命令：

pip install webdriver-manager

使用方式：

from selenium import webdriver from webdriver_manager.chrome import ChromeDriverManager from selenium.webdriver.chrome.service import Service # WebDriverManager会自动处理驱动的下载和路径 service = Service(ChromeDriverManager().install()) driver = webdriver.Chrome(service=service) driver.get("https://www.example.com") driver.quit()

实操心得：在团队协作或持续集成（CI/CD）环境中，强烈推荐使用webdriver-manager。它能确保每台构建机器或测试服务器上始终使用正确的驱动版本，避免了“在我机器上是好的”这类环境问题。不过，在离线环境或对网络有严格管控的内网中，仍需使用手动配置的方式。

5.2 将驱动集成到IDE或项目目录中

对于单个项目，有时你希望驱动文件就在项目里，便于版本控制和分发。

  • 方法一：项目内相对路径。在项目根目录下创建一个drivers文件夹，把chromedriver.exe或chromedriver放进去。然后在代码中指定相对路径：
    # Windows 示例 driver_path = './drivers/chromedriver.exe' # Mac 示例 driver_path = './drivers/chromedriver' driver = webdriver.Chrome(executable_path=driver_path)
  • 方法二：使用虚拟环境（venv）。在Python虚拟环境的bin(Mac/Linux) 或Scripts(Windows) 目录下放置驱动，这样当虚拟环境激活时，该目录通常在PATH中。

5.3 处理常见的权限与安全拦截问题

  • macOS“无法打开开发者”提示：首次运行从网络下载的chromedriver时，macOS可能会提示“无法打开‘chromedriver’，因为无法验证开发者”。你需要到“系统设置” -> “隐私与安全性”中，找到并点击“仍要打开”按钮。如果没看到提示，可以尝试在终端先直接运行一次chromedriver来触发这个安全对话框。
  • Windows Defender SmartScreen拦截：Windows也可能弹出“Windows已保护你的电脑”的提示。点击“更多信息”，然后选择“仍要运行”即可。
  • 公司安全软件：企业环境中的终端安全软件可能会将ChromeDriver误报为风险工具而隔离或删除。这就需要联系IT部门，将驱动文件或所在目录添加到安全软件的白名单中。

6. 核心问题排查与解决方案实录

即使按照步骤操作，你也可能会遇到一些问题。下面是我在实际工作中总结的常见问题及解决方法。

6.1 问题一：版本不匹配错误

错误信息：SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version XXCurrent browser version is YY...

原因与解决： 这是最经典的错误。驱动版本(XX)和浏览器版本(YY)不匹配。

  1. 立即检查：再次确认Chrome浏览器的准确版本。
  2. 重新下载：访问ChromeDriver官网，下载与浏览器主版本号完全一致的驱动。如果官网没有完全一致的，则下载版本号最接近但不超过浏览器版本的最新驱动。
  3. 更新浏览器：有时是因为浏览器太新，驱动还未发布。可以尝试将Chrome浏览器暂时回退到一个稍旧的稳定版本，或者等待一两天官方更新驱动。
  4. 使用WebDriver Manager：如前所述，让工具自动处理版本问题。

6.2 问题二：系统找不到指定的文件或命令

错误信息：WebDriverException: Message: ‘chromedriver’ executable needs to be in PATH.或者在终端中执行chromedriver --version提示command not found。

原因与解决： PATH环境变量配置不正确，或者驱动文件不在你指定的位置。

  1. 检查路径：在文件资源管理器或Finder中，确认chromedriver.exe或chromedriver文件确实在你认为的目录里。
  2. 验证PATH：
    • Windows：在CMD中运行echo %PATH%，查看输出的路径列表中是否包含你的驱动目录。
    • Mac：在终端中运行echo $PATH进行查看。
  3. 重启终端/IDE：确保是在配置完PATH后新打开的命令行窗口或IDE。
  4. 使用绝对路径：在代码中暂时使用文件的绝对路径来测试，以排除PATH问题。例如：webdriver.Chrome(executable_path=‘C:/AutomationTools/chromedriver.exe’)。

6.3 问题三：权限被拒绝（Permission Denied）

错误信息：WebDriverException: Message: ‘chromedriver’ may not have executable permissions.

原因与解决： 几乎专属于Mac/Linux系统。驱动文件缺少可执行权限。

  1. 打开终端，导航到驱动文件所在目录。
  2. 执行命令ls -l chromedriver，查看文件权限。如果开头没有-rwxr-xr-x（即包含x），则说明没有执行权限。
  3. 执行命令chmod +x chromedriver赋予权限。
  4. 再次运行ls -l chromedriver确认权限已更改。

6.4 问题四：驱动进程残留导致后续运行失败

场景描述： 脚本异常退出（如未执行driver.quit()）后，再次运行脚本时报错，提示端口已被占用或无法创建新会话。

原因与解决： ChromeDriver进程和对应的Chrome浏览器进程可能没有完全退出。

  1. 手动结束进程：
    • Windows：打开任务管理器（Ctrl+Shift+Esc），在“详细信息”或“进程”标签页中，找到所有chromedriver.exe和chrome.exe进程，结束它们。
    • Mac：打开“活动监视器”，在CPU或内存标签页中，找到chromedriver和Google Chrome进程，强制退出。
  2. 在代码中确保退出：使用try...finally块确保无论脚本是否出错，最后都会调用driver.quit()。
    driver = webdriver.Chrome() try: # 你的测试逻辑 driver.get("https://example.com") finally: driver.quit() # 确保浏览器被关闭

6.5 问题速查表

问题现象可能原因优先排查步骤
报错版本不支持驱动与浏览器版本不匹配1. 核对Chrome版本号
2. 下载对应主版本号驱动
‘chromedriver’ not foundPATH环境变量未配置或配置错误1. 检查文件是否存在
2. 在终端用绝对路径测试
3. 检查并重启终端
Permission denied (Mac)驱动文件无执行权限在终端执行chmod +x chromedriver
首次运行被系统拦截操作系统安全策略在系统安全设置中手动允许运行
端口占用/无法创建会话前次驱动进程未退出在任务管理器/活动监视器中结束相关进程
浏览器打开后立刻闪退驱动与浏览器严重不兼容1. 确认是否为ARM/M1 Mac下载了arm64版本
2. 尝试完全卸载重装Chrome

配置ChromeDriver的过程，本质上是在搭建一座连接你的自动化脚本与真实浏览器世界的桥梁。这座桥的稳固与否，直接决定了你后续自动化旅程的顺畅程度。花些时间理解原理、严格按照步骤操作、并熟悉常见问题的排查方法，这些投入在日后会以节省大量调试时间的形式回报给你。当你能在Windows和Mac上都能一键启动你的第一个Selenium脚本时，真正的自动化测试探索才刚刚开始。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/30 10:59:55

形象vi设计公司的服务内容、设计流程及选择要点有哪些

导语在当今竞争激烈的商业环境中，企业的形象VI设计至关重要。一个优秀的形象VI设计能帮助企业树立独特的品牌形象，增强市场竞争力。然而，很多企业对形象VI设计公司的服务内容、设计流程及选择要点并不清楚。相传国际作为专业的品牌设计机构&a…

作者头像 李华
网站建设 2026/6/30 10:56:07

如何实现应用级虚拟定位：FakeLocation终极使用指南

如何实现应用级虚拟定位：FakeLocation终极使用指南 【免费下载链接】FakeLocation Xposed module to mock locations per app. 项目地址: https://gitcode.com/gh_mirrors/fak/FakeLocation 你是否担心社交软件暴露真实位置？需要为不同应用设置独…

作者头像 李华
网站建设 2026/6/30 10:56:04

Python测试框架深度对比：pytest、unittest与nose的实战选型指南

1. 项目概述：为什么我们需要对比测试框架？在Python的自动化测试世界里，pytest、unittest、nose这几个名字你一定不陌生。作为一个写了十几年测试脚本的老兵，我见过太多团队在框架选型上反复纠结，也见过不少项目因为选错…

作者头像 李华
网站建设 2026/6/30 10:54:29

QLoRA实战：在消费级GPU上微调你的专属大模型

1. QLoRA技术入门：为什么它能让消费级GPU跑大模型？ 第一次听说QLoRA这个词时，我正对着显卡价格发愁。当时想微调个13B参数的模型，结果发现显存要求直接劝退。直到发现华盛顿大学这项黑科技，我的RTX 3090才真正发挥出实…

作者头像 李华
网站建设 2026/6/30 10:53:56

异时层之火：解析花咲(异时层妖刀)的ZONE构筑与红白珠战术体系

1. 火属性ZONE的核心机制解析 花咲（异时层妖刀）最标志性的能力就是展开火属性ZONE。这个机制看似简单，但实际包含多层战术价值。首先，ZONE状态下全队火属性攻击能获得50%的增伤效果，同时敌方火属性耐性会对应下降。这种…

作者头像 李华