如何通过Jenkins从GitHub读取文件并判断文件是否存在

针对你遇到的问题，这里提供两种可靠的实现方式，同时解决你第二次尝试时的语法错误：

一、修正git show检测方法（推荐） #

你之前的git show命令报错是因为引号嵌套和变量解析逻辑错误，在Jenkins Groovy脚本的sh块中，Groovy会先解析${params.value}，不需要额外给变量套引号，正确的写法是用引号包裹整个Git路径参数（避免文件名含空格时出错）。

完整示例代码：

sshagent (credentials: ["${github_cred}"]) {
    script {
        sh "git checkout test_branch"
        
        // 检测目标文件是否存在于当前分支
        def fileExists = sh(
            script: "git show 'HEAD:myrepo/${params.value}.txt' > /dev/null 2>&1",
            returnStatus: true
        ) == 0
        
        if (fileExists) {
            // 文件存在，执行后续逻辑
            def fileContent = readFile(file: "myrepo/${params.value}.txt") // 用工作区相对路径，而非绝对路径
            echo "读取到文件内容：${fileContent}"
            // 其他后续步骤...
        } else {
            // 文件不存在，跳过当前阶段
            echo "文件 myrepo/${params.value}.txt 不存在，跳过当前阶段"
            currentBuild.result = 'UNSTABLE' // 可选：标记构建状态为不稳定
            return // 终止当前阶段的后续执行
        }
    }
}

关键说明： #

1. returnStatus: true：让sh步骤返回命令的退出码（0=成功/文件存在，非0=失败/文件不存在），而非抛出异常。
2. Git路径写法：HEAD:myrepo/${params.value}.txt表示当前分支（HEAD指向的提交）下的目标文件路径，不需要加根路径/。
3. readFile路径：使用工作区相对路径即可，因为git checkout后仓库内容已在当前工作区下。

二、更轻量的git ls-files检测方法 #

如果只需要检测当前分支的索引中是否存在该文件（无需验证文件内容是否存在于远程），可以用git ls-files命令，性能更优：

def fileExists = sh(
    script: "git ls-files --error-unmatch 'myrepo/${params.value}.txt' > /dev/null 2>&1",
    returnStatus: true
) == 0

为什么fileExists步骤不可行？ #

Jenkins内置的fileExists步骤仅检测当前节点本地文件系统的文件，若你的流水线运行在代理节点上，而你在控制器节点执行fileExists，或者仓库未完整克隆（如浅克隆），就会出现检测不准确的情况。而通过Git命令直接查询仓库的提交内容，无需依赖本地文件系统，更可靠。

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