影刀RPA新手教程子流程封装完全指南——参数传递、复用设计与调试技巧我第一次写影刀流程的时候把所有逻辑塞进一个主流程里洋洋洒洒三百多条指令。跑起来没问题但第三天产品改了个需求——订单状态要多判一个分支——我对着那个三百行的流程图找了半小时才定位到要改的地方。那天晚上我就下定决心要学会子流程封装。这篇就以电商订单处理系统为案例主线从头到尾带你把一个单体流程拆成可复用的子流程架构顺便把影刀的核心知识全过一遍。先把影刀装好去影刀官网下载安装包双击安装就行。装完之后别急着新建流程先把浏览器插件装上——Chrome和Edge都支持在影刀的设置-浏览器扩展里一键安装。这个插件是用来辅助元素捕获的没它你抓不到网页元素。界面打开后你会看到左侧是流程列表中间是画布右侧是指令面板和变量面板。主流程和子流程都在左侧的流程树里管理右键某个文件夹就能新建子流程。元素定位四合一子流程也要抓元素订单处理系统的第一步是登录后台。不管你把这个登录逻辑放在主流程还是子流程里元素定位都是绕不开的。影刀的元素捕获是四合一体系元素捕获器、XPath、CSS选择器、正则表达式。我推荐能元素捕获就元素捕获抓不到再上XPath和CSS。登录页的用户名输入框元素捕获点一下就拿到了。但有些后台系统的输入框是动态生成的捕获的路径第二天就变。这时候上XPath//input[placeholder请输入账号]或者CSS选择器更简洁input[placeholder请输入账号]我当时踩过一个坑某电商后台的登录按钮包在三层div里class名是随机字符串元素捕获抓到的路径隔天就失效。最后用XPath的文本定位解决了//button[contains(text(),登录)]XPath和CSS怎么选我的经验是——属性稳定的用CSS写起来短文本内容唯一的用XPathcontains文本定位太好用了。正则表达式主要用在数据提取阶段比如从订单号里提取日期(\d{4})(\d{2})(\d{2})变量与数据类型子流程参数的基础子流程之间传参本质就是变量传递。影刀的变量类型你得心里有数。数字类型用于计数比如当前处理到第几条订单。字符串用于文本比如订单号DD20260624001。列表用于批量数据比如一天的所有订单号列表。字典用于结构化数据比如一条订单的信息order{order_id:DD20260624001,customer:张三,amount:199.00,[video(video-k6B7KbXh-1782671022759)(type-csdn)(url-https://live.csdn.net/v/embed/525000)(image-https://v-blog.csdnimg.cn/asset/23da3fe1f67a47106d725406cfde9a97/cover/Cover0.jpg)(title-拼多多店群自动化上架方案)]status:已付款}字典取值有个经典坑——键不存在直接报错。两个方案要么用If先判断键是否存在要么用Python的get方法给个默认值order.get(remark,无备注)JSON操作在对接API时特别常用。HTTP请求拿到的是文本要先转JSON才能操作importjson response_text{code: 0, data: {order_id: DD001}}datajson.loads(response_text)print(data[data][order_id])操作完再转回文本发出去json.dumps(result)。流程控制子流程内部的逻辑骨架子流程内部和主流程的编写方法完全一致流程控制指令一样用。这点官方文档说得很明确——“子流程内指令的编写与主流程的编写方法完全一致并无不同”。For次数循环用于已知次数的场景比如处理10条订单。相似元素循环用于网页上同类元素比如订单列表里的每一行。ForEach列表循环用于遍历数据列表。While条件循环用于不确定什么时候结束的场景比如只要还有未处理订单就继续。我订单处理系统里有个批量查询物流的子流程用的就是ForEach列表循环——传入一个订单号列表逐个查询。If条件判断决定分支走向已付款的走发货流程待付款的走催付流程。Try-Catch包住可能出错的指令比如网络请求超时就跳过当前订单继续下一条。网页自动化子流程最常见的用途订单处理系统的网页操作我拆成了三个子流程登录后台、获取订单列表、处理单条订单。网页自动化的核心是等待策略。三种等待必须掌握固定等待简单但浪费时间、元素等待等元素出现再操作最常用、条件等待等某个条件满足。登录子流程里点完登录按钮后要等后台首页加载完用元素等待等订单管理菜单出现。弹窗处理有个五步标准流程捕获弹窗元素-判断是否存在-存在就点确认-继续后续操作-Try-Catch兜底。有些后台还会出盲点弹窗就是你没预料到的弹窗用Try-Catch包住整个操作块能兜住大部分。翻页处理在订单列表里用得最多。总页数不确定的时候别用固定次数循环用While循环配合下一页按钮的disabled class判断——按钮变灰了就是到底了。懒加载页面要配合滚动和index去重。iframe处理记得切换上下文窗口切换记得用窗口句柄。数据处理子流程的输入输出子流程的参数传递本质上就是数据处理。我订单系统的主流程从Excel读取订单数据传给处理单条订单子流程子流程处理完返回结果主流程再写回Excel。Excel读写是基本功。读取用读取Excel区域写入用写入Excel区域。批量处理的时候别一条一条写攒够一批再写性能差距很大。文本提取与清洗用在订单备注这种非结构化数据上。JSON解析用在API对接上。数据库连接用在需要持久化存储的场景——查询用SELECT批量插入用executemany用完记得关闭连接。数据库有五个常见报错你要记住连接超时检查网络和端口、权限不足检查账号密码、SQL语法错误打印SQL语句检查、字符集问题指定charset‘utf8’、连接数超限用完就关。鼠标键盘图像自动化有些后台系统的按钮点不动元素捕获定位不到这时候就要上鼠标键盘。模拟模式和驱动模式是两套东西。模拟模式就是模拟你的物理鼠标移动和点击会被其他窗口遮挡。驱动模式用虚拟键盘驱动不抢焦点后台也能操作。我订单系统里有个打印按钮模拟模式点了没反应切驱动模式就好了。图像识别在元素定位全部失效时是最后手段。wait_appear等图片出现click点图片hover悬停dblclick双击。锚点定位有9个位置加偏移量调整——找到锚点图片后点它的左上、正上、右上、左中、正中、右中、左下、正下、右下九个方向再加xy偏移微调。进阶技能子流程的高级玩法HTTP请求让子流程能直接调API不用走网页。我订单系统有个查询物流子流程最开始是模拟人工去物流网站查后来对接了快递100的API一个HTTP请求搞定速度快了十倍。Python协同是子流程的杀手锏。在子流程里用执行Python脚本指令可以写def函数、跨模块调用、用第三方库。比如订单数据清洗用Python的pandas比影刀原生指令快得多importpandasaspd dfpd.DataFrame(orders)dfdf.drop_duplicates(subset[order_id])resultdf.to_dict(records)OCR文字识别用在图片验证码上。ADB手机自动化用在移动端场景——后面单独讲。平台实战订单处理系统不是纸上谈兵。我在淘宝和拼多多都跑过这套子流程架构。淘宝采集的核心是防反爬请求频率要控制User-Agent要轮换。拼多多采集的核心是验证码滑块验证要用图像识别处理。TEMU跨境要注意多语言抖音电商要注意动态加载。小红书采集是我最喜欢的练手项目。笔记内容用元素捕获抓评论用获取相似元素列表批量抓翻页用disabled class判断。把采集单条笔记封装成子流程主流程只管循环和翻页结构清晰得很。系统联动订单处理完要通知人。飞书消息通知用HTTP请求调飞书机器人API一行代码发一条消息。飞书多维表格读写用飞书开放平台API把订单数据写进多维表格团队都能看。邮件发送用SMTP影刀有现成的发送邮件指令。定时任务配置在影刀的定时任务里设好时间就能自动跑。我订单系统设的是每天上午9点自动跑一次跑完发飞书通知。工程化与规范子流程封装的核心终于到了这篇的重头戏。官方文档说得很清楚流程封装不能减少代码数量但利于复用和调试。子流程之间可以互相调用命名要规范。我订单系统的子流程拆分主流程只做三件事——调用登录子流程、调用获取订单列表子流程、ForEach循环调用处理单条订单子流程。TEMU店群如何管理运营参数传递是关键。子流程有输入参数主流程就要传参子流程有输出参数子流程内部要算出这个值传回主流程。官方文档的例子子流程里age18主流程里process_result就会包含18。我的处理单条订单子流程输入参数是order_id字符串类型和order_info字典类型输出参数是process_result字典类型包含处理状态和备注。主流程调用时把当前订单的id和信息传进去子流程处理完返回结果。调试子流程有个技巧——可以单独运行子流程测试。我经常把某个功能独立成子流程就是为了能单独跑它不用每次跑整个主流程。官方文档也说了这点“在测试某个功能是否可以实现的时候就可以使用子流程将某个功能独立出来。”命名规范我踩过坑。一开始子流程叫流程1“流程2“流程A”一个月后自己都记不清哪个是干嘛的。后来统一命名动词名词场景比如登录-电商后台”“获取-订单列表”“处理-单条订单”。调用流程时按名称排列结构一目了然。速查表与常见报错子流程相关报错我遇到过这些参数类型不匹配——主流程传字符串子流程期望列表直接报错。解决检查输入参数类型设置。输出参数为空——子流程里忘了给输出变量赋值。解决在子流程最后加一个赋值指令。子流程找不到——移动文件后路径变了。解决用相对路径别用绝对路径。循环调用——子流程A调子流程BB又调A死循环。解决画清楚调用关系图。元素定位失败——子流程里捕获的元素路径失效。解决用XPath或CSS重写定位别依赖自动捕获的路径。Excel报错Array to String——把列表直接写进单元格了。解决列表要先join成字符串。日期偏移问题——Excel日期从1900年开始算比Python多2天。内存不足——大文件用流式读取别一次性全读进来。循环报错索引越界——循环过程中列表长度变了。解决先复制一份再循环。我把这些报错和解决方案整理了一份文档放在 home.linyan.cloud 平时遇到问题直接搜。子流程封装的复用设计最后说几句复用设计的心法。一个子流程值不值得封装看两点是否被调用两次以上、是否逻辑独立。登录后台这个操作每个电商流程都要用封装成子流程一次写好到处调值。参数设计要留扩展性。我处理单条订单子流程一开始只有order_id一个参数后来要加备注功能又要改参数。如果一开始就用order_info字典传参加字段不用改接口。调试时善用断点。在子流程的入口和出口打断点一行行排查比在三百条指令的主流程里找问题快十倍。这也正是子流程封装的意义——把问题隔离在一个小范围内。子流程不是万能药。如果你的流程只有二三十条指令别拆拆了反而增加复杂度。封装的目的是管理复杂度不是为拆而拆。#影刀RPA #RPA教程 #子流程封装 #新手入门作者林焱