外观
12 跳转文件节点
跳转文件节点把当前流程连接到项目内另一个脚本的入口。它不是普通流程节点:没有识别、动作、节点属性或执行后配置,也没有成功/失败输出。

创建与配置
- 在星链画布空白处短按右键,选择 跳转文件。
- 选中蓝色跳转节点,在 基本 > 脚本 选择目标。
- 从普通节点的成功或失败输出连接到跳转节点的 进入 输入;需要回跳语义时连接 回跳 输入。
- 确认目标脚本有脚本入口或至少一个可执行节点。
| 参数 | 格式 | 默认/空值 | 必填与显示 | 运行影响与示例 |
|---|---|---|---|---|
| 脚本 | 项目内脚本下拉选择 | 未选择脚本 | 必填;仅跳转文件节点显示 | 将连线直接解析到目标脚本入口,例如选择登录流程 |
当前脚本不会出现在可选目标中,因此不能新建自跳转。目标脚本重命名时引用会跟随更新;目标被删除或引用失效时,下拉框保留带 已失效/未绑定 标记的旧名称并显示错误。
导出与循环校验
运行前会把用到的目标脚本合并到当前流程。未连接且不是入口的跳转节点不会引入目标脚本;真正被连线使用或作为入口的跳转节点必须有效。
以下情况会阻止运行:
- 未选择目标、目标已删除或目标脚本不存在。
- 跳转到当前脚本。
- 目标脚本没有可执行节点。
- 脚本依赖形成循环,例如 A 跳到 B、B 又跳到 A。
- 多个脚本入口连续跳转并形成入口循环。
脚本入口和项目开始节点是不同概念:全项目只有一个开始节点,普通运行与打包从它启动;跳转文件始终进入所选目标脚本的脚本入口。目标正好是开始节点所在脚本时,该开始节点也作为该脚本入口。
常见错误
- 把跳转节点当作普通节点配置识别或动作:它只选择目标脚本。
- 目标脚本为空:至少要有一个可执行节点。
- 删除目标脚本后忽略红色错误:重新选择有效脚本或删除跳转节点。
- 用脚本互跳代替受控循环:跨脚本依赖循环会被导出校验拒绝。