Jenkins中获取Git更新变更文件：命令/插件/参数选择及最佳方案

作为常年跟Jenkins和Git打交道的老司机，我来给你拆解这几个方案的优劣，以及最适合的选择：

1. 直接用Git命令获取 #

这是最轻量化的方案，不需要额外依赖，完全靠Jenkins内置的环境变量+Git命令实现。

Jenkins在配置了Git源码管理的任务中，会自动注入一系列和Git相关的环境变量，比如：

• GIT_COMMIT：当前构建对应的最新提交哈希
• GIT_PREVIOUS_SUCCESSFUL_COMMIT：上一次成功构建对应的提交哈希
• GIT_BRANCH：当前构建的分支名称

你可以在Jenkins的「执行shell」（Windows用「执行Windows批处理命令」）步骤里，直接写Git命令来获取两次构建之间的变更：

# 判断是否是第一次构建（上一次成功提交为空）
if [ -z "$GIT_PREVIOUS_SUCCESSFUL_COMMIT" ]; then
  # 第一次构建，显示最近10条提交记录
  git log --pretty=format:"%h | %s | %an" -10
else
  # 显示两次成功构建之间的所有提交
  git log --pretty=format:"%h | %s | %an" $GIT_PREVIOUS_SUCCESSFUL_COMMIT..$GIT_COMMIT
fi

优缺点：

• ✅ 优点：零插件依赖，灵活度拉满，能自定义任何Git log格式，适合需要精细控制输出的场景
• ❌ 缺点：需要自己处理边界情况（比如第一次构建），对Git命令不熟悉的话可能会踩坑

2. 使用Jenkins插件 #

如果需要更省心的可视化配置，或者要和Jenkins的其他功能联动，插件会是更好的选择。常用的插件有这几个：

• Git Changelog Plugin：专门用于生成Git变更日志，支持自定义输出格式（文本、HTML、JSON），还能过滤提交（比如只显示合并提交、特定作者的提交），甚至可以把变更日志集成到邮件通知、Slack消息里。
• SCM Changelog Plugin：更通用的SCM变更日志插件，支持Git、SVN等多种版本控制工具，适合多SCM环境的团队。

配置起来很简单：在任务的「构建步骤」或「构建后操作」里添加插件的步骤，然后在界面上选择要显示的提交信息、格式即可，完全不用写命令。

优缺点：

• ✅ 优点：可视化配置门槛低，能快速生成美观的变更报告，和Jenkins生态联动性强
• ❌ 缺点：需要安装额外插件，插件更新可能带来兼容性问题，极端自定义需求不如Git命令灵活

3. 利用Jenkins配置参数 #

这里说的不是手动输入的参数化构建，而是Jenkins内置的SCM参数（也就是前面提到的GIT_COMMIT这类环境变量）。如果你是手动触发构建，也可以设置参数化构建，比如添加两个字符串参数START_COMMIT和END_COMMIT，然后在构建步骤里用git log $START_COMMIT..$END_COMMIT来获取指定范围的变更。

不过这种方式更适合手动指定提交范围的场景，自动构建的话，还是用Jenkins自动注入的环境变量更省心。

推荐方案 #

没有绝对完美的方案，得看你的需求：

• 如果只是需要在构建日志里输出变更，或者把变更写入文件，优先选Git命令+Jenkins内置环境变量，轻量化且灵活，处理好第一次构建的边界情况就行。
• 如果需要生成可视化的变更报告、和邮件/Slack联动，或者团队成员不太熟悉Git命令，推荐用Jenkins插件，配置简单，能快速满足协作场景的需求。

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