如何在Jenkins Pipeline的Jenkinsfile中正确替换Git分支名的斜杠？

你的问题出在Groovy字符串插值和Jenkins Pipeline sh步骤的使用方式上，我来拆解一下：

核心错误点 #

1. Groovy优先解析双引号中的${}：
   在Jenkinsfile（Groovy脚本）里，双引号包裹的字符串会被Groovy先解析插值。你写的sh "echo ${git_branch_name//\//_}"中，${git_branch_name//\//_}是Shell的字符串替换语法，但Groovy会把它当成自己的表达式来解析，而Groovy并不支持这种Shell风格的替换，所以直接报语法错误。

2. sh步骤赋值方式错误：
   直接用branch_name= sh "echo ..."是拿不到Shell命令的输出的，Jenkins的sh步骤默认返回的是一个步骤执行对象，要获取输出必须加上returnStdout: true参数。

两种可行解决方法 #

方法一：用Groovy原生字符串替换（推荐，更高效） #

既然已经在Groovy里拿到了git_branch_name变量，直接用Groovy的replaceAll方法做替换就行，完全不用调用Shell：

#!/usr/bin/env groovy
def commit_id
def imagetag
def branch_name
def git_branch_name
node('Nodename') { 
    stage('checkout') { 
        checkout (scm).$Branch_Param 
        sh "git rev-parse --short HEAD > .git/commit-id" 
        commit_id = readFile('.git/commit-id').trim() 
        sh "git rev-parse --abbrev-ref HEAD > .git/branch-name" 
        git_branch_name = readFile('.git/branch-name').trim() 
        // 用Groovy的replaceAll替换斜杠为下划线
        branch_name = git_branch_name.replaceAll('/', '_')
        sh "echo ${commit_id}" 
        sh "echo ${branch_name}" 
        sh "echo Current branch is ${branch_name}" 
    } 
}

方法二：正确使用Shell命令获取结果（如果一定要用Shell） #

如果坚持用Shell处理，需要避免Groovy解析Shell里的变量，用单引号包裹Shell命令，同时加上returnStdout: true来捕获输出：

#!/usr/bin/env groovy
def commit_id
def imagetag
def branch_name
def git_branch_name
node('Nodename') { 
    stage('checkout') { 
        checkout (scm).$Branch_Param 
        sh "git rev-parse --short HEAD > .git/commit-id" 
        commit_id = readFile('.git/commit-id').trim() 
        sh "git rev-parse --abbrev-ref HEAD > .git/branch-name" 
        git_branch_name = readFile('.git/branch-name').trim() 
        // 用单引号让Groovy不解析内部内容，同时捕获 stdout
        branch_name = sh(script: "echo ${git_branch_name//\//_}", returnStdout: true).trim()
        // 或者更安全的方式：把Groovy变量传递给Shell环境变量
        // branch_name = sh(script: 'echo "${GIT_BRANCH//\//_}"', returnStdout: true).trim()
        sh "echo ${commit_id}" 
        sh "echo ${branch_name}" 
        sh "echo Current branch is ${branch_name}" 
    } 
}

注：第二种方式里，如果你用双引号，需要把Groovy的$转义成\$，让Shell来处理变量，比如sh(script: "echo \${git_branch_name//\//_}", returnStdout: true).trim()，不过用单引号更直观。

为什么Shell命令未被正确解析？ #

因为Jenkinsfile是Groovy脚本，双引号字符串会触发Groovy的插值逻辑，它会尝试把${git_branch_name//\//_}当成Groovy表达式执行，但Groovy的字符串替换语法是replace或replaceAll，不是Shell的//语法，所以导致语法错误，Shell命令根本没机会被执行就被Groovy报错拦截了。

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