Pylint与Pylance对Selenium Chrome类误报不可调用错误的原因排查

DevOps 小满

2026-4-27

为什么Selenium的Chrome()在VS Code中被静态检查工具报错但实际能运行？

这个问题我之前也碰到过，其实核心原因是Selenium的导入机制和静态检查工具的分析逻辑不匹配，具体来说：

Selenium为了让用户写代码更方便，做了一个"偷懒"的导入封装：你从selenium.webdriver导入的Chrome，表面上看是从这个模块直接拿的，但实际上它在运行时会偷偷把你指向selenium.webdriver.chrome.webdriver里的同名Chrome类——也就是真正可以实例化的浏览器驱动类。

但Pylance、Pylint这类静态检查工具不会执行你的代码，它们只会根据代码的静态结构来分析。在它们眼里，selenium.webdriver.Chrome是一个模块（ModuleType），而不是可调用的类，所以就会抛出"不是可调用对象"的错误，但实际上运行时Selenium已经帮你完成了正确的导入重定向，所以代码能正常跑起来。

解决办法有这几种，按推荐程度排序：

直接导入正确的类路径（最推荐）
跳过Selenium的封装，直接导入真正的Chrome类，这样静态检查工具就能准确识别它的类型：
```
from selenium.webdriver.chrome.webdriver import Chrome
with Chrome() as driver:
    driver.get("https://example.com")
```

用类型注解明确类型
如果不想改导入路径，可以给变量加上类型注解，告诉静态检查工具它的真实类型：

from selenium.webdriver import Chrome
from selenium.webdriver.chrome.webdriver import Chrome as ChromeDriver

with Chrome() as driver:
    driver: ChromeDriver = driver
    driver.get("https://example.com")

临时忽略检查错误（不推荐）
如果你实在不想改代码，可以在VS Code的设置里让Pylance忽略这个特定错误，但这会掩盖其他可能的真实问题，所以谨慎使用：
在.vscode/settings.json中添加：
```
{
    "python.analysis.ignore": ["reportCallIssue"]
}
```