chromedriver 启用 headless 模式失败，通常因参数版本不兼容导致；本文详解 `--headless=new` 与旧版 `--headless` 的适用场景、完整配置步骤及避坑要点。
在使用 Selenium + ChromeDriver 实现无头（headless）自动化时，若调用 options.add_argument("--headless=new") 后浏览器窗口仍弹出，说明该参数未被当前 Chrome/ChromeDriver 版本正确识别——这并非代码逻辑错误，而是版本兼容性问题。
✅ 正确配置 headless 模式的两种方式
方式一：兼容旧版 Chrome（v109 之前）
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
service = Service(executable_path=r".\chromedriver.exe") # 注意路径应为相对或绝对有效路径
options = Options()
options.add_argument("--headless") # 无 new 后缀，适用于 Chrome < v109
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")
driver = webdriver.Chrome(service=service, options=options)
print(driver.title) # 验证是否静默运行
driver.quit()方式二：启用新版 headless（Chrome v109+ 推荐）
options = Options()
options.add_argument("--headless=new") # 必须搭配 Chrome v109 及以上
options.add_argument("--no-sandbox")
options.add_argument("--disable-gpu") # Windows 下建议添加
options.add_argument("--disable-features=NetworkService") # 增强稳定性? 如何确认 Chrome 版本？ 在终端执行：chrome --version 或 google-chrome --version（Linux/macOS）； ChromeDriver 版本需与 Chrome 主版本号严格一致（如 Chrome 125.x → 需 ChromeDriver 125.x）。
⚠️ 关键注意事项
- 路径问题：executable_path 已在 Selenium 4.10+ 中弃用，推荐使用 Service 对象并确保 chromedriver 可执行权限（Windows 注意 .exe 后缀，Linux/macOS 需 chmod +x）；
- 安全参数必加：--no-sandbox 和 --disable-dev-shm-usage 在 headless 环境中不可或缺，否则易触发崩溃或超时；
- 调试技巧：临时移除 --headless* 参数可快速验证环境是否正常；也可添加 options.add_argument("--remote-debugging-port=9222") 配合 Chrome DevTools 调试；
- Docker/CI 场景：务必安装字体库（如 fonts-liberation）和音视频依赖，避免渲染异常。
✅ 验证是否真正 headless
运行后检查进程：
- Linux/macOS：ps aux | grep chrome | grep -v grep —— 不应出现 --headless 以外的 GUI 相关参数；
- Windows：任务管理器中查看 chrome.exe 进程属性，确认无窗口句柄（GetForegroundWindow() 返回 0）。
掌握版本匹配与最小化必要参数，即可稳定启用 headless 模式，大幅提升 CI/CD 流水线与服务器端自动化效率。
