Windows x64 系统安装 ChromeDriver

Windows x64 系统安装 ChromeDriver在 Windows x64 系统上进行 Web 自动化开发时ChromeDriver 是不可或缺的核心组件。它作为 Selenium WebDriver 与 Chrome 浏览器之间的桥梁允许开发者通过代码控制浏览器的各种行为。本文将为你提供一份详尽、全面且易于操作的安装教程无论你是初学者还是有一定经验的开发者都能从中获得清晰的指引。第一部分理解 ChromeDriver 的作用与原理在正式安装之前我们有必要先理解 ChromeDriver 的基本概念。简单来说ChromeDriver 是一个实现了 WebDriver 协议的可执行文件它接收来自自动化脚本的指令如“打开某个网址”、“点击某个按钮”然后将这些指令翻译成 Chrome 浏览器能够理解的原生操作。Windows x64 系统是目前最常用的开发环境之一确保 ChromeDriver 在该平台上正确运行至关重要。常见的使用场景包括自动化测试 Web 应用程序爬取动态加载的网页数据执行重复性的浏览器操作任务监控网站性能或可用性理解了这些背景知识后接下来就进入正式的安装流程。第二部分安装前的准备工作2.1 确认操作系统版本虽然本教程针对 Windows x64但建议你再次确认系统类型右键点击“此电脑” → “属性”在“系统类型”一栏中确认显示为“64 位操作系统”2.2 检查 Chrome 浏览器版本最关键步骤ChromeDriver 与 Chrome 浏览器的主版本号必须严格匹配否则无法正常工作。操作步骤如下打开 Chrome 浏览器在地址栏输入chrome://version/并回车找到“Google Chrome”一行的完整版本号例如138.0.7204.36正式版本64 位记录主版本号即第一个数字例如138⚠️ 常见错误提醒很多初学者会忽略版本匹配的重要性下载了最新的 ChromeDriver 但 Chrome 浏览器版本较旧导致运行时出现“This version of ChromeDriver only supports Chrome version XX”的错误。务必避免这种情况。2.3 安装 Python 环境可选但推荐如果你需要使用 Python 调用 ChromeDriver请确保已安装 Python 3.7 及以上版本访问 python.org 下载 Windows x64 安装包安装时勾选“Add Python to PATH”在命令提示符中输入python --version验证安装成功2.4 安装 Selenium 库在命令行中执行以下命令pipinstallselenium建议同时升级 pip 本身python -m pip install --upgrade pip第三部分下载 ChromeDriver三种途径详解途径一官方主站推荐确保最新途径二Chrome for Testing 仓库Chrome 115 版本推荐途径三国内镜像站解决访问慢问题如果官方站点访问困难可以使用国内镜像访问 gitcode.com/FL1623863129/chromedriver_mirror/blob/main/README.md找到对应的版本号文件夹下载chromedriver_win64.zip提示建议同时下载一份notes.txt文件里面包含了该版本的发布时间和主要变更信息。第四部分安装与配置两种主流方法下载完成后解压 zip 包会得到一个chromedriver.exe文件。以下是两种安装策略你可以根据实际需求选择。方法一直接放在项目目录适合单项目或测试优点无需配置环境变量简单直接缺点每个项目都需要单独放置一份操作步骤在你的 Python 项目根目录下创建一个名为drivers或bin的文件夹可选将chromedriver.exe复制到该文件夹中在代码中通过相对路径引用方法二配置系统 PATH 环境变量一劳永逸此方法更适合长期开发可以让系统在任何位置找到 ChromeDriver。详细步骤创建固定存放目录建议在 C 盘根目录下创建webdrivers文件夹C:\webdrivers或放在用户目录下C:\Users\你的用户名\webdrivers移动 chromedriver.exe将解压后的chromedriver.exe复制到上述文件夹中打开环境变量设置右键点击“此电脑” → “属性”点击左侧“高级系统设置”点击右下角“环境变量”按钮编辑 PATH 变量在“系统变量”区域找到Path双击它点击右侧“新建”按钮输入你存放chromedriver.exe的文件夹路径例如C:\webdrivers确认路径末尾不要包含chromedriver.exe本身只需要目录路径保存并关闭依次点击“确定”关闭所有对话框验证配置打开一个新的命令提示符窗口重要必须新开窗口输入chromedriver --version如果显示版本信息说明配置成功⚠️ 注意事项必须重新启动命令提示符或 IDE 才能生效如果在 PowerShell 中运行可能需要先执行Set-ExecutionPolicy RemoteSigned管理员权限不要将chromedriver.exe放在系统受保护的目录如C:\Windows\System32第五部分编写验证代码现在我们来编写一段完整的 Python 代码测试 ChromeDriver 是否能正常工作。5.1 基础测试脚本fromseleniumimportwebdriverfromselenium.webdriver.chrome.serviceimportServicefromselenium.webdriver.common.byimportByfromselenium.webdriver.support.uiimportWebDriverWaitfromselenium.webdriver.supportimportexpected_conditionsasECimporttime# 方法A如果已将 chromedriver 配置到 PATHdriverwebdriver.Chrome()# 方法B如果只想指定特定路径取消注释下方代码注释上方代码# service Service(executable_pathrC:\webdrivers\chromedriver.exe)# driver webdriver.Chrome(serviceservice)try:# 打开百度首页driver.get(https://www.baidu.com)# 等待页面加载完成waitWebDriverWait(driver,10)search_boxwait.until(EC.presence_of_element_located((By.ID,kw)))# 在搜索框中输入关键词search_box.send_keys(ChromeDriver 安装教程)# 点击“百度一下”按钮search_buttondriver.find_element(By.ID,su)search_button.click()# 等待结果加载time.sleep(2)# 获取当前页面标题并打印print(f当前页面标题:{driver.title})print(测试成功ChromeDriver 工作正常。)exceptExceptionase:print(f发生错误:{e})finally:# 等待3秒后关闭浏览器time.sleep(3)driver.quit()5.2 使用无头模式Headless测试fromseleniumimportwebdriverfromselenium.webdriver.chrome.optionsimportOptions# 配置无头模式不显示浏览器界面chrome_optionsOptions()chrome_options.add_argument(--headless)chrome_options.add_argument(--no-sandbox)chrome_options.add_argument(--disable-dev-shm-usage)driverwebdriver.Chrome(optionschrome_options)driver.get(https://www.baidu.com)print(f无头模式 - 页面标题:{driver.title})driver.quit()第六部分常见错误及解决方案故障排除大全错误信息原因解决方案chromedriver executable needs to be in PATH系统找不到 chromedriver.exe1. 检查环境变量配置是否正确2. 重启命令行/IDE3. 使用代码直接指定路径This version of ChromeDriver only supports Chrome version XX版本不匹配重新下载与 Chrome 浏览器主版本号完全一致的 ChromeDriverWebDriverException: unknown error: DevToolsActivePort file doesnt existChrome 权限或沙箱问题添加参数options.add_argument(--no-sandbox)selenium.common.exceptions.SessionNotCreatedException驱动与浏览器版本严重不兼容同时更新 Chrome 浏览器和 ChromeDriver 到最新稳定版ConnectionResetError: [WinError 10054]网络波动或防火墙拦截检查防火墙设置或尝试使用无头模式程序运行后 Chrome 一闪而过缺少必要的运行库安装 Visual C Redistributable第七部分高级技巧与最佳实践7.1 自动匹配 ChromeDriver 版本推荐工具手动维护版本比较繁琐可以使用第三方库webdriver-manager自动处理pipinstallwebdriver-manager使用示例fromseleniumimportwebdriverfromwebdriver_manager.chromeimportChromeDriverManagerfromselenium.webdriver.chrome.serviceimportService serviceService(ChromeDriverManager().install())driverwebdriver.Chrome(serviceservice)该工具会自动检测当前 Chrome 版本并下载/缓存对应的 ChromeDriver。7.2 多版本 ChromeDriver 共存如果你需要测试不同版本的 Chrome可以将不同版本的chromedriver.exe分别命名为chromedriver_118.exe、chromedriver_120.exe等存放在同一个目录下在代码中指定具体文件名serviceService(executable_pathC:\\webdrivers\\chromedriver_118.exe)7.3 定期更新策略Chrome 浏览器会定期自动更新建议每隔2-4周检查一次 ChromeDriver 版本可以订阅 ChromeDriver 官方发布通知Google Groups在 CI/CD 流程中加入版本检查脚本7.4 性能优化建议复用浏览器实例不要频繁启动和关闭浏览器使用页面加载策略options.page_load_strategy eager禁用图片加载options.add_experimental_option(prefs, {profile.managed_default_content_settings.images: 2})第八部分总结与最终检查清单完成以上所有步骤后请对照以下清单进行最终确认✅ Chrome 浏览器版本已确认主版本号✅ ChromeDriver 版本与浏览器主版本号完全一致✅chromedriver.exe已解压并放置在正确位置✅ 系统 PATH 环境变量已正确配置或代码中已指定路径✅ Selenium 库已成功安装pip show selenium✅ 测试脚本能够正常运行并打开百度✅ 无错误提示浏览器能正常关闭如果你能顺利完成所有检查项那么恭喜你Windows x64 系统上的 ChromeDriver 环境已经完美搭建完成。现在你可以开始你的自动化之旅了——无论是编写爬虫、执行回归测试还是实现自动化办公ChromeDriver 都将成为你得力的工具。