干这行时间长了会发现一个规律凡是标题里写“install chromiu”的提问基本都是在 Chromium 或者 Chrome 的环境里被 chromedriver 折腾得够呛。不管你是想跑 Selenium 脚本、写爬虫还是搭一套自动化回归测试开头绕不开的问题永远是同一个——chromedriver 装不对后面全白搭。这篇就是我在 Ubuntu 22.04/24.04 上安装最新版本 chromedriver 的完整记录包括版本怎么选、官方从哪里下、装完怎么验证、跑起来遇到的那些坑全是我踩过之后整理出来的。先给你一句话结论chromedriver 和浏览器是“严格同名”的关系大版本号必须完全一致。想装“最新版”第一件事不是冲进下载页找那个最大的版本号而是先看你机器上 Chrome 或 Chromium 的版本号。这篇我会把整个过程拆成五步从版本确认讲到驱动落地再讲到 Selenium 能不能真正连上保证你照着走一遍就能跑通。1. 先搞清楚版本号再说安装1.1 为什么版本号是“生死线”chromedriver 不是随便一个浏览器都能驱动的通用组件它是 Chrome 团队为每个 Chrome 版本配套发布的。说得形象一点Chrome 住在一栋楼里chromedriver 是拿着门禁卡的访客门禁卡上写着几号楼就只能进几号楼。主版本号对不上浏览器连个正常页面都不会给你打开。我从 Chrome 115 之后特别明显感觉到一个变化从那个版本起Chrome 和 chromedriver 的版本号彻底绑定比如 Chrome 154.0.6541.0 对应的就是 chromedriver 154.0.6541.0。大版本号154 这一位必须严格一致至于后面三位小版本号通常不影响匹配。真正的报错往往是这样的SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version 153 Current browser version is 154.0.6541.0 with binary path /usr/bin/google-chrome这句话已经写得非常直白了你的驱动只认识 153机器上装的浏览器却是 154。所以安装的第一步永远是查版本号而不是急着下载。我在帮同事排查问题时发现十次有八次都是这种“装了个最新驱动但浏览器不是最新”或反过来“浏览器升了级驱动忘了换”的情况。1.2 快速确认本机浏览器版本Ubuntu 上浏览器可能来自不同渠道确认命令也略有区别但核心思路一样找到浏览器可执行文件然后让它汇报自己的版本。如果你装的是谷歌 Chrome 官方版一般可以通过这两个命令which google-chrome google-chrome-stable chromium chromium-browser 2/dev/null google-chrome --version chromium --version我实际操作中多数 Ubuntu 桌面环境里 Google Chrome 的路径是/usr/bin/google-chrome而 Chromium 在旧版本上可能是/usr/bin/chromium-browser后来换成了/usr/bin/chromium。运行后输出大概是Google Chrome 154.0.6541.0 Chromium 154.0.6541.0这里你只需要盯住第一个数字。比如输出是 154.0.6541.0那需要的 chromedriver 就必须是 154 开头的同版本号。有的场景下which找不到命令但浏览器明明装了。别慌先在系统里搜一下二进制文件ls -l /opt/google/chrome/chrome ls -l /usr/bin/*chrom*Chrome 官方包默认装在/opt/google/chrome/这个路径下有个chrome文件也可以直接执行/opt/google/chrome/chrome --version1.3 snap 版 Chromium 的坑值得单列Ubuntu 上有个特别碍事的细节如果你用sudo apt install chromium-browser装 ChromiumUbuntu 会在背后给你换成 snap 版本具体表现就是/snap/bin/chromium这个路径。不少人装完发现自己根本找不到/usr/lib/chromium-browser/就是这个原因。snap 版的 Chromium 不是不能跑自动化但它有自己的沙箱限制文件访问、用户目录、进程权限都可能被卡Chromium 和 chromedriver 配合起来经常出现“明明二进制对得上就是 session 起不来”的怪问题。我的建议是别跟 snap 版 Chromium 较劲直接去下载 Chrome for Testing 全家桶或者用官方 Chrome 配官方 chromedriver。后面章节我会详细讲 Chrome for Testing这个方案能绕开 Ubuntu snap 带来的一堆麻烦。2. 拿驱动官方渠道与版本匹配技巧2.1 Chrome for Testing 下载地址规则搞清楚浏览器版本之后就可以去拿 chromedriver 了。如果你还在搜索引擎里翻第三方下载站听我一句劝直接用 Google 官方的 Chrome for Testing 下载体系。第三方的镜像可能版本不全、文件被改动过甚至还可能带点“私货”没必要冒这个险。Chrome 115 之后的官方下载规则非常固定格式就是一个 URLhttps://storage.googleapis.com/chrome-for-testing-public/{完整版本号}/linux64/chromedriver-linux64.zip注意花括号里不是只填主版本号而是完整的“154.0.6541.0”。这是新手最容易犯的错填个154就点下载结果要么 404要么被重定向到某个奇怪的页面。实际填法是https://storage.googleapis.com/chrome-for-testing-public/154.0.6541.0/linux64/chromedriver-linux64.zip如果你需要的是 Chrome for Testing 浏览器本体也一样有对应链接https://storage.googleapis.com/chrome-for-testing-public/{完整版本号}/linux64/chrome-linux64.zip这个下载体系里还有一个隐藏的便利它不仅提供最新稳定版还能下载历史版本只要你记得完整版本号。做自动化测试的人都很清楚这个用处——团队里有人用的浏览器版本和你不一样你完全可以把对应版本的 chromedriver 下下来不用折腾任何环境。2.2 用官方 JSON 端点自动匹配最新版本每次手动拼 URL 虽然不难但会烦。更聪明的做法是直接读取官方维护的 JSON 文件一次性拿到“当前最新稳定版”和“对应下载地址”。官方提供了一个固定 JSON 地址我一般用这个https://googlechromelabs.github.io/chrome-for-testing/LAST_KNOWN_GOOD_VERSIONS_WITH_DOWNLOADS.json打开之后内容大概长这样{ timestamp: 2025-..., channels: { Stable: { version: 154.0.6541.0, downloads: { chromedriver: [ { platform: linux64, url: https://storage.googleapis.com/chrome-for-testing-public/154.0.6541.0/linux64/chromedriver-linux64.zip } ], chrome: [ { platform: linux64, url: https://storage.googleapis.com/chrome-for-testing-public/154.0.6541.0/linux64/chrome-linux64.zip } ] } } } }我通常用一个小脚本把这套流程固化下来。前提是你机器上有curl和python3这两个东西在 Ubuntu 上基本默认都有JSON_URLhttps://googlechromelabs.github.io/chrome-for-testing/LAST_KNOWN_GOOD_VERSIONS_WITH_DOWNLOADS.json curl -s -L $JSON_URL -o /tmp/cf.json VERSION$(python3 -c import json data json.load(open(/tmp/cf.json)) print(data[channels][Stable][version]) ) DRIVER_URL$(python3 -c import json data json.load(open(/tmp/cf.json)) items data[channels][Stable][downloads][chromedriver] for item in items: if item[platform] linux64: print(item[url]) ) echo 版本号: $VERSION echo 下载地址: $DRIVER_URL你拿到的地址就是官方最新的 chromedriver 下载直链。好处很明显版本号和下载地址由官方动态给出永远正确尤其适合写进自动化脚本里反复执行。2.3 手动指定版本下载的正确姿势自动匹配脚本适合大多数场景但有些情况下你还是得手动指定版本比如你不想升级浏览器比如测试环境要求必须固定在某个旧版本。这时候老老实实拼 URL 就行。先确定两个信息完整版本号、系统架构。架构查询用uname -m如果输出是x86_64对应下载linux64如果输出是aarch64或者arm64要找linux-arm64这类平台标识。旧教程里常看到“linux64 就完事了”那是因为当时几乎全是 x86_64 机器现在 ARM 架构的 Ubuntu 也普及了这一步不能省。假设你要下载 154.0.6541.0 的驱动完整命令是cd /tmp curl -L -o chromedriver.zip https://storage.googleapis.com/chrome-for-testing-public/154.0.6541.0/linux64/chromedriver-linux64.zip unzip -q chromedriver.zip ls -l chromedriver-linux64/如果这一步遇到网络不通那多半是机器访问不了外网这个问题没有太好的通用答案你可以让同事把 zip 包拷贝过来或者让运维在内网搭建一个 Chrome 相关文件的镜像站。下载和校验这一步务必通过官方渠道完成别为了省事随便从某个博客挂的网盘里拿文件。3. 落地安装解压、权限、PATH3.1 三步把 chromedriver 放进系统下载完成后驱动其实还只是压缩包里的一个可执行文件真正要让它“可以被调用”得把它放到 PATH 环境变量覆盖的目录里并确保拥有执行权限。我的固定做法如下。第一步解压并找到二进制cd /tmp unzip -q chromedriver.zip cd chromedriver-linux64/ ls -l chromedriver压缩包解开后名字一般就是chromedriver没有扩展名。第二步把它移动到一个系统级目录比如/usr/local/binsudo mv chromedriver /usr/local/bin/为什么放在/usr/local/bin而不是/usr/bin因为 Ubuntu 的 PATH 环境变量默认包含/usr/local/bin而且这个目录本来就是给本地自行安装的软件准备的不会和 apt 管理的文件冲突。放到这里既安全又干净以后想卸载只需删掉一个文件。第三步给执行权限并验证sudo chmod 755 /usr/local/bin/chromedriver有人说要用777我明确不建议。系统级二进制只需要文件属主可写、所有用户可执行755才是合理模式。777意味着任何人都能修改这个文件一旦机器被多个人共用完全是给自己埋雷。3.2 权限和 PATH 的现场教学有没有遇到过这种情况明明文件就在/usr/local/bin下执行chromedriver --version却提示command not found这个问题的幕后黑手往往是 shell 的“命令路径缓存”。Shell 为了提高效率会把用过的命令路径缓存下来。你装完新驱动后如果之前恰好执行过带路径的旧版本新路径可能不会被立即识别。这时候敲一句hash -r强制刷新命令缓存基本上就能解决了。再不行就手动指定绝对路径试试/usr/local/bin/chromedriver --version另外如果你的系统里存在多个 chromedriver比如在虚拟环境、conda 环境或者~/.local/bin里也放了一个那就要注意 PATH 的优先级。用这个命令可以把所有同名的可执行文件都揪出来type -a chromedriver输出会按 PATH 顺序列出好几个路径谁排在最前面shell 用的就是谁。所以排查时别只“which 一下”就完事因为你看到的可能不是实际被调用的那个。3.3 验证“chromedriver --version”到底对不对装完之后第一件事不是立刻上 Selenium而是先手动跑一下驱动本身/usr/local/bin/chromedriver --version正常情况下会输出ChromeDriver 154.0.6541.0 (以下省略构建哈希值)看到这个结果只说明“驱动就位了”还不能说明“一定和浏览器匹配”。所以我通常会把浏览器版本再打出来对照一次google-chrome --version chromedriver --version两个输出的大版本号一致才敢放心去写 Selenium 代码。这一步花不了十秒钟却能把后续排查时间省下一大截。4. 连上 Selenium最小可用验证4.1 最小 Python 脚本跑通全程驱动装好了最终目标还是让 Selenium 能驱动浏览器干活。我一般先写一个最小脚本做冒烟测试不会一上来就写完整业务逻辑。假设你已经用 pip 装好了 seleniumpip install selenium然后创建一个最小的 Python 文件from selenium import webdriver from selenium.webdriver.chrome.service import Service service Service(/usr/local/bin/chromedriver) options webdriver.ChromeOptions() driver webdriver.Chrome(serviceservice, optionsoptions) try: driver.get(https://example.com) print(driver.title) finally: driver.quit()这里Service(/usr/local/bin/chromedriver)是显式告诉 Selenium 使用哪个驱动路径。Selenium 4 之后有个挺方便的东西叫 Selenium Manager它能自动去寻找合适的驱动但在你本地已经明确装了正确版本的驱动时显式指定路径更加可控也不会因为网络波动导致它临时去下载文件。执行脚本后如果正常打开了一个浏览器窗口并且控制台输出了页面的标题那就说明这个最小链路已经通了。剩下的事情就是在业务代码里加各种等待条件、选择器、断言逻辑。4.2 常用参数配置和调试情报跑容器、CI 或服务器场景时你没有图形界面可用就必须给 Chrome 开启 headless 模式。我常用的最小配置是这样的from selenium import webdriver from selenium.webdriver.chrome.service import Service options webdriver.ChromeOptions() options.add_argument(--headlessnew) options.add_argument(--no-sandbox) options.add_argument(--disable-dev-shm-usage) options.add_argument(--user-data-dir/tmp/chrome-test-profile) service Service(/usr/local/bin/chromedriver) driver webdriver.Chrome(serviceservice, optionsoptions) driver.get(https://example.com) print(driver.title) driver.quit()几个参数逐个说清楚--headlessnew新版无头模式比旧版更稳定大多数现代页面都能正常工作。--no-sandbox在 Docker 容器里经常需要因为容器内默认没有用户命名空间支持。但在自己电脑上不建议随手加这相当于关闭了一层浏览器安全防护。--disable-dev-shm-usage解决/dev/shm空间不足导致的崩溃Docker 环境里尤其常见。--user-data-dir指定一个独立的用户数据目录避免和其他 Chrome 实例冲突。如果浏览器没启动第一手情报就看控制台异常信息。Selenium 的报错通常很明确是“驱动版本不对”“找不到浏览器二进制”“连接超时”还是“沙箱权限不足”几乎都能从异常信息里直接读出来。4.3 改用 Chrome for Testing 完整包更省心如果你发现系统里的 Chrome 版本老在变、snap 版 Chromium 又动不动出幺蛾子我更推荐一个“釜底抽薪”的办法直接用 Chrome for Testing 完整包。做法是下载这一组文件https://storage.googleapis.com/chrome-for-testing-public/{完整版本号}/linux64/chrome-linux64.zip https://storage.googleapis.com/chrome-for-testing-public/{完整版本号}/linux64/chromedriver-linux64.zip把它们解压到固定目录比如/opt/chrome-for-testing/chrome-linux64/chrome /opt/chrome-for-testing/chromedriver-linux64/chromedriver然后在代码里同时指定 Chrome 可执行文件和驱动路径from selenium import webdriver from selenium.webdriver.chrome.service import Service options webdriver.ChromeOptions() options.binary_location /opt/chrome-for-testing/chrome-linux64/chrome service Service(/opt/chrome-for-testing/chromedriver-linux64/chromedriver) driver webdriver.Chrome(serviceservice, optionsoptions)这个方案的优点非常多浏览器和驱动来自同一个发布通道、版本天然一致不污染系统默认浏览器snap 沙箱彻底绕开升级时只需要重新解压替换目录。我自己现在维护自动化测试基本都会优先考虑这个方案而不是折腾系统里已经装好的 Chrome。5. 常见问题与排查技巧实录5.1 版本不匹配的报错长什么样最常见的报错我已经在开头举过例了再补充几个真实遇到的变体。一种是“This version of ChromeDriver only supports Chrome version xxx”这个最好懂就是驱动版本小于浏览器版本。另一种比较隐蔽unknown error: cannot find Chrome binary这句话不是说没装 Chrome而是 chromedriver 找不到 Chrome 的可执行文件。常见于 Ubuntu 上用 snap 装 Chromium或者 Chrome 路径不是标准位置。解决办法就是用前文提到的binary_location显式告诉它options.binary_location /usr/bin/google-chrome还有一种情况是“DevToolsActivePort file doesnt exist”看起来吓人很多时候是因为机器/tmp空间不足或者浏览器启动时崩溃。我一般建议先加--headlessnew和--disable-dev-shm-usage试试很多时候直接就解决了。5.2 权限问题被拒绝执行和“没有那个文件”权限相关的排查有个很实用的命令是ls -l。如果你解压出来的 chromedriver 没有执行权限运行时会直接提示Permission denied在 Unix 系统里一个文件即使内容是个程序没有“可执行”权限也启动不了。这跟 Windows 的.exe很不一样。解决办法就是补上权限chmod x /usr/local/bin/chromedriver还有一种“没有那个文件或目录”的情况bash: /usr/local/bin/chromedriver: No such file or directory文件明明存在却报“没有这个文件”大概率不是文件不存在而是动态链接库缺失。ubuntu 旧版本或者精简版系统上可能缺少如下几个库sudo apt update sudo apt install -y libnss3 libatk-bridge2.0-0 libcups2 libdrm2 \ libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \ libgbm1 libasound2装完之后再试一次很多时候就能跑了。5.3 浏览器找不到给 binary_location 定位我详细展开一下“cannot find Chrome binary”的排查流程。先搞清楚一个问题你系统里到底有没有 Chromels -l /usr/bin/google-chrome ls -l /usr/bin/chromium如果ls都没有输出那肯定没有。但如果你明明执行过google-chrome --version能出结果Selenium 却说找不到那就说明 Selenium 启动 Chrome 时用的路径和命令行里不一样。Selenium 默认会去固定的默认路径找比如/usr/bin/google-chrome或/usr/bin/chromium-browser如果你浏览器的实际路径是/opt/google/chrome/chrome它就会扑空。这时候的补救方法就是显式设置二进制路径options.binary_location /opt/google/chrome/chrome我甚至遇到过“默认 Chrome 是 snap 版实际路径每次还会随版本变化”的情况。这种场景别把时间花在适配 snap 上直接换 Chrome for Testing 全家桶最干净。5.4 下载慢和架构认错的避坑建议这部分整理几条下载和安装阶段的小技巧。第一下载地址中linux64并不是“Linux 的 64 位系统”的简称它是 Chrome 官方对“x86_64 Linux”这个平台标识。ARM 机器的 Ubuntu 要用linux-arm64。如果你发现下载回来的压缩包内文件无法执行用uname -m查一下架构多半就是这里错了。第二解压后务必查看文件的 owner。如果用sudo mv移动后的文件 owner 不属于当前用户在某些受限 shell 或 CI 环境里也会影响执行。一个稳妥的确认方式是ls -l /usr/local/bin/chromedriver如果 owner 不对再补一句sudo chown root:root /usr/local/bin/chromedriver。第三不要为了追求“最新版”去下载比浏览器大版本更新的驱动。我给一个原则以浏览器版本为准而不是以驱动为准。很多人喜欢打开下载页看最新版本号是多少就拿去装结果系统里的 Chrome 还停留在旧版完全对不上。其实只要大版本一致即使小版本不同工作中几乎不会感受到差别。第四建议把版本一致性检查写成一个脚本保存下来每次换环境、换机器都跑一遍CHROME_VERSION$(google-chrome --version | sed -n s/.* \([0-9]\\)\..*/\1/p) DRIVER_VERSION$(/usr/local/bin/chromedriver --version | sed -n s/.*\([0-9]\\)\..*/\1/p) echo Chrome: $CHROME_VERSION, Driver: $DRIVER_VERSION if [ $CHROME_VERSION $DRIVER_VERSION ]; then echo match else echo mismatch, please update fi这个小脚本我基本上每个自动化项目都要放一份省掉了大量“环境问题”排查时间。最后还是说点实际的感受。我见过太多人花了一两个小时跟 chromedriver 搏斗最后发现只是版本号差了一位。所以在 Ubuntu 上装最新版 chromedriver真正重要的不是“下载最新”而是“版本对齐 官方渠道 可执行权限”这三件事。把这三点理顺剩下的就是写你的自动化代码了。