WebDriverWait 显式等待等待的是特定条件成立，如元素可点击或可见，而非页面完全加载；混用隐式等待会导致超时叠加，应禁用隐式等待；timeout 是总上限，poll_frequency 才影响响应速度。
WebDriverWait 显式等待到底等什么
它等的是某个条件成立，不是等时间或等页面“完全加载完”。很多人以为 WebDriverWait 是在等整个页面 DOM+JS+资源全就绪，其实它只管你传进去的那个 expected_condition——比如元素是否可点击、是否出现在 DOM 中、是否可见、是否文本包含某内容。
常见错误现象：TimeoutException 报错，但目标元素明明已经显示在页面上了。原因往往是：你用了 presence_of_element_located，但它只检查元素是否在 DOM 里（哪怕被 CSS 隐藏），而实际需要的是 element_to_be_clickable 或 visibility_of_element_located。
-
presence_of_element_located：只查 HTML 是否有这个节点，不关心是否可见、是否可交互 -
visibility_of_element_located：要求元素在 DOM 中且display != none且visibility != hidden -
element_to_be_clickable：更严格，还要满足enabled == True且不在其他元素遮挡下（会触发 click 检查）
隐式等待和显式等待混用会出什么问题
隐式等待是全局的、对所有 find_element 调用生效的“兜底超时”，而 WebDriverWait 是针对单个条件的主动轮询。两者叠加会导致等待时间翻倍甚至逻辑混乱。
典型表现：代码里设了 driver.implicitly_wait(10)，又写了 WebDriverWait(driver, 5).until(...)，结果某个元素没找到时，实际卡了 15 秒才报错——因为隐式等待还在后台默默等满 10 秒，而 WebDriverWait 又等了 5 秒。
立即学习“Python免费学习笔记（深入）”；
- 显式等待前务必清掉隐式等待：
driver.implicitly_wait(0) - 隐式等待适合简单、稳定的老系统；显式等待才是现代 Selenium 自动化唯一靠谱的等待方式
- 一旦用了
WebDriverWait，就别再碰implicitly_wait，包括在 setup 阶段设的也要关掉
timeout 参数不是越长越好，关键看 poll_frequency
WebDriverWait(driver, timeout=10) 的 10 秒是总上限，但真正决定响应快慢的是轮询间隔，默认是 0.5 秒。也就是说，即使元素 100ms 就出现了，你也可能要等最多 0.5 秒才拿到它。
使用场景：高频操作（如表单连续提交、弹窗快速闪现）或低延迟测试环境，值得调小轮询频率；但别设成 0.01 秒——太频繁会加重浏览器负担，某些驱动（如 ChromeDriver）反而响应变慢。
- 缩短轮询间隔：
WebDriverWait(driver, timeout=10, poll_frequency=0.1) - 注意：Selenium 4.0+ 对极短 poll_frequency（
- 移动端或慢速渲染页面，可适当加大 timeout，但 poll_frequency 保持默认即可
为什么 find_element 找不到，但 WebDriverWait 却能等到
根本区别在于执行时机和上下文：find_element 是“立刻查一次”，而 WebDriverWait 是“不断重试 + 每次都重新执行 locator 表达式”。如果页面动态插入了元素（比如 React/Vue 渲染后挂载），find_element 很可能在 JS 还没跑完时就执行失败了；WebDriverWait 则会在每次轮询中重新调用 find_element，直到条件满足或超时。
容易踩的坑：写错了 locator，比如用 By.ID 却传了 class 名，或者用了过期的 XPath（页面结构已变）。这时 WebDriverWait 不是“变灵了”，而是反复报同一个错，最后抛出 TimeoutException ——你得看日志里最后一次失败的具体错误，而不是以为它“等到了”。
- 调试技巧：在 until 前加一行
print(driver.page_source[:500])，确认当前 DOM 确实含目标元素 - 避免用
time.sleep()替代等待：它不感知状态，纯靠猜，既慢又不可靠 - 若 waitFor 被封装进工具函数，记得把 locator 和 expected_condition 一起透传，别固化成“等某个固定 ID”
WebDriverWait，而是每次都要想清楚：你想等的，到底是“存在”“可见”还是“能点”，以及这个状态在什么时机才真正由 JS 触发。 
