Jenkins Git插件克隆时depth与shallow选项的区别是什么？

核心差异 #

• shallow: true：启用浅克隆，默认只拉取最新的1次提交，对应Git原生命令 git clone --depth 1，完全不会获取更早的提交历史，克隆速度最快。
• depth: n：指定浅克隆的深度为n（n为大于1的整数），会拉取最近n次的提交记录，对应Git命令 git clone --depth n。它本质是对浅克隆功能的精细化配置，允许你获取有限数量的历史提交。

参数关联说明 #

当你配置depth: n时，Jenkins Git插件会自动启用浅克隆（等价于同时开启shallow: true）；而单独设置shallow: true时，默认使用深度1的浅克隆。

适用场景 #

• 仅需最新代码完成构建任务：用shallow: true即可，最大化克隆效率。
• 需要最近几次提交的历史做变更分析、版本对比：使用depth: n指定具体深度，在速度和历史完整性之间取得平衡。

注：Jenkins Git插件官方文档未单独列出depth: n选项，是因为它属于浅克隆功能的附属配置，通常在勾选浅克隆后才会暴露该参数设置项。

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