Jenkinsfile中自定义Groovy变量无法解析该如何正确处理？

你遇到的变量无法解析问题是由Groovy字符串插值规则和Shell变量解析的优先级差异导致的：

• 你当前使用单引号'包裹sh步骤的命令内容，Groovy不会对单引号字符串内的变量做任何插值处理，会直接将完整字符串交给Shell执行。my_dst是你在Groovy层面定义的变量，Shell环境中不存在该变量，因此无法解析。
• ${WORKSPACE}能正常解析是因为它是Jenkins预注入的Shell环境变量，Shell层面可直接读取。

方法1：双引号包裹+转义Shell变量 #

使用Groovy支持插值的双引号包裹命令，Groovy层面的变量直接写${变量名}，需要留给Shell解析的环境变量前面加反斜杠转义$即可：

sh "/bin/sudo su -c \"\${WORKSPACE}/copy_files.sh \${WORKSPACE} ${my_dst}\" - <another user>"

执行时Groovy会先把${my_dst}替换为/opt/scripts，转义后的\${WORKSPACE}会保留为${WORKSPACE}交给Shell解析，符合预期。

方法2：三双引号包裹（更易读） #

如果不想转义内部的双引号，可以使用Groovy的三双引号语法，可读性更高：

sh """
/bin/sudo su -c "\${WORKSPACE}/copy_files.sh \${WORKSPACE} ${my_dst}" - <another user>
"""

方法3：参数化传参（最安全） #

如果担心路径中存在空格、特殊字符导致Shell注入风险，可以使用sh步骤的参数传递模式，完全规避引号转义问题：

sh script: '/bin/sudo su -c "$1/copy_files.sh $1 $2" - <another user>',
   args: [env.WORKSPACE, my_dst]

你也可以将公共路径定义为流水线全局环境变量，就不需要处理Groovy插值逻辑：

def my_dst = '/opt/scripts'
pipeline {
    agent { label '<a generic label>' }
    environment {
        MY_DST = my_dst
    }
    stages {
        stage('Deployment env1') {
            agent { label '<a specific label>' }
            steps {
                script {
                    echo 'Deploying scripts...'
                    sh '/bin/sudo su -c "${WORKSPACE}/copy_files.sh ${WORKSPACE} ${MY_DST}" - <another user>'
                }
            }
        }
        stage('Deployment env2') {
            agent { label '<another specific label>' }
            steps {
                script {
                    echo 'Deploying scripts...'
                    sh '/bin/sudo su -c "${WORKSPACE}/copy_files.sh ${WORKSPACE} ${MY_DST}" - <another user>'
                }
            }
        }
    } 
}

定义在environment块中的变量会被自动注入为Shell环境变量，直接用单引号包裹命令也能正常读取。

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