影刀RPA完全指南：RPA流程命名规范与注释标准完整手册

影刀RPA完全指南RPA流程命名规范与注释标准完整手册流程写完能跑不等于流程写得好。我在公司接手过别人写的影刀RPA流程变量名叫a、b、c没有任何注释看了一小时都没搞懂逻辑。后来我花了一周整理出一套命名规范和注释标准团队所有人按这套规范写交接时间从一天缩到十分钟。这篇是影刀RPA流程规范的完整手册覆盖变量命名、流程命名、注释标准、文件管理四个维度。变量命名规范与类型标识影刀RPA的变量管理面板在编辑界面底部所有变量在这里统一管理。变量名是流程可读性的第一道关。好的变量名应该不看注释就能猜出含义差的变量名三天后自己都忘了是什么。变量命名规范对照命名方式示例是否推荐原因前缀驼峰str商品标题推荐类型含义一目了然纯中文商品标题推荐非技术人员友好可读性好单字母a,b,tmp禁止完全无法理解含义拼音缩写sptitle禁止混合语言容易拼错英文驼峰goodsTitle可接受适合有英文基础的团队下划线goods_title可接受Python风格操作步骤在影刀RPA底部变量面板中每创建一个变量都按规范命名类型前缀规则str字符串、int整数、lst列表、dict字典、bol布尔循环变量用idx开头idx当前页码、idx当前商品临时变量用tmp开头tmp价格文本、tmp转换结果全局配置变量用cfg开头cfg超时时间、cfg最大重试次数# 影刀RPA中变量命名的实际应用对照# ❌ 差的命名a蓝牙耳机# 不知道a是什么b29.9# 不知道b是什么c[]# 不知道c存什么tmpTrue# 临时变量太多分不清# ✅ 好的命名str商品标题蓝牙耳机# 字符串类型商品标题flt商品价格29.9# 浮点类型商品价格lst商品列表[]# 列表类型商品列表[video(video-VqdEX7G8-1785092109375)(type-csdn)(url-https://live.csdn.net/v/embed/526818)(image-https://v-blog.csdnimg.cn/asset/582d14c3bd0451c5399cd990b56e2a0d/cover/Cover0.jpg)(title-拼多多店群自动化报活动上架)]bol采集成功True# 布尔类型采集是否成功# ✅ 循环变量命名idx当前页码1# 索引变量当前页码idx当前商品0# 索引变量当前商品序号# ✅ 配置变量命名cfg超时时间10# 配置变量超时秒数cfg最大重试次数3# 配置变量最大重试次数cfg采集网址https://...# 配置变量目标网址这里很容易踩坑注意看影刀RPA变量名支持中文但Python代码中引用时需要用英文变量名。如果流程中混用影刀RPA指令和Python代码建议统一用英文驼峰命名。流程与子流程命名规则影刀RPA的流程名和子流程名是流程架构的目录命名混乱会让整个项目难以维护。子流程命名规范前缀含义示例主流程_主流程入口主流程_拼多多商品采集子流程_子流程模块子流程_登录模块工具_工具类流程工具_截图通知公共_多流程共用的公共流程公共_Excel写入测试_测试用流程测试_XPath验证操作步骤在影刀RPA左侧流程面板中右键新建流程流程名按前缀_平台_功能格式命名子流程的输入输出参数也要命名规范参数名用in_和out_前缀区分方向# 影刀RPA项目流程结构示例 主流程_拼多多商品采集 ├── 子流程_拼多多_登录 ├── 子流程_拼多多_搜索关键词 ├── 子流程_拼多多_采集商品列表 ├── 子流程_拼多多_翻页处理 ├── 子流程_公共_写入Excel ├── 工具_截图通知  └── 公共_日志记录 # 子流程参数命名 # 子流程_拼多多_登录 # 输入参数: in_账号(String), in_密码(String), in_网址(String) # 输出参数: out_登录状态(Boolean), out_错误信息(String)影刀RPA的流程参数输入输出在子流程编辑界面的右侧面板配置。每个参数要设置名称、类型和默认值。参数名带上方向前缀in_/out_调用时一眼就知道是输入还是输出。注释标准与关键节点标注影刀RPA没有代码注释但有两种注释方式指令备注和输出日志指令做分段标记。注释不是写给自己看的是写给三个月后接手的人看的。操作步骤每条关键指令在指令详情面板的备注栏写一句话说明每个功能模块开头拖入输出日志指令内容为 模块名 复杂逻辑处加输出日志指令解释下一步意图异常处理Catch块中必须写清楚可能的错误原因注释标准对照指令类型是否需要备注备注示例打开网页需要“打开拼多多商家后台”输入文本需要“输入搜索关键词来自cfg关键词变量”循环指令需要“遍历商品列表逐条提取数据”条件判断需要“判断是否有下一页没有则跳出循环”等待指令需要“等待商品列表加载完成超时10秒”设置变量视情况“行号1准备写入下一行”输出日志不需要日志本身就是说明# 影刀RPA中用输出日志指令做流程分段注释# 模块开始标记 模块开始: 登录模块 打开拼多多商家后台: https://mms.pinduoduo.com输入账号密码账号来自cfg变量点击登录按钮等待首页加载验证登录: 检查是否出现欢迎字样# 关键决策点注释判断登录是否成功: True继续采集, False发通知退出# 模块结束标记 模块结束: 登录模块 | 状态: 成功 | 耗时: 15秒 # 异常处理注释Catch块: 登录失败的常见原因: 1.密码错误 2.验证码 3.账号被限制Catch块: 处理方式: 截图通知重试3次推荐一个方法实测好用每个模块的输出日志标记用统一的格式 模块名 这样在运行日志面板中搜索就能快速定位到每个模块的执行位置。文件目录管理与版本控制影刀RPA流程文件本身在客户端管理但采集结果文件、日志文件、配置文件需要规范的目录结构。推荐目录结构C:/Desktop/RPA项目/ ├── 流程文件/ # 影刀RPA导出的.flow文件 │ ├── 拼多多商品采集.flow │ └── 淘宝评价抓取.flow ├── 配置文件/ # 账号、Cookie等配置 │ ├── 账号配置.xlsx │ └── Cookie记录.txt ├── 采集结果/ # 输出的数据文件 │ ├── 20250626/ # 按日期分目录 │ │ ├── 拼多多_商品数据.xlsx │ │ └── 淘宝_评价数据.xlsx [video(video-60w9YS3W-1785092115990)(type-csdn)(url-https://live.csdn.net/v/embed/526817)(image-https://v-blog.csdnimg.cn/asset/1d3c3709da119dd8c13ab01e9b282520/cover/Cover0.jpg)(title-TEMU店群矩阵自动化运营核价报活动)] ├── 日志/ # 运行日志 │ ├── 20250626/ │ │ ├── 拼多多采集.log │ │ └── 运行报告.txt ├── 截图/ # 异常截图 │ └── 20250626/ └── 通用模板/ # 复用的Excel模板 └── 商品数据模板.xlsx操作步骤在影刀RPA流程开头用执行Python代码指令创建当天目录所有文件路径用变量统一管理不要硬编码采集结果文件名格式平台_数据类型_日期.xlsx# 影刀RPA中文件路径管理importosfromdatetimeimportdatetimedefinit_file_paths(platform,data_type):初始化当天文件路径自动创建目录todaydatetime.now().strftime(%Y%m%d)base_dirC:/Desktop/RPA项目# 各类文件的目录路径paths{结果目录:os.path.join(base_dir,采集结果,today),日志目录:os.path.join(base_dir,日志,today),截图目录:os.path.join(base_dir,截图,today)}# 批量创建目录forpathinpaths.values():os.makedirs(path,exist_okTrue)# 生成具体文件路径result_fileos.path.join(paths[结果目录],f{platform}_{data_type}_{today}.xlsx)log_fileos.path.join(paths[日志目录],f{platform}_{today}.log)return{结果文件:result_file,日志文件:log_file,截图目录:paths[截图目录],日期:today}# 影刀RPA中调用# paths init_file_paths(拼多多, 商品数据)# 后续所有指令引用 paths[结果文件] 等变量影刀RPA社区版不支持流程导出和版本管理创业版可以导出.flow文件做版本备份。建议每周导出一次流程文件用日期命名备份拼多多采集_20250626.flow。常见问题速查Q变量名用中文还是英文A纯影刀RPA指令流程推荐用中文变量名非技术人员更容易理解。如果流程中大量使用执行Python代码指令建议用英文变量名因为Python代码中引用中文变量名需要特殊处理。Q子流程应该拆到什么粒度A一个子流程只做一件事。登录是一个子流程、采集是一个子流程、写入是一个子流程。如果子流程超过20条指令说明可以继续拆。子流程嵌套不超过3层。Q旧流程不规范怎么重构A不要一次性重写按模块逐步替换。先把变量名改成规范命名再加注释最后拆子流程。每改一个模块就测试一次确保不影响现有功能。Q团队多人协作怎么管理流程A影刀RPA创业版支持团队协作流程存在云端可多人查看。但同时编辑需要锁定。建议每人负责独立的流程模块通过子流程调用组合。公共流程由一个人维护。推荐资源影刀RPA官方文档 - 子流程与流程管理章节《代码整洁之道》Robert Martin著虽然是讲编程的但命名和注释理念通用影刀RPA社区搜索流程规范有团队分享的完整规范文档模板#影刀RPA #RPA自动化 #流程规范 #日志系统 #多任务调度作者林焱本文为《影刀RPA学习手册》系列文章之一内容源于实操经验的整理与分享。