使用Selenium禁用Firefox浏览器的下载弹窗

嘿，我刚入门Selenium的时候也被这个下载弹窗搞得头大！别担心，Firefox的配置其实就差几个关键参数没设置对，我把亲测有效的完整步骤分享给你：

核心配置思路 #

Firefox需要通过自定义配置文件（Profile）来禁用下载弹窗、指定保存路径，关键是要设置对MIME类型和几个核心偏好项。

完整代码示例 #

from selenium import webdriver
from selenium.webdriver.firefox.options import Options
from selenium.webdriver.firefox.service import Service
import os

# 1. 指定你要保存文件的目标文件夹
download_dir = r"C:\Your\Target\Folder\Path"  # Windows用原始字符串避免转义问题，Mac/Linux直接写"/your/path"

# 2. 创建Firefox配置对象
firefox_profile = webdriver.FirefoxProfile()

# 3. 设置关键偏好
# 指定下载路径
firefox_profile.set_preference("browser.download.dir", download_dir)
# 设置为自定义文件夹模式（0=桌面，1=默认下载文件夹，2=自定义）
firefox_profile.set_preference("browser.download.folderList", 2)
# 禁止弹窗询问保存位置
firefox_profile.set_preference("browser.download.useDownloadDir", True)
# 指定自动保存的MIME类型（CSV相关的都加上，避免识别遗漏）
firefox_profile.set_preference("browser.helperApps.neverAsk.saveToDisk", "text/csv,application/csv,text/comma-separated-values,application/vnd.ms-excel")
# 隐藏下载管理器窗口
firefox_profile.set_preference("browser.download.manager.showWhenStarting", False)
# 禁用PDF预览（如果下载的CSV被误识别为PDF的话可以加）
firefox_profile.set_preference("pdfjs.disabled", True)

# 4. 加载配置并启动浏览器
options = Options()
options.profile = firefox_profile

# 如果你用的是新版Selenium（4.x），需要指定GeckoDriver的路径
service = Service(executable_path=r"C:\Path\To\geckodriver.exe")
driver = webdriver.Firefox(service=service, options=options)

# 接下来就是你的脚本逻辑：打开网页、找到下载按钮点击
driver.get("你的目标网页URL")
download_button = driver.find_element("xpath", "//button[contains(text(), '下载CSV')]")  # 替换成你实际的元素定位
download_button.click()

# 最后记得关闭浏览器
# driver.quit()

常见坑点排查 #

• 路径问题：Windows系统的路径一定要用原始字符串（加r前缀）或者双反斜杠，不然会被转义导致路径无效；Mac/Linux直接用正斜杠即可。
• MIME类型不匹配：如果还是弹出弹窗，可能是网站返回的CSV文件MIME类型不在你设置的列表里。你可以打开浏览器开发者工具（F12），切换到「网络」标签，点击下载按钮后找到对应的请求，查看「响应头」里的Content-Type值，把它加到browser.helperApps.neverAsk.saveToDisk的列表里。
• Selenium版本兼容：确保你的Selenium版本（建议4.x以上）和GeckoDriver、Firefox版本匹配，版本不兼容也可能导致配置不生效。

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