本文介绍如何使用 Jenkins Job Builder（JJB）将已定义的文件夹（folder 类型 job）正确添加至列表视图（list view），关键在于通过 job-name 字段显式声明文件夹名称并启用 recurse: true。
本文介绍如何使用 jenkins job builder（jjb）将已定义的文件夹（folder 类型 job）正确添加至列表视图（list view），关键在于通过 `job-name` 字段显式声明文件夹名称并启用 `recurse: true`。
在 Jenkins Job Builder 中，文件夹（project-type: folder）本质上是一种特殊类型的 job，而非传统意义上的视图容器。因此，不能通过 folder 或 defaults 等字段将其“挂载”到视图中——视图（如 list 类型）仅通过 job-name 显式引用的 job（含文件夹 job）来组织内容。
要使文件夹出现在视图中，需在 view 定义中明确将其名称加入 job-name 列表，并设置 recurse: true 以支持递归显示其内部子 job（例如文件夹下的流水线、多分支流水线等）。正确配置如下：
- job:
name: jobsBuilderFolder
project-type: folder
- view:
name: jobsBuilderView
view-type: list
job-name:
- jobsBuilderFolder
recurse: true⚠️ 注意事项：
- job-name 是一个列表，可同时添加多个 job 或文件夹名称（如 - MyPipelineJob, - jobsBuilderFolder）；
- 若省略 recurse: true，视图仅显示文件夹本身（作为一项条目），但不会展开显示其内部的子 job；
- 文件夹 job 必须先于 view 定义（JJB 按顺序解析），否则可能因未声明而报错；
- 不支持在 view 中直接嵌套 folder: 或 defaults: 配置——这些仅作用于 job 层级，对视图无效。
完成配置后，运行 jenkins-jobs update 即可同步变更。刷新 Jenkins 页面，你将在 jobsBuilderView 中看到 jobsBuilderFolder 条目，点击进入即可浏览其下所有子任务（前提是 recurse: true 已启用且子 job 已正确定义）。这是 JJB 实现模块化、分层视图管理的标准实践。
