如何在Windows系统安装Firefox WebDriver适配Selenium/Python

你遇到的'geckodriver' executable needs to be in PATH错误，核心原因是系统找不到Firefox对应的WebDriver程序——geckodriver，光装Selenium和Firefox浏览器还不够，必须搭配这个驱动才能让Selenium控制Firefox。下面是详细的安装配置步骤：

一、下载匹配的geckodriver #

1. 先确认你的Firefox版本：打开Firefox，点击菜单 → 帮助 → 关于Firefox，查看当前浏览器版本。
2. 下载对应版本的geckodriver：选择和你的操作系统（Windows/macOS/Linux）、Firefox版本兼容的安装包（新版本geckodriver通常支持较新的Firefox版本，若不确定选最新版即可）。

二、解压并配置geckodriver #

下载完成后，解压压缩包，得到geckodriver可执行文件（Windows下是geckodriver.exe，macOS/Linux下是geckodriver），接下来有两种配置方式：

方式1：添加到系统PATH（全局可用） #

• Windows：把geckodriver.exe放到系统PATH包含的文件夹里，比如C:\Windows\System32，或者你的Python安装目录下的Scripts文件夹（比如C:\Users\Acer\AppData\Local\Programs\Python\Python37-32\Scripts）。
• macOS/Linux：把geckodriver移动到/usr/local/bin目录（需要终端执行sudo mv /path/to/geckodriver /usr/local/bin，输入密码确认）。

方式2：代码中直接指定路径（无需修改PATH） #

如果不想改动系统PATH，可以在代码里直接指定geckodriver的位置：

Selenium 3.x版本写法：

from selenium import webdriver

# Windows示例，注意路径用原始字符串（r开头）避免转义问题
driver = webdriver.Firefox(executable_path=r'C:\你的geckodriver路径\geckodriver.exe')
# macOS/Linux示例：
# driver = webdriver.Firefox(executable_path='/你的geckodriver路径/geckodriver')

driver.get("https://www.google.com")
content = driver.find_element_by_id("lga")
print(content)

Selenium 4.x版本推荐写法（使用Service类）：

from selenium import webdriver
from selenium.webdriver.firefox.service import Service

# Windows示例
service = Service(r'C:\你的geckodriver路径\geckodriver.exe')
# macOS/Linux示例：
# service = Service('/你的geckodriver路径/geckodriver')

driver = webdriver.Firefox(service=service)
driver.get("https://www.google.com")
content = driver.find_element_by_id("lga")
print(content)

三、验证配置 #

运行修改后的代码，如果Firefox浏览器能正常启动并打开Google页面，且没有报错，就说明geckodriver配置成功了。

额外注意事项 #

• 确保geckodriver和Firefox版本兼容，若出现新的报错，优先检查版本是否匹配。
• Windows用户避免把geckodriver放在包含中文、空格的路径下，防止程序识别失败。

内容的提问来源于stack exchange，提问作者ali filali