如何将GIT_COMMIT变量传递至Jenkins Pipeline中

Jenkins 内置SCM步骤完成代码检出后，会自动将当前检出的commit ID注入流水线环境变量，不需要额外写复杂逻辑爬取，按你当前的两步流水线结构，对应两种场景处理即可：

• 场景1：用Jenkins内置git/checkout scm步骤拉取代码
  检出步骤执行完成后，直接通过env.GIT_COMMIT就能拿到完整的commit ID，直接传入后续shell步骤即可，参考写法：

pipeline {
    agent any
    stages {
        stage('检出代码') {
            steps {
                // 替换成你实际的检出配置
                git branch: 'main', credentialsId: '你的凭证ID', url: '你的仓库地址'
                // 调试阶段可以加这行打印确认值，验证没问题可以删掉
                echo "当前构建对应commit ID：${env.GIT_COMMIT}"
            }
        }
        stage('生成发布CodeQL报告') {
            steps {
                // 注意这里sh后面要用三个双引号，单引号不会解析流水线变量
                sh """
                    # 替换成你实际的CodeQL执行、上传命令
                    codeql database create codeql-db --language=java
                    codeql database analyze codeql-db --format=sarif-latest --output=codeql-result.sarif
                    codeql github upload-result --commit="${GIT_COMMIT}" --sarif=codeql-result.sarif
                """
            }
        }
    }
}

• 场景2：直接在shell里执行git clone手动拉取代码，没有用Jenkins内置SCM步骤
  这种场景Jenkins不会自动注入GIT_COMMIT变量，拉完代码后直接通过git命令取最新commit ID，存到流水线环境变量给后续步骤用即可，参考写法：

pipeline {
    agent any
    stages {
        stage('检出代码') {
            steps {
                sh 'git clone 你的仓库地址 source-code'
                script {
                    // 取HEAD指向的commit ID，trim()用来去掉输出末尾的换行、多余空格
                    env.GIT_COMMIT = sh(
                        script: 'cd source-code && git rev-parse HEAD',
                        returnStdout: true
                    ).trim()
                }
                echo "手动获取的commit ID：${env.GIT_COMMIT}"
            }
        }
        stage('生成发布CodeQL报告') {
            steps {
                sh """
                    cd source-code
                    # 替换成你实际的CodeQL命令，直接引用GIT_COMMIT即可
                    codeql github upload-result --commit="${GIT_COMMIT}" 其余上传参数
                """
            }
        }
    }
}

常见踩坑提醒：

1. 给sh步骤传流水线变量时，必须用双引号包裹脚本内容，单引号会把${变量名}当成普通字符串，不会做值替换
2. 用returnStdout接收命令输出时一定要加.trim()，否则输出末尾的换行符会导致后续命令参数解析错误
3. 如果你的检出步骤和CodeQL步骤跑在不同的agent节点上，记得把GIT_COMMIT存在顶层环境变量里，不要只在步骤内定义局部变量，避免跨步骤取不到值

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