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，但建议你再次确认系统类型：

1. 右键点击"此电脑" → "属性"
2. 在"系统类型"一栏中确认显示为"64 位操作系统"

2.2 检查 Chrome 浏览器版本（最关键步骤）

ChromeDriver 与 Chrome 浏览器的主版本号必须严格匹配，否则无法正常工作。操作步骤如下：

1. 打开 Chrome 浏览器
2. 在地址栏输入 chrome://version/ 并回车
3. 找到"Google Chrome"一行的完整版本号，例如 138.0.7204.36（正式版本）（64 位）
4. 记录主版本号 （即第一个数字，例如 138）

⚠️ 常见错误提醒：很多初学者会忽略版本匹配的重要性，下载了最新的 ChromeDriver 但 Chrome 浏览器版本较旧，导致运行时出现"This version of ChromeDriver only supports Chrome version XX"的错误。务必避免这种情况。

2.3 安装 Python 环境（可选但推荐）

如果你需要使用 Python 调用 ChromeDriver，请确保已安装 Python 3.7 及以上版本：

1. 访问 python.org 下载 Windows x64 安装包
2. 安装时勾选"Add Python to PATH"
3. 在命令提示符中输入 python --version 验证安装成功

2.4 安装 Selenium 库

在命令行中执行以下命令：

pip install selenium

建议同时升级 pip 本身：python -m pip install --upgrade pip

---

第三部分：下载 ChromeDriver（三种途径详解）

途径一：官方主站（推荐，确保最新）

途径二：Chrome for Testing 仓库（Chrome 115+ 版本推荐）

途径三：国内镜像站（解决访问慢问题）

如果官方站点访问困难，可以使用国内镜像：

1. 访问 gitcode.com/FL1623863129/chromedriver_mirror/blob/main/README.md
2. 找到对应的版本号文件夹
3. 下载 chromedriver_win64.zip

提示：建议同时下载一份 notes.txt 文件，里面包含了该版本的发布时间和主要变更信息。

---

第四部分：安装与配置（两种主流方法）

下载完成后，解压 zip 包会得到一个 chromedriver.exe 文件。以下是两种安装策略，你可以根据实际需求选择。

方法一：直接放在项目目录（适合单项目或测试）

• 优点：无需配置环境变量，简单直接
• 缺点：每个项目都需要单独放置一份
• 操作步骤：
  1. 在你的 Python 项目根目录下创建一个名为 drivers 或 bin 的文件夹（可选）
  2. 将 chromedriver.exe 复制到该文件夹中
  3. 在代码中通过相对路径引用

方法二：配置系统 PATH 环境变量（一劳永逸）

此方法更适合长期开发，可以让系统在任何位置找到 ChromeDriver。

详细步骤：

1. 创建固定存放目录

   • 建议在 C 盘根目录下创建 webdrivers 文件夹：C:\webdrivers
   • 或放在用户目录下：C:\Users\你的用户名\webdrivers

2. 移动 chromedriver.exe

   • 将解压后的 chromedriver.exe 复制到上述文件夹中

3. 打开环境变量设置

   • 右键点击"此电脑" → "属性"
   • 点击左侧"高级系统设置"
   • 点击右下角"环境变量"按钮

4. 编辑 PATH 变量

   • 在"系统变量"区域找到 Path，双击它
   • 点击右侧"新建"按钮
   • 输入你存放 chromedriver.exe 的文件夹路径（例如 C:\webdrivers）
   • 确认路径末尾不要 包含 chromedriver.exe 本身，只需要目录路径

5. 保存并关闭

   • 依次点击"确定"关闭所有对话框

6. 验证配置

   • 打开一个新的命令提示符窗口（重要：必须新开窗口）
   • 输入 chromedriver --version
   • 如果显示版本信息，说明配置成功

⚠️ 注意事项：

• 必须重新启动命令提示符或 IDE 才能生效
• 如果在 PowerShell 中运行，可能需要先执行 Set-ExecutionPolicy RemoteSigned（管理员权限）
• 不要将 chromedriver.exe 放在系统受保护的目录（如 C:\Windows\System32）

---

第五部分：编写验证代码

现在我们来编写一段完整的 Python 代码，测试 ChromeDriver 是否能正常工作。

5.1 基础测试脚本

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import time

# 方法A：如果已将 chromedriver 配置到 PATH
driver = webdriver.Chrome()

# 方法B：如果只想指定特定路径（取消注释下方代码，注释上方代码）
# service = Service(executable_path=r'C:\webdrivers\chromedriver.exe')
# driver = webdriver.Chrome(service=service)

try:
    # 打开百度首页
    driver.get("https://www.baidu.com")
    
    # 等待页面加载完成
    wait = WebDriverWait(driver, 10)
    search_box = wait.until(EC.presence_of_element_located((By.ID, "kw")))
    
    # 在搜索框中输入关键词
    search_box.send_keys("ChromeDriver 安装教程")
    
    # 点击"百度一下"按钮
    search_button = driver.find_element(By.ID, "su")
    search_button.click()
    
    # 等待结果加载
    time.sleep(2)
    
    # 获取当前页面标题并打印
    print(f"当前页面标题: {driver.title}")
    print("测试成功！ChromeDriver 工作正常。")
    
except Exception as e:
    print(f"发生错误: {e}")
    
finally:
    # 等待3秒后关闭浏览器
    time.sleep(3)
    driver.quit()

5.2 使用无头模式（Headless）测试

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

# 配置无头模式（不显示浏览器界面）
chrome_options = Options()
chrome_options.add_argument("--headless")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-dev-shm-usage")

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://www.baidu.com")
print(f"无头模式 - 页面标题: {driver.title}")
driver.quit()

---

第六部分：常见错误及解决方案（故障排除大全）

错误信息	原因	解决方案
'chromedriver' executable needs to be in PATH	系统找不到 chromedriver.exe	1. 检查环境变量配置是否正确；2. 重启命令行/IDE；3. 使用代码直接指定路径
This version of ChromeDriver only supports Chrome version XX	版本不匹配	重新下载与 Chrome 浏览器主版本号完全一致的 ChromeDriver
WebDriverException: unknown error: DevToolsActivePort file doesn't exist	Chrome 权限或沙箱问题	添加参数：options.add_argument('--no-sandbox')
selenium.common.exceptions.SessionNotCreatedException	驱动与浏览器版本严重不兼容	同时更新 Chrome 浏览器和 ChromeDriver 到最新稳定版
ConnectionResetError: [WinError 10054]	网络波动或防火墙拦截	检查防火墙设置，或尝试使用无头模式
程序运行后 Chrome 一闪而过	缺少必要的运行库	安装 Visual C++ Redistributable

---

第七部分：高级技巧与最佳实践

7.1 自动匹配 ChromeDriver 版本（推荐工具）

手动维护版本比较繁琐，可以使用第三方库 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)

该工具会自动检测当前 Chrome 版本，并下载/缓存对应的 ChromeDriver。

7.2 多版本 ChromeDriver 共存

如果你需要测试不同版本的 Chrome，可以：

• 将不同版本的 chromedriver.exe 分别命名为 chromedriver_118.exe、chromedriver_120.exe 等
• 存放在同一个目录下
• 在代码中指定具体文件名：

service = Service(executable_path='C:\\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 都将成为你得力的工具。