简介这份整合包面向使用 Python 做 Selenium 自动化开发的工程师与学习者核心解决浏览器与驱动版本不匹配、项目打包后环境依赖缺失等常见痛点。包内固定为 Chrome 105.0.5195.102 稳定版并配套同版本 chromedriver.exe 与 chrome_proxy.exe解压后可直接将整个目录放入项目通过相对路径引入即可启动浏览器省去逐台机器匹配驱动的麻烦。资源共 103 个文件以 58 个 pak 资源包、12 个 dll 动态库、8 个 exe 可执行文件为主另含 json 配置、png 图标、sig 签名及 bdic 词典等组件压缩包约 152.05MB属于完整可移植的浏览器运行环境。目前已有 729 人学习下载。对于需要将自动化脚本打包分发、或在离线环境中稳定运行 Selenium 的场景这份整合包能显著降低环境配置成本并附带可直接套用的引入示例帮助开发者快速完成驱动初始化与项目集成。1. 版本对齐这件事比装驱动本身更折腾做 Web 自动化的都遇到过这种场景脚本昨天还跑得好好的今天一执行就抛SessionNotCreatedException提示This version of ChromeDriver only supports Chrome version XX。翻回去看Chrome 在后台悄悄升了个小版本而 Chromedriver 还停在旧版两边对不上整个自动化链路直接断掉。这不是代码写错了是版本匹配的问题。这份「谷歌浏览器对应版本驱动整合包」解决的正是这个痛点把特定版本的 Chrome 安装包和与之严格对应的 Chromedriver 打包在一起省去你到处翻版本对照表、逐个下载再试错的环节。它适合用 Python Selenium 做网页自动化、数据采集、UI 回归测试的从业者也适合刚接触 Selenium 却被环境配置卡住的新手。核心逻辑就一句话——Chrome 主版本号必须和 Chromedriver 主版本号一致差一个数字都不行。2. 版本匹配的底层逻辑与整合包拆解2.1 为什么 Chromedriver 对版本这么敏感Chromedriver 本质是一个中间层它通过 Chrome 的 DevTools Protocol 与浏览器通信。Selenium 发指令给 ChromedriverChromedriver 再翻译成 Chrome 能理解的协议命令。这个协议在不同 Chrome 版本间会有增删改所以 Chromedriver 必须和 Chrome 的接口定义严格对齐。主版本号比如 120、121代表协议大版本主版本不一致时协议对不上连接直接失败。次版本号比如 120.0.6099 里的 6099通常不影响兼容性但主版本必须一致。常见做法是先确认本机 Chrome 版本再去 Chromedriver 下载页找对应主版本。但 Chrome 自动更新很频繁手动跟版本容易翻车。整合包的价值就在于把「确认版本 → 下载 Chrome → 下载对应驱动 → 配置路径」这条链路固化下来你拿到的是一个已经对齐好的组合。2.2 整合包里有什么怎么确认版本一个合格的整合包通常包含Chrome 离线安装包.exe或.deb/.rpm、对应版本的 Chromedriver 可执行文件、以及一份版本说明。拿到之后第一件事不是急着装而是确认三者的版本关系。# 查看已安装 Chrome 的版本Windows 在命令行执行 wmic datafile where nameC:\\Program Files\\Google\\Chrome\\Application\\chrome.exe get Version /value # macOS 查看方式 /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version # 查看 Chromedriver 版本 chromedriver --version上面三条命令分别对应 Windows、macOS 和驱动自身的版本查询。Windows 那条走的是 WMI 查询路径要按实际安装位置改macOS 直接调 Chrome 二进制带--version参数chromedriver --version输出里会同时显示驱动版本和它支持的 Chrome 主版本。三个结果的主版本号必须一致比如都是 120才算对齐。提示如果整合包里的 Chrome 是离线安装包装之前先卸载系统里已有的 Chrome否则可能出现新旧版本共存、Selenium 调起的不是你预期那个版本的情况。2.3 把驱动放进 PATH 还是显式指定Chromedriver 的调用有两种方式放进系统 PATH 让 Selenium 自动找或者在代码里显式指定路径。前者省事但容易和系统里其他版本的驱动冲突后者更可控我一般推荐显式指定。from selenium import webdriver from selenium.webdriver.chrome.service import Service # 显式指定整合包里的 chromedriver 路径 driver_path rD:\chrome_bundle\chromedriver.exe service Service(executable_pathdriver_path) # 如果整合包里的 Chrome 不是系统默认安装位置也要指定 binary_location options webdriver.ChromeOptions() options.binary_location rD:\chrome_bundle\chrome\chrome.exe driver webdriver.Chrome(serviceservice, optionsoptions) driver.get(https://www.example.com) print(driver.title) driver.quit()这段代码的关键在Service和binary_location两个参数。executable_path指向整合包里的 Chromedriver确保用的是对齐版本binary_location指向整合包里的 Chrome避免 Selenium 去调系统里那个已经自动升级过的 Chrome。两个都指定才能真正锁死版本。如果只指定驱动不指定 Chrome 路径Selenium 默认找系统 Chrome版本一样会对不上。3. Selenium 环境搭建与首个自动化脚本跑通3.1 Python 环境与依赖安装整合包解决的是浏览器和驱动Python 侧的 Selenium 库还得自己装。建议用虚拟环境隔离避免和系统里其他项目的 Selenium 版本打架。# 创建虚拟环境 python -m venv venv # 激活Windows venv\Scripts\activate # 激活macOS/Linux source venv/bin/activate # 安装 selenium指定一个稳定版本 pip install selenium4.16.0这里指定selenium4.16.0是因为 Selenium 4.x 早期版本和某些 Chromedriver 的接口有细微差异4.16 之后Service对象的用法趋于稳定。不指定版本的话 pip 会拉最新版可能引入你没预期的行为变化。虚拟环境激活后命令行前面会有(venv)标识确认在环境里再装。3.2 用整合包跑通第一个页面环境齐了之后写一个最小可运行脚本验证整条链路。这个脚本做三件事启动浏览器、打开页面、取标题。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 service Service(executable_pathrD:\chrome_bundle\chromedriver.exe) options webdriver.ChromeOptions() options.binary_location rD:\chrome_bundle\chrome\chrome.exe # 无头模式调试阶段建议先注释掉方便看浏览器实际行为 # options.add_argument(--headlessnew) driver webdriver.Chrome(serviceservice, optionsoptions) try: driver.get(https://www.example.com) # 显式等待比 time.sleep 靠谱 WebDriverWait(driver, 10).until( EC.presence_of_element_located((By.TAG_NAME, h1)) ) print(页面标题:, driver.title) finally: driver.quit()WebDriverWait配合expected_conditions是等待元素出现的标准写法比time.sleep强在它会轮询检查元素一出现就继续不用死等固定秒数。presence_of_element_located只判断元素在 DOM 里存在如果要等元素可点击换成element_to_be_clickable。finally里driver.quit()保证异常时也能关掉浏览器进程不然跑几次就一堆僵尸进程占内存。3.3 验证版本是否真正对齐脚本跑通不代表版本就锁死了还得确认 Selenium 实际调起的是哪个版本。可以在脚本里加一段读取浏览器版本信息的逻辑。# 通过 CDP 获取浏览器版本 caps driver.capabilities print(浏览器版本:, caps.get(browserVersion)) print(驱动版本:, caps.get(chrome, {}).get(chromedriverVersion))driver.capabilities返回的是会话建立时协商的能力集里面browserVersion是实际启动的 Chrome 版本chromedriverVersion是驱动版本。两个打印出来主版本号一致说明整合包生效了。如果browserVersion显示的是系统里那个自动升级过的版本说明binary_location没生效检查路径是否写对、文件是否存在。4. 避坑版本漂移、路径与权限的常见翻车4.1 Chrome 自动更新把版本顶掉现象整合包装好用了几天突然脚本报SessionNotCreatedException提示驱动只支持旧版本。原因Chrome 默认开启自动更新后台把整合包里的 Chrome 升到了新主版本而 Chromedriver 没跟着换。解决关掉 Chrome 自动更新或者用binary_location锁死整合包里的 Chrome 路径同时确保那个 Chrome 不被更新机制碰到。Windows 下可以禁用 Google 更新服务macOS 下可以改 Chrome 的更新检查频率。4.2 驱动路径含空格或中文导致启动失败现象Service(executable_path...)报文件找不到但路径明明是对的。原因路径里有空格或中文字符某些 Selenium 版本对executable_path的处理不够健壮。解决把整合包解压到纯英文、无空格的路径下比如D:\chrome_bundle\别放在「我的文档」「桌面」这类带中文的目录里。4.3 多版本 Chrome 共存时调错浏览器现象脚本启动的浏览器界面和你手动打开的不一样或者某些扩展没加载。原因系统里装了多个 ChromeSelenium 默认调的是注册表里登记的那个不一定是你整合包里的。解决始终在options.binary_location里显式指定整合包 Chrome 的完整路径不要依赖默认查找。可以用driver.capabilities[browserVersion]确认实际调起的版本。4.4 无头模式下元素定位失败现象有头模式能跑通切到--headlessnew后元素找不到。原因无头模式下视口尺寸默认较小某些响应式页面会渲染出不同的 DOM 结构或者元素被判定为不可见。解决无头模式下手动设置窗口尺寸options.add_argument(--window-size1920,1080)并优先用presence_of_element_located而非visibility_of_element_located减少对渲染状态的依赖。4.5 驱动权限不足无法执行现象Linux/macOS 下报Permission denied。原因下载的 Chromedriver 没有可执行权限。解决chmod x chromedriver给执行权限。Windows 下一般不会有这个问题但如果驱动被杀毒软件拦截需要加白名单。5. 进阶把整合包封装成可复用的驱动工厂5.1 用工厂函数统一管理驱动创建每次写脚本都重复Serviceoptions那一坨太啰嗦封装成一个工厂函数把路径和常用参数集中管理。import os from selenium import webdriver from selenium.webdriver.chrome.service import Service BUNDLE_DIR os.environ.get(CHROME_BUNDLE, rD:\chrome_bundle) def create_driver(headlessFalse, download_dirNone): 从整合包创建 Chrome 驱动实例 service Service(executable_pathos.path.join(BUNDLE_DIR, chromedriver.exe)) options webdriver.ChromeOptions() options.binary_location os.path.join(BUNDLE_DIR, chrome, chrome.exe) if headless: options.add_argument(--headlessnew) options.add_argument(--window-size1920,1080) # 禁用「Chrome 正受到自动测试软件的控制」提示条 options.add_experimental_option(excludeSwitches, [enable-automation]) options.add_experimental_option(useAutomationExtension, False) if download_dir: prefs {download.default_directory: download_dir} options.add_experimental_option(prefs, prefs) driver webdriver.Chrome(serviceservice, optionsoptions) driver.set_page_load_timeout(30) return driver这个工厂函数把路径通过环境变量CHROME_BUNDLE暴露出来换机器时不用改代码设个环境变量就行。excludeSwitches那两行去掉自动化提示条某些需要登录的站点对自动化标识敏感去掉能减少被风控的概率。download_dir参数控制下载目录做文件采集时很有用。set_page_load_timeout(30)防止页面卡死导致脚本无限等待。5.2 版本自检与降级策略整合包用久了总会遇到版本漂移加一个启动前自检版本不对时给出明确提示而不是抛一堆看不懂的异常。def check_version_compatibility(driver): 检查浏览器与驱动主版本是否一致 caps driver.capabilities browser_ver caps.get(browserVersion, ).split(.)[0] driver_ver caps.get(chrome, {}).get(chromedriverVersion, ).split(.)[0] if browser_ver ! driver_ver: raise RuntimeError( f版本不匹配: Chrome {browser_ver} vs Driver {driver_ver} f请检查整合包是否被自动更新覆盖 ) return True这个自检放在create_driver之后调用主版本不一致直接抛带明确信息的异常比等 Selenium 自己报错再排查快得多。实际项目里我会把它挂在测试套件的 setup 阶段每次跑用例前先过一遍版本漂移当场暴露。5.3 一个容易忽略的细节驱动进程残留Selenium 脚本异常退出时Chromedriver 进程可能没被回收积累多了会占端口和内存。除了finally里driver.quit()还可以在工厂函数里注册退出钩子。import atexit def create_driver_safe(**kwargs): driver create_driver(**kwargs) atexit.register(lambda: driver.quit() if driver.session_id else None) return driveratexit在 Python 进程正常退出时触发driver.session_id判断会话是否还活着活着才 quit避免重复关闭报错。这招在长时间运行的采集任务里特别管用血泪经验是——不加这个跑一晚上第二天发现机器上挂了上百个 chromedriver 进程。从那以后我每次拿到新的整合包第一件事就是跑一遍版本自检脚本确认 Chrome 和 Chromedriver 主版本对齐、binary_location生效、无头模式能正常定位元素三关过了才往项目里接。这套流程帮我省掉了大量「昨天还好好的今天怎么就挂了」的排查时间。希望帮到你。本文还有配套的精品资源点击获取