Break

Break 用于在循环控制的循环体内立即跳出当前循环，终止整个循环的执行，然后继续运行循环之后的节点。常用于「找到目标后提前退出」或「遇到错误时停止处理」。Break 必须在 For 或 While 循环体内使用。

指令标识：Break
指令类型：逻辑控制指令
指令描述：立即跳出当前循环，终止循环执行

先选使用方式

Break 是循环体内的流程控制指令，无需任何参数。

方式	怎么用	适合人群
可视化编排（推荐）	在循环体内（通常配合 IF）拖入 `Break` 节点	大多数用户
代码编排（Python）	直接使用 Python 原生的 `break` 语句	熟悉代码的用户

什么时候用？

在遍历中找到目标元素后，不需要再继续遍历。
循环中遇到错误或异常状态，需要立即停止。
满足某个终止条件时提前结束循环。

使用前确认

Break 必须位于 For 或 While 循环体内。
通常配合条件分支使用，满足条件时才执行 Break。
执行 Break 后，循环会立即结束，继续运行循环之后的节点。

可视化编排：从 0 到跑通

在循环控制节点的循环体内添加一个 IF 节点。
在 IF 命中的分支里拖入 Break 节点。
在循环之后放置后续要执行的节点。
运行并构造会触发终止的数据，确认循环在命中条件后立即停止。

参数说明

输入参数

Break 是流程控制指令，无需配置任何参数。

输出参数

无。

成功标准

Break 节点运行结束后状态为成功。
运行日志中没有参数缺失、超时或执行失败等错误。
后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象	可能原因	处理建议
`Break` 无效或报错	不在循环体内	确保 `Break` 位于 For 或 While 循环体内
循环刚开始就退出	触发 `Break` 的条件一开始就成立	检查条件配置与变量引用
循环没有提前退出	条件从未成立	检查比较规则与变量取值

Python 代码编排

代码编排以 Python 为主。在代码里，Break 直接对应 Python 原生的 break。

for item in params.get("items", []):
    if item.get("name") == "目标":
        bots.sendBusinessMessage(message="已找到目标，停止遍历")
        break  # 找到后立即跳出循环

在代码编排中无需单独的 Break 指令，直接使用 Python 的 break 即可。

常见问题

Q1：Break 和 Continue 有什么区别？

A： Break 会终止整个循环；Continue 只跳过本次迭代的剩余节点，循环继续。

Q2：嵌套循环中 Break 作用于哪一层？

A：只作用于它所在的最内层循环，不影响外层循环。