获取变量 (Get Variable)

• 分类: 变量
• 内部 ID: get_variable

节点功能

从当前蓝图的上下文中获取指定名称的变量值。

入参

端口名称	内部 ID	类型	说明
变量名	name	字符串 (STRING)	要读取的变量名称。

出参

端口名称	内部 ID	类型	说明
值	value	任意 (ANY)	变量当前存储的值。如果变量不存在，则输出空字符串。

逻辑规则

1. 变量读取：
   • 节点会从 NodeContext 的 variables 映射中查找对应的变量名。
   • 对应代码实现：

     String name = TypeConverter.toString(NodeLogicRegistry.evaluateInput(node, "name", ctx));
     if (name == null || name.trim().isEmpty()) return "";
     return ctx.variables.getOrDefault(name.trim(), "");

2. 名称处理：在查找前，会自动去除变量名首尾的空格（.trim()）。
3. 默认值：如果指定的变量名未被设置过，或者变量名为有效空值，节点将返回空字符串 ""。
4. 纯数据节点：该节点没有执行引脚，属于数据驱动节点，在其他节点引用其输出时即时计算。