需正确配置禅道的版本与迭代功能：迭代在项目模块创建并关联需求，版本在产品模块创建并关联已关闭迭代中的验收需求，二者通过执行视图联动，支持自动关联规则提升效率。

如果您在禅道中需要组织阶段性交付、按周期推进需求实现，并确保每个发布版本对应明确的功能范围，则需正确配置和使用版本与迭代功能。以下是具体操作路径与方法：

一、理解版本与迭代的定位差异

在禅道中，“迭代”（也称“冲刺”）是项目执行层面的时间单元，用于承载一个周期内需完成的需求与任务；而“版本”是产品层面的交付标识，代表一组已完成并准备上线的功能集合。二者需通过执行视图中的关联操作建立映射关系，不可混淆创建位置或用途。

1、迭代在项目 → 冲刺/迭代页面创建，属于执行模块；

2、版本在产品 → 版本页面创建，属于产品模块；

3、版本必须关联已关闭的迭代中完成的需求，否则无法体现真实交付内容。

二、创建迭代并关联需求

迭代是驱动开发节奏的核心单元，其创建必须绑定具体项目，并明确起止时间与所含需求。

1、进入目标项目详情页，点击左侧菜单栏的冲刺/迭代；

2、点击右上角添加迭代按钮；

3、填写迭代名称、起止日期，下拉选择关联的产品（若项目已关联产品）；

4、在“关联需求”区域，勾选该迭代计划实现的已评审通过的需求条目；

5、点击保存，迭代即生成并在执行列表中显示为待启动状态。

三、创建版本并关联迭代成果

版本用于固化某次交付范围，必须基于已完成迭代中确认验收的需求进行构建，确保可追溯、可验证。

1、切换至产品模块，选择对应产品后点击顶部版本标签；

2、点击添加版本按钮；

3、填写版本号（如 v1.2.0）、发布日期、描述信息；

4、在“关联需求”区域，点击从迭代中选择，系统将列出该项目下所有已关闭的迭代及其包含的已关闭需求；

5、勾选本次版本拟发布的全部需求，确保无遗漏且无未验收项；

6、保存后，该版本即出现在版本列表中，并自动同步显示所含需求数量及状态分布。

四、通过执行视图联动查看版本与迭代关系

执行视图是串联项目、迭代、任务、需求、Bug与版本的关键枢纽，所有交付物在此形成闭环。

1、点击任一已创建的迭代名称，进入该执行详情页；

2、在页面右侧“相关对象”面板中，确认已关联的版本是否已填入；

3、若未关联，点击关联版本按钮，从下拉列表中选择对应版本；

4、关联成功后，该版本将显示在迭代页顶部横幅中，并支持一键跳转至版本详情；

5、返回版本详情页，可查看该版本下所有来源迭代、各迭代完成率、关联Bug解决率等聚合数据。

五、设置默认版本策略与自动关联规则

为减少重复操作、统一管理习惯，可在后台配置版本生成逻辑，使新版本自动捕获指定条件下的迭代成果。

1、管理员登录后，进入后台 → 自定义 → 流程；

2、找到“产品”分类下的版本设置区块；

3、启用自动关联最近关闭迭代中的已验收需求选项；

4、设定触发条件：如“迭代状态变更为已关闭且验收人确认后24小时内”；

5、保存配置，后续手动创建版本时，系统将预填充匹配条件的迭代需求清单，仅需复核确认即可。