Python Selenium脚本报Options无add_experimental_option属性

• Python 3.10
• selenium==4.3.0
• Windows 10

编写基于Chrome的Selenium自动化脚本，配置启动参数时调用add_experimental_option方法，终端执行完整脚本抛出如下异常：

chrome_profile_path : C:\Users\gauth\AppData\Local\Google\Chrome\User Data
You don't have Chrome browser installed on your computer or we di'nt find your profile folder! : 'Options' object has no attribute 'add_experimental_option'

在同终端打开Python交互式环境，逐行执行Options初始化、调用add_experimental_option的相同逻辑代码，无任何报错。

核心配置代码片段如下：

chrome_options = Options()

chrome_options.add_argument(r"--user-data-dir=" + chrome_profile_path)
chrome_options.add_argument("--disable-extensions")

chrome_options.add_argument("--disable-application-cache")
chrome_options.add_argument("--disable-session-crashed-bubble")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-dev-shm-usage")
chrome_options.add_argument("--start-maximized")

chrome_options.add_experimental_option("excludeSwitches", ["enable-automation"])
chrome_options.add_experimental_option('useAutomationExtension', False)

Selenium 4.3.0版本的Chrome Options类原生自带add_experimental_option方法，结合交互式环境同版本可正常运行的现象，可直接排除Selenium版本兼容问题。
报错的核心原因是：脚本运行时实例化的Options对象，并非来自selenium.webdriver.chrome.options的官方Chrome配置类，是错误加载了其他来源的同名Options类导致的，常见触发场景有三类：

1. 本地文件遮蔽：脚本所在同级目录下存在命名为selenium.py、options.py、chrome.py的自定义文件，Python导入模块时优先检索当前工作目录，会直接加载本地同名文件，覆盖官方Selenium库的对应类。
2. 导入冲突：脚本开头没有写明确的全路径导入，用了from xx import *的模糊导入方式，把其他模块（比如其他浏览器驱动、第三方库）里的同名Options类导入到了当前命名空间。
3. 命名覆盖：脚本中在实例化Options之前，手动定义了名为Options的变量、函数或类，把导入的官方Chrome Options类覆盖了。

交互式环境运行正常，是因为交互式执行时明确写了全路径导入，没有上述三类冲突问题。

按以下步骤逐一排查即可解决：

• 修正导入语句：脚本开头必须和交互式环境的导入保持一致，写全导入路径，禁止模糊导入：

  from selenium.webdriver.chrome.options import Options
  

• 清理本地冲突文件：检查脚本所在目录，把命名为selenium.py、options.py、chrome.py的自定义文件重命名为其他不冲突的名字，删除目录下的__pycache__缓存文件夹，消除本地文件遮蔽问题。
• 检查命名冲突：通读脚本全文，确认chrome_options = Options()代码行之前，没有定义过名为Options的变量、函数、类，避免类定义被覆盖。
• 校验加载来源：可在实例化Options后加一行调试代码，打印当前加载的Options类所属模块，确认加载正确：

  chrome_options = Options()
  print(Options.__module__)
  # 正常输出应为 selenium.webdriver.chrome.options，如果输出其他内容，顺着模块路径排查错误来源即可
  

额外兼容提示：Selenium 4.x版本中直接给webdriver.Chrome()传驱动路径的写法已经废弃，建议改成Service对象传参的标准写法，避免后续版本升级报错：

from selenium.webdriver.chrome.service import Service
# 原驱动初始化代码替换为以下写法
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()), options=chrome_options)

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