Jenkins Git插件checkout步骤忽略Git环境变量，如何启用Git追踪？

这是不是Jenkins Git插件的Bug？ #

不是Bug，这是Git插件的设计逻辑导致的。Jenkins Git插件执行checkout步骤时会创建独立的环境上下文，默认不会继承流水线中全局设置的环境变量，包括GIT_CURL_VERBOSE这类Git专用变量。

如何启用Git追踪？ #

有两种可靠的实现方式：

方式一：用withEnv包裹checkout步骤 #

通过withEnv临时为checkout步骤注入目标环境变量，确保Git命令执行时能读取到：

pipeline {
    agent any
    stages {
        stage('Checkout with Git Verbose') {
            steps {
                withEnv(['GIT_CURL_VERBOSE=true']) {
                    checkout scmGit(
                        branches: [[name: '*/main']],
                        userRemoteConfigs: [[url: 'https://your-repository-url.git']]
                    )
                }
            }
        }
    }
}

方式二：配置节点全局环境变量 #

如果需要该节点上所有Git操作都启用追踪，可在节点配置中添加全局环境变量：

• 进入Manage Jenkins → Manage Nodes → 选择目标节点 → Configure
• 在「Node Properties」中勾选「Environment variables」，添加键为GIT_CURL_VERBOSE、值为true的变量
• 保存后，该节点上的所有Git命令都会自动继承这个变量

注意：声明式流水线的environment块定义的全局变量，默认无法穿透Git插件的独立环境上下文，因此最稳妥的方式还是用withEnv包裹checkout步骤。

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