简介面向Python Selenium自动化开发者内置Chrome 105.0.5195.102稳定版浏览器及对应Chromedriver驱动免去逐版本匹配的麻烦。压缩包内包含完整的浏览器运行组件、chromedriver.exe与chrome_proxy.exe可直接将整个解压包放进项目目录借助Selenium的binary_location与ChromeService指定相对路径即可调用打包发布时无需额外安装浏览器。资源共103个文件涵盖pak界面资源、dll动态库、exe可执行程序、json配置等类型压缩包整体152.05MB目录结构清晰。已有729人学习下载适合快速搭建Web自动化环境、开展爬虫或UI测试的中级Python开发者尤其适用于需要将浏览器环境随项目一并交付的场景。1. 做Web自动化这么久为什么我最后选了整合包做Web自动化测试和网页数据采集的人几乎都经历过被ChromeDriver折磨的阶段。我自己最夸张的一次是在一个项目交付的前一天晚上因为Chrome自动更新导致驱动报废硬生生排查了几个小时。第二天痛定思痛把开发机上的Chrome和ChromeDriver全卸了直接换成了“绿色版Chrome 对应版本ChromeDriver 启动脚本”的整合包方案。从那以后环境问题出现的频率直线下降。所谓整合包就是把一个固定的Chrome浏览器版本、一个与它主版本匹配的ChromeDriver、一套用于启动和验证的脚本全部放在同一个目录里随项目走。用的时候不依赖系统已经安装的Chrome也不需要手动配置全局环境变量脚本启动时直接把路径传进去整套环境就算立起来了。为什么这么做因为Web自动化的底层逻辑其实很简单Selenium通过ChromeDriver这个桥梁去操纵Chrome浏览器。浏览器版本、驱动版本、Selenium版本这三个东西只要有一个变动脚本就可能瘫痪。把前两个固定在整合包里等于把最大的不确定因素直接锁死。这套方案适合三类人刚入门、还不知道驱动和浏览器版本要匹配的新手在受控环境下做自动化测试、需要保证结果可复现的工程师以及经常在多台电脑之间切换、不想每台机子都折腾一遍环境的开发者。2. 版本对应关系是整合包的核心2.1 版本匹配的规则其实很简单ChromeDriver和Chrome的版本匹配网上讨论很多但核心原则一句话就能讲清楚主版本号必须一致。Chrome的版本号是121.0.6167.85这样的四段式ChromeDriver版本号也是类似结构。两者匹配只需要看最前面的121只要这个数字一致小版本略有差异一般都能正常运转。反过来主版本相差1就会出现兼容性问题。举个例子你的浏览器是Chrome 121.0.6167.85那么可以用ChromeDriver 121.0.6167.184也可以用121.0.6167.109。但如果装上ChromeDriver 120.0.6099.5Selenium启动时就会明确拒绝工作。为了防止大家搞混我把典型的对应关系列成一张表Chrome主版本ChromeDriver建议版本是否可用120.x120.0.6099.x系列正常121.x121.0.6167.x系列正常121.x120.0.6099.x系列启动即报错119.x121.0.6167.x系列大概率报错最后两行是大家最容易踩的误区。不少人有“驱动越新越好”的想法实际上ChromeDriver对旧版浏览器的向下兼容能力非常有限最高效的做法是反转视角先看浏览器主版本再按主版本去匹配驱动。2.2 报错长什么样怎么看懂它版本不匹配时最容易看见的报错是这个selenium.common.exceptions.SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version 120 Current browser version is 121.0.6167.85 with binary path C:\Program Files\Google\Chrome\Application\chrome.exe这段话翻译过来就是当前驱动只支持Chrome 120但检测到浏览器是121。报错里还直接给出了浏览器可执行文件的路径等于把原因和位置都告诉你了。很多人看到英文字母一多就开始重装浏览器其实完全没必要。你只需要做两件事一是确认本机浏览器的真实主版本二是下载对应的ChromeDriver替换掉旧驱动。这里也顺便提醒一句默认情况下Chrome会自动升级所以就算你今天把驱动配好了不代表明天它仍然有效。这也是我强烈建议在整合包里使用便携版Chrome的原因——浏览器版本一旦被项目文件夹锁住不再跟着系统自动更新走驱动才能长时间保持匹配。3. 从零做一套整合包选材、下载与目录设计3.1 便携版Chrome如何选型构建整合包的第一步是选定一个浏览器底座。我不推荐在整合包里用系统安装版的Chrome因为安装版很可能被自动更新改掉版本而且不同机器上的安装路径也不一样难以统一。更合理的做法是把Chrome的完整目录复制出来作为一个绿色便携版放在项目里。如果你之前已经在本机安装过Chrome可以直接到安装目录把整个文件复制出来典型的路径是C:\Program Files\Google\Chrome\Application。复制出来之后里面的chrome.exe就是可直接运行的主程序。但要注意复制出来的目录通常还保留着自动更新组件最稳妥的方式是把目录放到整合包后主动隔离那些与更新相关的内容同时后续手动使用--user-data-dir参数指定独立的用户数据目录避免和系统Chrome共用配置文件。这样做的本质就是让这个浏览器版本“固定住”不被系统策略和更新任务打扰。3.2 驱动去哪里下载、如何判断ChromeDriver的下载渠道优先认准官方来源。旧版本驱动和历史版本在chromedriver.storage.googleapis.com的索引下可以找到新版本则主要使用googlechromelabs.github.io/chrome-for-testing/这个页面。我个人的习惯是先去确认自己Chrome的主版本比如125再去上述页面寻找125.0.x对应条目选择匹配Windows平台的文件下载。下载之后建议立刻把它重命名并归档到整合包里。比如统一放在chromedriver/目录保持chromedriver.exe这个基础名称方便脚本引用。如果你遇到下载慢或者网络不通的情况也可以借助一些技术社区镜像但无论从哪个渠道下载都要在解压后用chromedriver --version命令看一眼版本号确认和预期一致避免拿到一个被改动过的东西。3.3 目录结构先定好一套清爽的整合包目录结构往往是这样的chrome-driver-bundle/ ├── chrome/ │ └── Application/ │ └── chrome.exe ├── chromedriver/ │ ├── chromedriver.exe │ └── version.txt ├── scripts/ │ ├── start_automation.py │ └── verify_env.py ├── userdata/ │ └── default_profile/ └── README.txtchrome/存放浏览器本体chromedriver/存放驱动和版本记录文件scripts/放自动化脚本userdata/是独立的浏览器用户数据目录。这个设计最大的好处是各司其职所有内容都在项目内部闭环。别人拿到这个包不需要额外安装任何东西最多装一个Python依赖就能跑。4. 写脚本、做验证让整合包真正可用4.1 核心启动脚本有了目录结构接下来写核心启动脚本。我用Python加Selenium演示这也是最常见的自动化组合。脚本的关键点在于两个指定浏览器可执行文件路径指定驱动路径。因为整合包的位置不固定所以路径要用相对脚本文件的动态计算不能用死路径。import os from selenium import webdriver from selenium.webdriver.chrome.options import Options from selenium.webdriver.chrome.service import Service BASE_DIR os.path.dirname(os.path.abspath(__file__)) PROJECT_DIR os.path.dirname(BASE_DIR) CHROME_PATH os.path.join(PROJECT_DIR, chrome, Application, chrome.exe) DRIVER_PATH os.path.join(PROJECT_DIR, chromedriver, chromedriver.exe) USER_DATA_DIR os.path.join(PROJECT_DIR, userdata, default_profile) options Options() options.binary_location CHROME_PATH options.add_argument(f--user-data-dir{USER_DATA_DIR}) options.add_argument(--no-sandbox) options.add_argument(--disable-gpu) options.add_argument(--window-size1920,1080) service Service(DRIVER_PATH) driver webdriver.Chrome(serviceservice, optionsoptions) driver.get(https://example.com) print(页面标题, driver.title) driver.quit()上面这段脚本里最核心的几行就是binary_location、user-data-dir和Service(DRIVER_PATH)。binary_location告诉Selenium用整合包里的Chrome而不是系统装的Chromeuser-data-dir让浏览器使用独立的配置文件目录不会把整合包里这套环境的登录状态和系统Chrome混淆Service则把驱动路径直接传给WebDriver。4.2 用一段验证脚本检查环境整合包做完之后不能直接丢给使用者必须自己先验证一遍。验证分两步第一步确认驱动文件本身能被识别命令是chromedriver --version正常会输出类似ChromeDriver 121.0.6167.184的提示第二步跑一个最小化的启动脚本看浏览器能不能真的被驱动起来。我在实际项目中习惯再加一个verify_env.py用来快速检查几个关键条件。这些条件分别是Chrome主程序是否存在、ChromeDriver是否存在、驱动版本与浏览器主版本是否一致、以及Selenium版本是否合适。脚本输出一目了然别人拿到整合包后可以先跑它环境有问题会在早期暴露出来而不是等到正式脚本运行到一半才报错。这个小小的验证脚本帮我省掉了很多低效的排查时间。4.3 打包与分发最后一步是把整个目录打成压缩包。压缩时注意保留目录层级不要把所有文件平铺在压缩包根目录否则使用者解压后会很难受。把README说明放在最外层里面写清楚Python版本要求、依赖安装命令、启动步骤和常见问题。这样整个整合包才算完整交付。5. 真实环境中遇到的坑与排查方法5.1 高频报错速查表把常见报错和解决办法整理成下表基本覆盖了绝大多数情况现象常见原因解决办法SessionNotCreatedExceptionChromeDriver与Chrome主版本不匹配换成一致主版本的ChromeDriverunknown error: cannot find Chrome binary未配置binary_location在Options中设置浏览器路径DevToolsActivePort file doesnt exist用户数据目录被占用或权限不足换一个独立的user-data-dir加--no-sandboxchromedriver.exe已停止工作驱动与系统位数不匹配或目录不存在确认是64位驱动路径避免中文和空格脚本提示找不到webdriver相关模块Selenium版本过旧升级到Selenium 4以上并适配新API5.2 三个容易忽略的细节第一别让系统Chrome“抢跑”。即使你在脚本里指定了整合包里的Chrome有些机器上还是可能因为环境变量干扰导致Selenium用了系统Chrome所以写脚本时最好显式检查driver的能力信息里的浏览器版本跟预期版本比对一下。第二目录里不要出现中文和空格。ChromeDriver对带空格和中文的路径在不同环境下表现很不稳定尤其跨平台到Linux下更敏感。整合包放在纯英文路径下是最省心的选择。第三Selenium 4的API发生了变化。如果你在网上复制的是老代码比如webdriver.Chrome(executable_path...)这种写法在Selenium 4里已经不能用了会直接报TypeError。建议统一使用Service对象传入驱动路径这也是上面脚本里采用的方式。6. 再分享一条最实在的经验我用这套整合包方案已经两年多最大的体会是它并不炫技但确实能消除真实的烦躁感。以前每次换电脑光是下载对应版本的ChromeDriver就要折腾半小时现在整个目录一拷就能进入工作状态。说到具体建议我强烈建议你在整合包里做一个version.txt文件把当前使用的浏览器主版本、驱动版本、Selenium版本、Python版本都记录下来。不要觉得多余——半年之后再打开这个整合包你可能完全不记得当时的版本组合有这个文件就能快速定位问题。另外如果你平时还要维护其他工具链也可以把这个思路推广出去凡是涉及版本绑定的组件尽量做成自包含目录不要依赖全局环境。一次搭好长期受益。本文还有配套的精品资源点击获取 
长河君 · 2026/9/7 6:21:55 · 阅读 1.2k Web自动化整合包：ChromeDriver版本匹配与便携环境搭建
简介面向Python Selenium自动化开发者内置Chrome 105.0.5195.102稳定版浏览器及对应Chromedriver驱动免去逐版本匹配的麻烦。压缩包内包含完整的浏览器运行组件、chromedriver.exe与chrome_proxy.exe可直接将整个解压包放进项目目录借助Selenium的binary_location与ChromeService指定相对路径即可调用打包发布时无需额外安装浏览器。资源共103个文件涵盖pak界面资源、dll动态库、exe可执行程序、json配置等类型压缩包整体152.05MB目录结构清晰。已有729人学习下载适合快速搭建Web自动化环境、开展爬虫或UI测试的中级Python开发者尤其适用于需要将浏览器环境随项目一并交付的场景。1. 做Web自动化这么久为什么我最后选了整合包做Web自动化测试和网页数据采集的人几乎都经历过被ChromeDriver折磨的阶段。我自己最夸张的一次是在一个项目交付的前一天晚上因为Chrome自动更新导致驱动报废硬生生排查了几个小时。第二天痛定思痛把开发机上的Chrome和ChromeDriver全卸了直接换成了“绿色版Chrome 对应版本ChromeDriver 启动脚本”的整合包方案。从那以后环境问题出现的频率直线下降。所谓整合包就是把一个固定的Chrome浏览器版本、一个与它主版本匹配的ChromeDriver、一套用于启动和验证的脚本全部放在同一个目录里随项目走。用的时候不依赖系统已经安装的Chrome也不需要手动配置全局环境变量脚本启动时直接把路径传进去整套环境就算立起来了。为什么这么做因为Web自动化的底层逻辑其实很简单Selenium通过ChromeDriver这个桥梁去操纵Chrome浏览器。浏览器版本、驱动版本、Selenium版本这三个东西只要有一个变动脚本就可能瘫痪。把前两个固定在整合包里等于把最大的不确定因素直接锁死。这套方案适合三类人刚入门、还不知道驱动和浏览器版本要匹配的新手在受控环境下做自动化测试、需要保证结果可复现的工程师以及经常在多台电脑之间切换、不想每台机子都折腾一遍环境的开发者。2. 版本对应关系是整合包的核心2.1 版本匹配的规则其实很简单ChromeDriver和Chrome的版本匹配网上讨论很多但核心原则一句话就能讲清楚主版本号必须一致。Chrome的版本号是121.0.6167.85这样的四段式ChromeDriver版本号也是类似结构。两者匹配只需要看最前面的121只要这个数字一致小版本略有差异一般都能正常运转。反过来主版本相差1就会出现兼容性问题。举个例子你的浏览器是Chrome 121.0.6167.85那么可以用ChromeDriver 121.0.6167.184也可以用121.0.6167.109。但如果装上ChromeDriver 120.0.6099.5Selenium启动时就会明确拒绝工作。为了防止大家搞混我把典型的对应关系列成一张表Chrome主版本ChromeDriver建议版本是否可用120.x120.0.6099.x系列正常121.x121.0.6167.x系列正常121.x120.0.6099.x系列启动即报错119.x121.0.6167.x系列大概率报错最后两行是大家最容易踩的误区。不少人有“驱动越新越好”的想法实际上ChromeDriver对旧版浏览器的向下兼容能力非常有限最高效的做法是反转视角先看浏览器主版本再按主版本去匹配驱动。2.2 报错长什么样怎么看懂它版本不匹配时最容易看见的报错是这个selenium.common.exceptions.SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version 120 Current browser version is 121.0.6167.85 with binary path C:\Program Files\Google\Chrome\Application\chrome.exe这段话翻译过来就是当前驱动只支持Chrome 120但检测到浏览器是121。报错里还直接给出了浏览器可执行文件的路径等于把原因和位置都告诉你了。很多人看到英文字母一多就开始重装浏览器其实完全没必要。你只需要做两件事一是确认本机浏览器的真实主版本二是下载对应的ChromeDriver替换掉旧驱动。这里也顺便提醒一句默认情况下Chrome会自动升级所以就算你今天把驱动配好了不代表明天它仍然有效。这也是我强烈建议在整合包里使用便携版Chrome的原因——浏览器版本一旦被项目文件夹锁住不再跟着系统自动更新走驱动才能长时间保持匹配。3. 从零做一套整合包选材、下载与目录设计3.1 便携版Chrome如何选型构建整合包的第一步是选定一个浏览器底座。我不推荐在整合包里用系统安装版的Chrome因为安装版很可能被自动更新改掉版本而且不同机器上的安装路径也不一样难以统一。更合理的做法是把Chrome的完整目录复制出来作为一个绿色便携版放在项目里。如果你之前已经在本机安装过Chrome可以直接到安装目录把整个文件复制出来典型的路径是C:\Program Files\Google\Chrome\Application。复制出来之后里面的chrome.exe就是可直接运行的主程序。但要注意复制出来的目录通常还保留着自动更新组件最稳妥的方式是把目录放到整合包后主动隔离那些与更新相关的内容同时后续手动使用--user-data-dir参数指定独立的用户数据目录避免和系统Chrome共用配置文件。这样做的本质就是让这个浏览器版本“固定住”不被系统策略和更新任务打扰。3.2 驱动去哪里下载、如何判断ChromeDriver的下载渠道优先认准官方来源。旧版本驱动和历史版本在chromedriver.storage.googleapis.com的索引下可以找到新版本则主要使用googlechromelabs.github.io/chrome-for-testing/这个页面。我个人的习惯是先去确认自己Chrome的主版本比如125再去上述页面寻找125.0.x对应条目选择匹配Windows平台的文件下载。下载之后建议立刻把它重命名并归档到整合包里。比如统一放在chromedriver/目录保持chromedriver.exe这个基础名称方便脚本引用。如果你遇到下载慢或者网络不通的情况也可以借助一些技术社区镜像但无论从哪个渠道下载都要在解压后用chromedriver --version命令看一眼版本号确认和预期一致避免拿到一个被改动过的东西。3.3 目录结构先定好一套清爽的整合包目录结构往往是这样的chrome-driver-bundle/ ├── chrome/ │ └── Application/ │ └── chrome.exe ├── chromedriver/ │ ├── chromedriver.exe │ └── version.txt ├── scripts/ │ ├── start_automation.py │ └── verify_env.py ├── userdata/ │ └── default_profile/ └── README.txtchrome/存放浏览器本体chromedriver/存放驱动和版本记录文件scripts/放自动化脚本userdata/是独立的浏览器用户数据目录。这个设计最大的好处是各司其职所有内容都在项目内部闭环。别人拿到这个包不需要额外安装任何东西最多装一个Python依赖就能跑。4. 写脚本、做验证让整合包真正可用4.1 核心启动脚本有了目录结构接下来写核心启动脚本。我用Python加Selenium演示这也是最常见的自动化组合。脚本的关键点在于两个指定浏览器可执行文件路径指定驱动路径。因为整合包的位置不固定所以路径要用相对脚本文件的动态计算不能用死路径。import os from selenium import webdriver from selenium.webdriver.chrome.options import Options from selenium.webdriver.chrome.service import Service BASE_DIR os.path.dirname(os.path.abspath(__file__)) PROJECT_DIR os.path.dirname(BASE_DIR) CHROME_PATH os.path.join(PROJECT_DIR, chrome, Application, chrome.exe) DRIVER_PATH os.path.join(PROJECT_DIR, chromedriver, chromedriver.exe) USER_DATA_DIR os.path.join(PROJECT_DIR, userdata, default_profile) options Options() options.binary_location CHROME_PATH options.add_argument(f--user-data-dir{USER_DATA_DIR}) options.add_argument(--no-sandbox) options.add_argument(--disable-gpu) options.add_argument(--window-size1920,1080) service Service(DRIVER_PATH) driver webdriver.Chrome(serviceservice, optionsoptions) driver.get(https://example.com) print(页面标题, driver.title) driver.quit()上面这段脚本里最核心的几行就是binary_location、user-data-dir和Service(DRIVER_PATH)。binary_location告诉Selenium用整合包里的Chrome而不是系统装的Chromeuser-data-dir让浏览器使用独立的配置文件目录不会把整合包里这套环境的登录状态和系统Chrome混淆Service则把驱动路径直接传给WebDriver。4.2 用一段验证脚本检查环境整合包做完之后不能直接丢给使用者必须自己先验证一遍。验证分两步第一步确认驱动文件本身能被识别命令是chromedriver --version正常会输出类似ChromeDriver 121.0.6167.184的提示第二步跑一个最小化的启动脚本看浏览器能不能真的被驱动起来。我在实际项目中习惯再加一个verify_env.py用来快速检查几个关键条件。这些条件分别是Chrome主程序是否存在、ChromeDriver是否存在、驱动版本与浏览器主版本是否一致、以及Selenium版本是否合适。脚本输出一目了然别人拿到整合包后可以先跑它环境有问题会在早期暴露出来而不是等到正式脚本运行到一半才报错。这个小小的验证脚本帮我省掉了很多低效的排查时间。4.3 打包与分发最后一步是把整个目录打成压缩包。压缩时注意保留目录层级不要把所有文件平铺在压缩包根目录否则使用者解压后会很难受。把README说明放在最外层里面写清楚Python版本要求、依赖安装命令、启动步骤和常见问题。这样整个整合包才算完整交付。5. 真实环境中遇到的坑与排查方法5.1 高频报错速查表把常见报错和解决办法整理成下表基本覆盖了绝大多数情况现象常见原因解决办法SessionNotCreatedExceptionChromeDriver与Chrome主版本不匹配换成一致主版本的ChromeDriverunknown error: cannot find Chrome binary未配置binary_location在Options中设置浏览器路径DevToolsActivePort file doesnt exist用户数据目录被占用或权限不足换一个独立的user-data-dir加--no-sandboxchromedriver.exe已停止工作驱动与系统位数不匹配或目录不存在确认是64位驱动路径避免中文和空格脚本提示找不到webdriver相关模块Selenium版本过旧升级到Selenium 4以上并适配新API5.2 三个容易忽略的细节第一别让系统Chrome“抢跑”。即使你在脚本里指定了整合包里的Chrome有些机器上还是可能因为环境变量干扰导致Selenium用了系统Chrome所以写脚本时最好显式检查driver的能力信息里的浏览器版本跟预期版本比对一下。第二目录里不要出现中文和空格。ChromeDriver对带空格和中文的路径在不同环境下表现很不稳定尤其跨平台到Linux下更敏感。整合包放在纯英文路径下是最省心的选择。第三Selenium 4的API发生了变化。如果你在网上复制的是老代码比如webdriver.Chrome(executable_path...)这种写法在Selenium 4里已经不能用了会直接报TypeError。建议统一使用Service对象传入驱动路径这也是上面脚本里采用的方式。6. 再分享一条最实在的经验我用这套整合包方案已经两年多最大的体会是它并不炫技但确实能消除真实的烦躁感。以前每次换电脑光是下载对应版本的ChromeDriver就要折腾半小时现在整个目录一拷就能进入工作状态。说到具体建议我强烈建议你在整合包里做一个version.txt文件把当前使用的浏览器主版本、驱动版本、Selenium版本、Python版本都记录下来。不要觉得多余——半年之后再打开这个整合包你可能完全不记得当时的版本组合有这个文件就能快速定位问题。另外如果你平时还要维护其他工具链也可以把这个思路推广出去凡是涉及版本绑定的组件尽量做成自包含目录不要依赖全局环境。一次搭好长期受益。本文还有配套的精品资源点击获取