影刀RPA速查手册常用指令分类速查 报错一搜即得整理了一份在实际项目里高频使用的指令和报错处理按功能分类碰到问题搜关键词就能找到。一、安装和配置Q去哪里下载影刀www.yingdao.com选Windows版社区版免费。Q装完影刀捕获网页元素时什么都捕不到浏览器插件没装。进Chrome扩展程序页搜影刀装上Edge同样操作装完重启浏览器。Q捕获框和元素位置有偏移6个排查方向系统DPI缩放不是100% → 去显示设置改浏览器缩放不是100% → 浏览器设置里改浏览器开了兼容模式 → 右键快捷方式→属性→取消兼容模式系统文本大小自定义了 → 改回100%远程桌面两端缩放不一致 → 两端统一Win10任务栏在顶部/左边 → 改到底部改完重启影刀和浏览器。二、元素定位速查XPath常用写法//div[classprice] # 精确class匹配 //div[contains(class,price)] # class模糊匹配推荐稳定 //span[text()确认] # 精确文本匹配 //span[contains(text(),确认)] # 文本包含匹配更安全 //ul[idlist]/li[3] # 取第3个li //div[classrow]//span # 所有后代span //span[classprice]/parent::div # 向上找父div //li[last()] # 取最后一个li //li[position()3] # 取第3个之后的所有liCSS选择器常用写法.item-price/* class包含item-price */#submit-btn/* id为submit-btn */.order .price/* .order的直接子元素.price */.order .price/* .order的所有后代.price */li:nth-child(2)/* 第2个li */li:last-child/* 最后一个li */[data-id001]/*>text]/* type属性为text的input */div.active.selected/* 同时有active和selected两个class */XPath vs CSS选择器选哪个场景推荐按文字内容定位元素XPathCSS不支持需要向上找父节点XPathCSS不支持简单的class/id定位CSS更简洁按属性值定位都可以CSS语法更短三、变量与数据类型速查字符串操作取索引text[0] # 第1个字符 切片text[0:5] # 前5个字符 拼接text1 text2 # 直接用 长度len(text) # 字符数 去空格text.strip() # 去首尾空格 去换行text.replace(\n, ) 转大写text.upper() 是否包含关键词 in text列表操作取第一项list[0] 取最后项list[-1] 取长度len(list) 追加用追加元素到列表指令 是否包含item in list字典操作取值可能不存在时dict.get(key, 默认值) 判断键是否存在key in dict 取值确定存在时dict[key]JSON相关拼多多店群自动化上架方案字符串→字典用文本转换为JSON指令 字典→字符串用JSON转换为文本指令 取深层嵌套值data[level1][level2] 取列表里第一项的某字段data[list][0][field]四、流程控制速查循环类型选择场景用哪种循环循环固定次数For次数循环遍历列表每一项ForEach列表循环遍历Excel每一行循环Excel内容循环网页所有相似元素相似元素循环不知道循环几次条件满足才停While循环完全不知道遇到条件手动退出无限循环If判断退出循环异常处理模板Try [主流程逻辑] Catch (error) 打印 (异常 str(error)) [备用处理比如关闭弹窗、刷新页面] Finally [无论成不成功都要执行比如关浏览器、保存Excel]五、网页自动化速查等待策略场景方法等固定时间等待N秒不推荐用以下替代等页面某元素出现等待元素出现推荐等加载动画消失等待元素消失等网络请求完成等待元素出现目标元素弹窗处理弹窗类型处理方式浏览器原生弹窗系统级只有OK/取消处理对话框指令页面内自定义弹窗捕获关闭/确认按钮点击不知道什么时候会出现的弹窗外层循环套Try-CatchCatch里处理翻页处理知道总页数获取总页数 → For次数循环(总页数) → 每次循环末尾点下一页不知道总页数推荐无限循环 { 采集当前页数据 获取下一页按钮的class属性 If class包含disabled → 退出循环 点击下一页 等待页面加载 }iframe处理切换到iframe选择目标iframe元素 [iframe内的操作] 跳出iframe [继续主页面操作]懒加载处理核心思路维护一个已采集记录列表每次循环时获取当前可见的元素用元素的唯一属性如index值、订单号和列表比对。已有则跳过没有则采集并追加到记录列表。同时在每次循环后向下滚动鼠标直到记录列表长度达到总数量或者连续滚动后数量不再增加。六、数据处理速查Excel操作操作指令打开已存在的Excel启动Excel / 获取当前激活的Excel读取数据循环Excel内容逐行遍历取某列数据loop_item[列序号从0开始]写入单元格在单元格写入内容追加一行在末尾写入行号用计数变量保存保存Excel必须做Excel常见报错报错原因解决Can not convert Array to String把整行loop_item当字符串用改为loop_item[0]取某列AttributeError: NoneType get_active_sheetExcel对象没有赋值加启动Excel指令日期时间少8小时UTC时区问题写入前加timedelta(hours8)内存不足Excel文件太大分批读取每批处理完关闭数据库操作完整流程连接数据库 → 执行查询/插入 → 关闭连接批量插入性能更好一次INSERT多条INSERTINTOorders(id,name,amount)VALUES(?,?,?),(?,?,?),...常见报错连接失败检查主机名、端口、账号密码表不存在确认表名大小写、数据库名是否选对权限问题用更高权限的账号或者让DBA开权限字段不存在对照表结构确认字段名拼写七、鼠标键盘图像自动化速查操作模式选择场景模式跑流程时还要用电脑做别的模拟模式默认需要稳定执行、不在乎占用输入设备驱动模式驱动模式需要在影刀设置里安装虚拟键盘驱动。图像识别指令指令用途等待图像出现等目标图像显示在屏幕上点击图像点图像的某个锚点位置悬停图像鼠标移到图像上双击图像双击图像锚点位置9个上中下 × 左中右加偏移量可以精准点图像旁边。八、进阶功能速查HTTP请求参数填法URL完整接口地址方法GET查询/ POST提交/修改Headers鉴权Authorization: Bearer token内容类型Content-Type: application/jsonBodyPOSTJSON格式字典{“key”: “value”}返回值字符串用文本转JSON转成字典再操作Python代码块defmain(args):# 取输入参数input_valueargs[参数名]# 处理逻辑resultinput_value.strip()# 返回结果return{输出参数名:result}跨模块调用需要在文件开头加from . import package安装第三方库用影刀的Python路径跑pipC:\影刀安装路径\python.exe-mpipinstallrequestsTEMU店群如何管理运营OCR识别截图保存到变量→ OCR识别文字选类型→ 文本处理strip、replace去杂质验证码类型纯数字/纯英文/数英混合/缺口识别/点选坐标 等。ADB手机自动化连接手机连接名 操作 - 找元素find_by_text / find_by_xpath / find_by_id - 点击click(x, y) 或 点击元素(手机) - 滑动swipe(x1, y1, x2, y2, 时间ms) - 截图screenshot(保存路径) - 后退back() 断开连接九、系统联动速查飞书消息通知HTTP请求POST URL: 飞书机器人webhook地址 Body: { msg_type: text, content: {text: 消息内容} }定时任务调度中心 → 新建任务 → 设置触发方式按天/按周/按月/Cron表达式→ 选择应用 → 保存电脑需要保持开机影刀需要在运行状态。邮件发送发送邮件指令配置 - SMTP服务器smtp.qq.comQQ/ smtp.163.com163 - 端口465SSL - 账号发件邮箱 - 密码邮箱授权码不是登录密码 - 收件人多人用逗号分隔 - 附件指定文件路径十、工程化速查子流程参数传递子流程定义 输入参数param1, param2 取值方式args[param1] 返回值return {result: value} 主流程调用 填写输入参数的值 保存返回值到变量命名规范建议流程名动词对象 例采集小红书笔记、发送每日报告 变量名功能描述 例current_page、data_list、order_info 子流程名动词对象特征 例写入Excel_单行、发送飞书消息_文本版本对比功能社区版免费创业版企业版基础自动化✓✓✓机器人数量1个多个多个调度中心✗✓✓| 多用户管理 | ✗ | ✗ | ✓ || 权限控制 | ✗ | ✗ | ✓ |十一、报错全表报错关键词通常原因排查方向未找到控件 / 元素未找到元素未加载/定位失效/在iframe里加等待/修改XPath/切换iframeNoneType has no attribute变量没有赋值是None打断点看变量值Can not convert Array to String列表当字符串用用[0]取某列KeyError: ‘xxx’字典里没有这个键用.get()或先判断JSONDecodeErrorJSON格式错误打印原始字符串检查ConnectionRefused数据库/接口连不上检查IP、端口、防火墙对话框处理超时浏览器弹窗没处理加处理对话框指令XPath语法错误XPath写法不对检查引号嵌套、节点名ModuleNotFoundErrorPython库没安装用影刀的pip安装AttributeError: get_active_sheetExcel对象为空加启动Excel指令想要完整的指令速查文档和更多案例模板可以在 home.linyan.cloud 查找影刀RPA学习资源。#影刀RPA #速查手册 #常用指令 #报错处理 #RPA教程作者林焱