Jenkins多配置项目：主节点额外检出为何必要？能否关闭？

我之前也碰到过这个疑问，特意研究了下Jenkins的底层逻辑，这个主节点的额外检出其实是有它的设计初衷的：

为什么会有这次额外检出？ #

• 动态生成矩阵配置：如果你的项目需要从代码仓库里读取配置来生成矩阵（比如用脚本定义要构建的平台、编译器组合），Jenkins必须先在主节点检出代码，才能解析这些配置生成完整的矩阵作业列表。跳过这一步的话，Jenkins可能无法确定要跑多少个矩阵任务，或者生成的配置不完整。
• 全局预处理优化：有些项目会有通用的前置操作，比如生成共享构建脚本、打包跨平台依赖。主节点先检出完成这些工作，再把资源分发给各个矩阵节点，能避免每个节点重复做同样的事，反而能节省整体构建时间——当然，如果你的项目没有这类需求，这一步就显得多余了。
• 插件兼容性遗留：部分老版本的SCM或矩阵相关插件，设计上依赖主节点的初始检出才能正常运行，尤其是那些需要在矩阵生成阶段访问代码内容的插件。

能不能关闭？当然可以！ #

如果你的项目不需要上述这些前置操作，关闭主节点的额外检出确实能节省磁盘空间和检出时间，具体操作分两种场景：

场景1：使用Pipeline矩阵项目（Jenkinsfile） #

直接在流水线的options块里添加skipDefaultCheckout()，然后在每个矩阵节点的stage里手动执行检出即可，示例代码如下：

pipeline {
    agent none
    options {
        skipDefaultCheckout() // 跳过主节点的默认检出
    }
    stages {
        stage('Multi-Platform Build') {
            matrix {
                agent { label "${PLATFORM}-${COMPILER}" }
                axes {
                    axis { name 'PLATFORM'; values 'Windows', 'Linux' }
                    axis { name 'COMPILER'; values 'VS2022', 'GCC12' }
                }
                steps {
                    checkout scm // 每个矩阵节点独立完成检出
                    // 后续构建步骤...
                }
            }
        }
    }
}

场景2：使用传统多配置项目（Matrix Project） #

在项目配置页面的源代码管理模块里，点击「高级」按钮，找到类似「Skip initial checkout on master」或者「不执行主节点初始检出」的选项并勾选即可。

⚠️ 注意：关闭前一定要确认这几点：

• 你的矩阵配置是静态定义的，不需要从代码仓库读取动态配置；
• 没有依赖主节点的全局预处理操作，每个矩阵节点可以独立完成检出和构建；
• 你使用的Jenkins及插件版本支持跳过主节点检出，不会出现兼容性问题。

内容的提问来源于stack exchange，提问作者tcdaniel