如何避免Jenkins内置checkout丢失Git提交的文件变更

首先纠正一个误解：git checkout -f <commit hash>不会删除变更历史或生成新的提交哈希，它只是强制让工作区和暂存区完全匹配目标提交的状态，覆盖本地的未提交修改而已。你遇到的问题根源是：Jenkins直接checkout到单个提交时，仓库处于「分离头指针」状态，此时HEAD就是当前提交，没有可对比的前序提交，所以git diff HEAD自然只会返回本地流水线的修改，拿不到该提交本身的变更。

下面是具体的解决方法：

• 调整Jenkins checkout配置，拉取完整历史
  在Jenkins的Git插件配置里，勾选「Fetch all branches」「Fetch tags」选项，或者在checkout阶段先执行git fetch origin <your-branch>再checkout目标提交。这样本地仓库会包含分支的完整提交历史，之后执行git diff --name-only --submodule=diff HEAD^ HEAD就能拿到当前提交相对于父提交的所有变更文件。

• 直接对比当前提交与它的父提交
  如果无法修改Jenkins的checkout逻辑，就在diff命令里明确指定对比对象：

  • 普通提交用：git diff --name-only --submodule=diff HEAD^ HEAD
  • 如果是合并提交（有两个父提交），可以指定对比第一个父提交：git diff --name-only --submodule=diff HEAD^1 HEAD，或者根据需求选择第二个父提交HEAD^2。

• 手动拉取父提交历史
  在Jenkins checkout之后，执行git fetch origin <commit-hash>^1来拉取当前提交的父提交到本地，之后再执行diff命令也能正常获取变更。

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