变量转字符串¶
类型 ID：variable.to_string。在工具分类搜索“变量转字符串”。
把普通值转换成文本，适合拼接日志、构造文字提示或保存数据。节点没有执行端口，也不会把文件路径自动加载成媒体内容。
| 方向 | 索引 | 端口 | 类型 |
|---|---|---|---|
| 输入 | 0 | 变量 | 可接字符串、布尔、整数、浮点、颜色、向量、数组、对象或枚举 |
| 输出 | 0 | 字符串 | string |
转换规则¶
| 输入 | 输出形式 |
|---|---|
| 未连接 | 空字符串。 |
| 字符串 | 保留原文。 |
| 布尔 | true 或 false。 |
| 整数、浮点 | 完整数值文本，不按界面显示位数截断。 |
| 普通 RGB 颜色 | #RRGGBB；含透明度时为 #RRGGBBAA。 |
| 浮点计算颜色 | 保留通道信息的 JSON。 |
| 坐标、向量、数组、对象、枚举 | JSON 文本。 |
图像、视频和其他媒体不能直接转成字符串；非有限数值及循环引用也不支持。需要媒体路径时，应先取得明确的文件路径，而不是把媒体对象接进来。
示例¶
当前计数 → 变量转字符串 → 字符串相加，与“已完成：”组合后显示或保存。需要在运行中更新普通变量时，仍按变量与蓝图接口读取当前值。