影刀RPA新手教程：变量未定义报错完全指南——为什么说变量不存在

影刀RPA新手教程：变量未定义报错完全指南——为什么说变量不存在

那个让我卡了两小时的变量

记得我第一次写带循环的流程时，被一个变量报错卡了整整两小时。

流程逻辑很简单：从一个Excel里读10行数据，每一行去网页上查东西，然后把结果写回Excel。

你猜怎么着？第一步就报错了。

报错信息：“变量未定义”。

我盯着那条报错看了半天：变量？什么变量？我明明没用到什么变量啊。

后来我才明白，我不但用了变量，用了还不止一个——只是影刀帮我取了名字。

这篇文章，我用一个"Excel读取报变量未定义"的案例，把所有变量问题讲清楚。

案例主线：Excel循环读取中变量未定义

流程是这样的：

1. 用"打开Excel"指令打开一个用户名单
2. 用"读取Excel行"指令读取当前行的"用户名"列
3. 将这个用户名输入到网页搜索框
4. 查询结果并写回Excel

运行时，第二步就报"变量未定义"。

原因：我没有先创建一个变量来接收"用户名"的列值。

影刀变量的三种创建方式

影刀里变量不是凭空出现的，你必须声明它。

方式一：用"设置变量"指令。

在流程编辑器中拖一个"设置变量"指令进来。

变量名填username，变量值可以先填空。

然后你后面就可以用username了。

方式二：指令返回值自动存到变量。

你拖一个"读取Excel行"指令，右边的属性面板有个"保存到"选项。

在那个下拉框里选"新变量"，影刀会让你给它命名。

如果你这里选了"忽略"，那读出来的值就被扔掉了——后面再用这个值就会报"变量未定义"。

方式三：在Python代码块里定义。

result=my_function()# 然后用影刀的"获取Python变量"指令把result取出来

我当时犯的错误就是方式二——“保存到"选了"忽略”。

变量作用域问题

即使定义了变量，用的时候也可能报"未定义"。

因为变量有"作用域"。

在影刀里，变量默认在整个流程里都能用。

但如果你在"子流程"里定义了一个变量，主流程是拿不到的。

解决方法：在影刀中子流程用"返回值"传数据。

子流程编辑完后，点右上角设置：

输出参数：设置一个输出变量，比如result

主流程里调用子流程时，保存返回值：

调用子流程 -> 保存结果到变量data

这样data就可以在主流程里用了。

反过来也一样，主流程的变量要传给子流程，也是在调用时作为"输入参数"传递。

循环里的变量覆盖问题

这是另一个常见的坑。

names=['张三','李四','王五']foriinrange(len(names)):current_name=names[i]print(current_name)

这个代码没问题对吧？

但在影刀里，循环中用"设置变量"要小心。

你必须在循环外先定义变量（哪怕赋个空值），然后在循环内修改它。

不这样做的话，每次循环都会"重新创建"这个变量，导致一些奇怪的问题。

我习惯这样：

在循环外：设置变量current_cell，值为空
开始循环 Excel行
设置变量current_cell，值为当前行的"用户名"列
… 其他操作 …
结束循环

变量名写错了

这是最蠢但最常见的错误。

比如你定义了一个变量叫userName，后面写成了username。

大小写不一样，影刀认为这是两个不同的变量。

或者你定义的是username，后面写成了user_name。

解决方法：善用影刀的变量面板。

在流程编辑器的左边或右边有个"变量"面板（找一下小图标）。

点开它，你能看到当前流程里所有已经定义的变量。

用变量时从这里拖进去，绝对不会写错。

从网页抓取的数据变量未定义

这个比较特别。

我用"获取元素文本"指令抓了网页上一个价格。

影刀自动把它存到了一个变量里。

但当我在下面用这个变量做计算时，报错"变量未定义"。

原因：获取元素那一步因为网页变化执行失败了（被跳过了）。

失败了当然没有返回值，变量没被创建。

解决方法：在获取元素前加判断。

# 伪代码ifelement_exists:price=get_text(element)else:price=0# 给一个默认值

在影刀里这样做：

等待元素出现（价格元素，超时10秒）
获取元素文本 -> 保存到price
如果获取失败 -> 设置变量price为"0"

安装和工程化规范里的变量管理

刚开始写影刀时，我随便给变量起名：a、b、temp、xxx。

后来一个流程里有了几十个变量，我自己都分不清哪个是干什么的。

现在我有自己的命名规范：

• 读Excel的变量叫excel_row_xxx
• 网页抓取的值叫web_xxx
• Python计算的中间值叫calc_xxx
• 临时变量叫temp_xxx

变量多了以后，在每个子流程的开头写好注释：

# 本子流程变量： # excel_price: 从Excel读取的价格（数字类型） # web_name: 从网页抓取的商品名（字符串） # calc_total: 计算结果（数字类型）

这个习惯让我省了很多排查时间。

变量未定义排查三步走

第一步：在变量面板里搜这个变量名。

没搜到就是没定义，回到前面补上"设置变量"。

第二步：搜到了但报错，检查作用域。

是不是在子流程里定义的？按前面的方法用返回值传出来。

第三步：看报错位置的前一行。

是不是前一步操作失败了（执行跳过了），导致变量没被赋值？

如果是，给变量写个默认值。

关于变量管理和数据类型转换的技巧，我更详细地整理在 home.linyan.cloud 上。

#影刀RPA #RPA教程 #变量 #数据类型 #错误排查 #新手入门 #Python #流程控制 #Excel操作 #工程规范

作者：林焱