如何在Jenkins中将Git/GitHub文件内容存储到可复用变量中

实现前提是先确保Jenkins任务配置了正确的GitHub仓库拉取规则，执行构建时会先把目标仓库拉取到Jenkins节点的工作空间目录下，所有读取操作都基于拉取到本地的文件完成，不需要额外调用GitHub接口。以下是两类最常用Jenkins任务的具体实现方式：

• 先在任务配置的「源码管理」栏选择Git，填写GitHub仓库地址、访问凭证、目标分支，保存后先跑一次构建，确认代码能正常拉取到工作空间。
• 推荐用EnvInject插件实现变量跨步骤传递（绝大多数Jenkins环境默认预装该插件）：添加构建步骤，选择「Inject environment variables」，在Groovy脚本输入框填入以下代码：

def targetFile = new File("${WORKSPACE}/text.txt")
def fileContent = targetFile.getText('UTF-8')
return [TEXT_FILE_CONTENT: fileContent]

• 配置完成后，后续所有构建、部署步骤都可以直接通过${TEXT_FILE_CONTENT}（Linux节点）或者%TEXT_FILE_CONTENT%（Windows节点）调用文件完整内容。
• 如果没有安装EnvInject插件，可以用Shell/批处理先生成环境变量属性文件，再通过注入步骤加载：Linux节点添加执行Shell步骤，写入以下命令：

# 把文件内容转义后写入属性文件，处理换行、双引号等特殊字符
echo "TEXT_FILE_CONTENT=$(cat ${WORKSPACE}/text.txt | sed 's/"/\\"/g' | sed ':a;N;$!ba;s/\n/\\n/g')" > ${WORKSPACE}/temp_env.properties

之后添加「Inject environment variables」步骤，属性文件路径填${WORKSPACE}/temp_env.properties，后续步骤即可正常调用变量。

流水线实现更简单，不需要依赖第三方插件，用内置步骤即可完成，声明式流水线参考示例：

pipeline {
    agent any
    stages {
        stage('拉取GitHub代码') {
            steps {
                // 替换成你自己的仓库地址和分支
                git branch: 'main', credentialsId: '你配置的GitHub凭证ID', url: '你的GitHub仓库SSH/HTTPS地址'
            }
        }
        stage('读取text.txt内容存入变量') {
            steps {
                script {
                    // 定义全局环境变量，所有后续stage都能调用
                    env.TEXT_FILE_CONTENT = readFile(
                        file: "${WORKSPACE}/text.txt", // 如果文件不在仓库根目录，补全相对路径即可
                        encoding: 'UTF-8' // 替换成你的文件实际编码，避免乱码
                    )
                }
            }
        }
        stage('构建与部署') {
            steps {
                // 直接调用变量即可，比如先打印验证内容
                echo "读取到的text.txt内容如下：${env.TEXT_FILE_CONTENT}"
                // 后续构建、部署逻辑直接使用该变量即可
            }
        }
    }
}

常见踩坑说明

• 读取文件的步骤必须放在代码拉取步骤之后执行，否则工作空间内不存在目标文件，会抛出文件不存在异常
• 如果文件内容包含特殊字符、多行换行，上述方法会完整保留原文件格式，不要自行写逐行读取拼接的逻辑，避免内容格式破损
• Windows节点下使用自由风格项目时，Groovy读取脚本逻辑不变，文件路径替换为${WORKSPACE}\\text.txt即可；流水线的readFile步骤会自动适配不同系统的路径分隔符，无需手动调整

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