Selenium运行报chromedriver executable needs to be in PATH错误如何解决?
报错原因分析
- 你所填写的chromedriver路径无效,没有指向实际存在的可执行文件
- chromedriver版本与本地安装的Chrome浏览器版本不兼容,无法被Selenium识别
- 若使用无参数的
webdriver.Chrome()调用方式,则是chromedriver未被添加到系统环境变量PATH中,系统无法定位该执行文件 - 你当前贴出的代码存在语法错误:路径字符串末尾缺少闭合的单引号,也会引发运行异常
解决步骤
方案1:手动指定驱动路径(无需修改环境变量,生效最快)
- 第一步:查看本地Chrome版本:打开Chrome浏览器 -> 点击右上角三点菜单 -> 设置 -> 关于Chrome,确认完整版本号(如119.0.6045.105)
- 第二步:下载对应版本的chromedriver,保存到本地任意目录(例如Windows存为
C:\tools\chromedriver.exe,Mac/Linux存为/home/yourname/tools/chromedriver) - 第三步:修正代码,替换为实际的驱动路径,示例如下:
from selenium import webdriver # Windows路径写法,注意转义反斜杠,或使用r标识原始字符串 driver = webdriver.Chrome(r'C:\tools\chromedriver.exe') # Mac/Linux路径写法 # driver = webdriver.Chrome('/home/yourname/tools/chromedriver')
方案2:使用内置驱动管理(Selenium 4.6+ 版本支持,无需手动下载驱动)
如果你的Selenium版本大于等于4.6,无需手动下载配置chromedriver,直接使用无参数调用即可,Selenium会自动匹配与本地Chrome版本适配的驱动,代码简化为:
from selenium import webdriver driver = webdriver.Chrome()
如果版本过低,可执行pip install --upgrade selenium升级到最新版本后使用该方案。
方案3:将chromedriver添加到系统环境变量
- Windows系统:右键「此电脑」-> 属性 -> 高级系统设置 -> 环境变量 -> 系统变量中找到Path -> 编辑 -> 新增chromedriver.exe所在的文件夹路径,保存后重启终端/编辑器生效
- Mac/Linux系统:将chromedriver移动到
/usr/local/bin目录,或在~/.bashrc(或~/.zshrc,取决于你使用的shell)中添加export PATH=$PATH:/path/to/chromedriver所在文件夹,保存后执行source ~/.bashrc(或对应配置文件)生效,后续可直接使用webdriver.Chrome()无参数调用。
注意事项
- Mac系统首次运行chromedriver可能会被系统安全拦截,可打开「系统设置 -> 隐私与安全性」,在安全性板块点击「仍要允许」即可正常运行
- 填写文件路径时,Windows下的反斜杠需要双写转义,或在字符串前加
r标识为原始字符串,避免转义字符导致路径识别错误
内容的提问来源于stack exchange,提问作者Reffert
相关产品推荐
相关产品推荐

