Jenkins Multibranch Pipeline：新建分支时仅检出新增/修改文件方法咨询

针对大型项目中使用Multibranch Pipeline时，新建分支想要仅检出与指定基准分支相比的新增/修改文件的需求，下面是几个可行的实操方案：

方案一：自定义Git命令实现增量检出 #

Multibranch Pipeline默认的checkout scm会全量拉取新建分支的所有内容，你可以跳过默认检出，用手动Git命令组合来实现增量：

1. 初始化并拉取基准分支与目标分支
   先确保工作区关联远程仓库，并拉取基准分支（比如main或develop）和新建分支的最新代码：

   sh '''
       git init
       git remote add origin <你的仓库地址>
       git fetch origin <基准分支名>:<基准分支名>
       git fetch origin <新建分支名>:<新建分支名>
   '''
   

2. 检出基准分支作为基础
   将工作区切换到基准分支的最新状态，以此作为增量对比的基准：

   sh 'git checkout <基准分支名>'
   

3. 计算并检出差异文件
   对比基准分支和新建分支的差异，只检出新增或修改的文件：

   sh '''
       # 获取差异文件列表
       DIFF_FILES=$(git diff --name-only <基准分支名> <新建分支名>)
       # 如果有差异文件，从新建分支检出这些文件
       if [ -n "$DIFF_FILES" ]; then
           git checkout <新建分支名> -- $DIFF_FILES
       fi
   '''
   

   注：如果需要处理文件删除的情况，可以在git diff后添加--diff-filter=D捕获删除的文件，再用rm命令清理，根据实际需求调整即可。

方案二：复用已有基准分支工作区（共享工作区场景） #

如果你的Jenkins代理是复用工作区的（而非每个分支独立工作区），可以在新建分支构建前，先确保工作区处于基准分支的最新状态，再拉取新建分支的增量：

1. 重置工作区到基准分支

   sh '''
       git fetch origin
       git checkout <基准分支名>
       git reset --hard origin/<基准分支名>
   '''
   

2. 拉取新建分支的增量变更
   直接将新建分支的变更合并到当前工作区，自动同步相对于基准分支的所有变更：

   sh 'git pull origin <新建分支名>'
   

   这种方式适合工作区复用的场景，能自动完成增量更新。

注意事项 #

• 确保Jenkins代理有足够权限执行Git命令，仓库地址、分支名配置准确。
• 若为每个分支独立工作区的Multibranch场景，方案一的可控性更强——新建分支工作区为空时，先拉取基准再增量检出，可避免全量克隆的耗时。
• 超大型项目可配合Git浅克隆（git fetch --depth 1）减少历史数据拉取量，进一步提升效率。

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