手把手教你玩转正Coze循环功能：3种模式+避坑指南
最近在用Coze搞自动化的同学，是不是经常遇到需要重复处理一堆数据的情况？比如批量生成10张产品图、给20个用户发消息，手动搞太费劲了。今天咱们就用最接地气的方式，把Coze循环功能讲明白——3种模式怎么选、4步上手数组循环、1个实战案例带你飞，再加上我踩过的3个坑，保证你看完就能上手！
一、3种循环模式：别选错！不然白忙活
Coze的循环功能就像个"自动复读机"，但不同模式适合不同场景，选错了可能流程直接卡死，咱们一个一个说：
1. 数组循环（最常用！）
原理：就像逛超市清单，清单上有几个商品（数组元素），就循环几次。比如清单是["苹果","香蕉","橙子"]，就自动处理3次，每次拿一个水果出来干活。
场景：批量处理数据（生成图片、发消息、存数据库），只要你有个列表类的数据，选它准没错。
2. 指定次数循环
原理：固定循环N次，比如设置"循环3次"，不管有没有数据都跑3遍。
场景：API调用失败重试（固定重试3次）、定时任务（每天跑5次数据同步），次数明确的活儿用这个。
3. 无限循环（慎用！）
原理：一直跑直到你喊停，必须搭配"终止循环"节点，不然会无限执行（别问我怎么知道的，之前忘了加终止条件，2小时生成10万条垃圾数据...）。
场景：实时监控（比如每5秒查一次服务器CPU，超过80%就报警并停循环）、持续抓数据（直到抓到目标内容才停）。
二、手把手实操：用数组循环批量生成水果文案（附截图）
咱们拿最常用的"数组循环"举例子，从0到1实现"批量生成水果介绍文案"，4步搞定：
1. 准备循环数据（数组！数组！数组！）
循环必须喂数组格式的数据，不然Coze不认。最简单的办法是用"代码节点"生成，比如咱们要处理3种水果，代码这么写：
// 代码节点里直接复制这个，生成一个水果数组
async function main({ params }: Args): Promise<Output> {
return {
fruits: ["苹果", "香蕉", "橙子"] // 数组变量名随便起，后面要用
};
}
如果不想写代码，也能用大模型节点，提示词就说"输出JSON格式数组，比如['苹果','香蕉','橙子']"，让AI给你生成数组。
2. 添加循环节点（重点看截图！）
从左边节点栏拖一个"循环"节点到画布，然后配置3个关键参数（看图更清楚）：
- 循环类型：选"数组循环"
- 循环数组：选上一步生成的数组变量（比如刚才的
fruits） - 循环变量名：随便起个名（比如
item，代表当前循环到的水果，后面要用）
坑点提醒：变量名别拼错！之前见过有人写成itme，结果循环体内死活调不到数据，排查半天才发现...
3. 设计循环体（每次循环干啥活）
循环体就是"每次循环要做的事"，比如给当前水果生成文案。咱们拖个"大模型节点"到循环节点的"循环体"区域，提示词这么写：
"给{{item}}写一段200字介绍，突出口感和营养，语气活泼点"
这里的{{item}}就是刚才设置的循环变量，会自动替换成当前水果（第一次是苹果，第二次香蕉...）。
如果需要更复杂的操作，比如生成文案后再生成图片、存数据库，直接往循环体里加节点就行，Coze会自动按顺序执行。
4. 配置循环输出（别让结果丢了！）
循环跑完总得把结果收起来吧？在循环节点的"输出"设置里，选你要收集的变量（比如大模型生成的文案content），然后选"聚合方式"：
- 想一次性拿到所有结果（比如生成10张图的URL列表）→ 选"数组"
- 想拼成一段文字（比如"苹果：...；香蕉：...") → 选"拼接字符串"
必看：如果忘了配置输出，循环体跑半天结果全丢了，等于白干！
三、实战案例：3分钟生成3个星座漫画（工作流截图）
光说不练假把式，咱们搞个实际能用的：批量生成星座漫画图文，输入星座列表，自动出文案+图片+排版，直接丢公众号草稿箱。
工作流长这样（简化版）：
- 开始节点：输入星座列表
["白羊座","金牛座","双子座"] - 循环节点：选数组循环，变量名
star - 循环体：
- 大模型节点：
"给{{star}}生成漫画文案，突出性格特点，比如白羊座：'热情似火的勇士...'" - 图像生成节点：用文案生成对应漫画图
- 画板节点：把文案和图片拼一起
- 大模型节点：
- 输出节点：收集所有画板图片，拼成公众号图文
跑起来后，3分钟搞定3个星座的图文，比手动做快10倍！
四、避坑指南：3个新手必踩的坑（血的教训）
1. 死循环！死循环！死循环！
- 无限循环必须加终止条件：别学我之前忘了加，平台可能直接限制你的工作流（血的教训）。
- 数组循环别改原数组：循环体里别删改原数组（比如
fruits.pop()），会导致循环次数乱掉，建议先复制一份数组用。
2. 变量作用域搞不清
循环体内的变量只在当前循环有效！比如在循环体里定义temp=1，下次循环temp会重置。如果要累计数据（比如求和），得用"中间变量"节点，在循环体外定义total=0，每次循环后total=total+当前值。
3. 一次别跑太多数据
Coze对循环次数有限制，单次循环别超过500次，循环体里有图像生成、视频处理这种"重活"时，建议拆成小批量（比如100次一批，中间加个"延迟节点"等10秒），不然容易崩溃。
最后说两句
循环功能其实就是Coze的"自动化引擎"，学会了批量处理数据、定时任务、实时监控都能搞。记住：工具是为了省时间，别沉迷调参数，能用就行～ 有问题评论区问，我看到就回！
（参考资料：Coze循环节点官方文档）
