写自动化流程时，最烦“元素还没加载完就点击了”。 报错“找不到元素”，加个固定等待又太慢，不加又不行。
影刀有3个等待指令：固定等待、等待元素出现、等待元素消失。用对了省时间，用错了流程飘忽不定。
一、三兄弟速览对比
| 指令名称 | 作用 | 适用场景 | 是否推荐首选 |
|---|
| 固定等待 | 死等X秒 | 已知耗时、调试阶段 | ❌ 尽量少用 |
| 等待元素出现 | 等某个元素出现（可设置超时） | 页面加载、弹窗出现、AJAX请求完成 | ✅ 首选 |
| 等待元素消失 | 等某个元素消失（可设置超时） | 加载遮罩消失、弹窗关闭、提交成功提示 | ✅ 首选 |
核心原则：不要用固定等待替代判断加载状态。 等待元素出现/消失才是稳定做法。
二、固定等待：最简单但最不推荐
指令位置：左侧“等待”分类 → “固定等待”。
操作步骤
- 拖动“固定等待”到画布
- 右侧设置等待时间（秒，支持小数）
- 放在需要停顿的位置
# 示例：点击搜索后等2秒再抓结果
点击元素：//button[text()='搜索']
固定等待：2秒
获取元素文本：//div[@class='result']
什么时候不得不用：
- 页面有动画过渡（如淡入淡出）但无元素变化
- 第三方嵌入的iframe加载（没有任何加载指示）
- 调试时想观察中间过程
不建议用的原因：
- 网络好的时候多等，浪费社区版30分钟/天
- 网络慢的时候不够等，照样报错
- 换个环境（手机热点/公司网络）就失效
三、等待元素出现：最稳定的等待方式
指令位置：左侧“等待”分类 → “等待元素出现”。
核心逻辑：每隔0.2秒检查一次元素是否存在，直到超时。
操作步骤
- 捕获要等待出现的元素（比如搜索结果列表）
- 设置超时时间（默认10秒，建议根据网络设3-8秒）
- 勾选“存在后存入变量”（可选）
- 如果超时还没出现，指令会报错。建议外层套Try-Catch
# 示例：搜索后等待结果出现
点击元素：//button[text()='搜索']
等待元素出现：//div[@class='result-list']
超时时间：5秒
存在后存入：结果出现
# 元素出现后才执行后续
获取相似元素列表：//div[@class='result-item']
实战技巧：等待的元素不一定是要操作的元素，可以是一个标志性元素。
# 拼多多：等待商品列表加载完成
等待元素出现：//div[@class='goods-container']，超时8秒
# 小红书：等待笔记卡片出现
等待元素出现：//div[@class='note-item']，超时5秒
# 淘宝：等待“提交订单”按钮变可点
等待元素出现：//button[contains(text(),'提交订单') and not(@disabled)]
注意： 如果元素一开始就存在（比如页面静态部分），这个指令会立刻返回。所以只用在动态加载的内容上。
四、等待元素消失：处理加载遮罩的利器
指令位置：左侧“等待”分类 → “等待元素消失”。
很多页面点击后会有一个灰色遮罩+转圈loading。
等它消失后再操作，比固定等待快得多。
操作步骤
- 捕获要等待消失的元素（加载遮罩、loading图标）
- 设置超时时间
- 超时后还没消失会报错
# 示例：点击“加载更多”后，等待loading消失
点击元素：//button[text()='加载更多']
等待元素消失：//div[@class='loading-mask']
超时时间：10秒
# loading消失后，新数据已加载完成
获取相似元素列表：//div[@class='new-item']
实战场景1：表单提交后的成功提示
# 点击提交后，等待“提交成功”弹窗消失
点击元素：//button[text()='提交']
等待元素出现：//div[contains(text(),'提交成功')]，超时5秒 # 先确认出现
等待元素消失：//div[contains(text(),'提交成功')]，超时3秒 # 再等它消失
实战场景2：翻页时的表格刷新
# 拼多多翻页，表格会有短暂loading
点击元素：//a[text()='下一页']
等待元素消失：//div[@class='table-loading']，超时5秒
# 然后采集数据
注意： 等待消失的指令要求元素先存在再消失。如果元素本来就不存在，会直接返回（认为已经消失）。这可能导致误判，比如loading没出现就直接过了。稳妥做法是先判断元素是否存在。
# 稳妥写法：先判断loading是否存在，存在才等消失
判断元素是否存在：//div[@class='loading']
如果 存在 == True
等待元素消失：//div[@class='loading']，超时5秒
五、三种等待的黄金组合
完整流程中的典型用法：
# 步骤1：点击按钮后，等待某个新元素出现
点击元素：//button[text()='查询']
等待元素出现：//div[@class='result-area']，超时10秒
# 步骤2：在结果区域内操作，然后提交
输入文本：.//input[@name='keyword']，内容="影刀"
点击元素：.//button[text()='搜索']
# 步骤3：搜索触发loading，等待loading消失
等待元素出现：//div[@class='spinner']，超时2秒 # 先确认loading出现
等待元素消失：//div[@class='spinner']，超时8秒
# 步骤4：加载完成，采集数据
获取相似元素列表：//div[@class='item']
为什么不直接用固定等待？ 假设loading平均2秒消失，用固定等待3秒，网络差时loading要5秒，固定等待3秒不够会报错；网络好时loading1秒，固定等待浪费2秒。而“等待元素消失”动态适应。
六、易错速查表
| 错误现象 | 原因 | 解决方法 |
|---|---|---|
| 等待元素出现超时报错 | 超时太短或元素XPath不对 | 调高超时（5→10秒），或用contains模糊匹配 |
| 等待元素消失直接过 | 元素本来就不存在 | 先判断元素是否存在，存在才等消失 |
| 固定等待导致社区版超时 | 累积等待时间太长 | 批量替换为等待元素出现/消失，可节省50%时间 |
| 等待后元素还是没加载完 | 等待的元素不是最后一个加载的 | 换一个更晚出现的元素（比如“已加载xx条”） |
| 弹窗等待消失失败 | 弹窗有多个层（遮罩+内容） | 分别等待遮罩消失和内容消失 |
七、调优建议：如何设置合理的超时时间
| 操作类型 | 推荐超时 | 说明 |
|---|---|---|
| 点击搜索到结果出现 | 5-8秒 | 电商搜索一般2-4秒，留余量 |
| 翻页后等待表格刷新 | 3-5秒 | 翻页通常更快 |
| 登录后跳转 | 10秒 | 可能有重定向、验证码 |
| 文件上传 | 15-30秒 | 取决于文件大小 |
| 弹窗出现 | 2-3秒 | 弹窗一般很快 |
经验： 超时时间设偏长不影响效率（早出现早返回），设偏短容易报错。宁愿10秒也不要4秒。
推荐资源
- 影刀官方帮助中心：搜索“等待指令”有对比表格和动图
- 我的调试习惯：先在浏览器看实际加载耗时，超时设为实际耗时的2倍
- 进阶：try-catch捕获等待超时异常，做重试机制
作者：林焱
本文为《影刀RPA学习手册》系列文章之一，内容源于实操经验的整理与分享。