Jenkinsfile的environment块如何定义多行数组供VALUES.each()使用

Jenkins Declarative Pipeline的environment块中定义的所有变量默认都会被强转为字符串类型，直接传入Groovy数组/List时，会自动调用对象的toString()方法，生成带首尾中括号的字符串（格式为[val1, val2]），后续按逗号拆分遍历时，中括号会被当成内容的一部分，就会出现遍历结果为[val1、val2]的异常。你尝试的直接换行写逗号分隔值的写法不符合Groovy基础语法，自然无法被正常解析。

根据你的使用场景，可以选以下任意一种写法，都能满足逐行书写值、提升可读性的需求：

• 方案1：三引号多行字符串写法（最简便，无需额外定义方法）
  用Groovy支持的三引号语法定义多行字符串，每个值单独占一行，遍历前先做去空、按换行拆分处理即可：

environment {
    VALUES = '''
val1
val2
val3
'''
}

// 后续遍历逻辑
script {
    VALUES.trim().split(/\n/).each { 
        def currentVal = it.trim()
        // 写入对应业务逻辑，currentVal就是单个目标值
        echo "处理值：${currentVal}"
    }
}

• 方案2：辅助方法返回列表（适合多场景复用值列表）
  如果值列表需要在pipeline的多个位置复用，不要把列表直接赋值给environment块的变量（避免被强转成带中括号的字符串），而是在script块内直接调用方法拿到列表遍历：

// 提前定义返回值列表的方法
def getValueList() {
    return [
        'val1',
        'val2',
        'val3'
    ]
}

pipeline {
    agent any
    stages {
        stage('遍历测试') {
            steps {
                script {
                    // 直接拿到列表遍历，不经过environment块的字符串转换
                    getValueList().each { val ->
                        echo "处理值：${val}"
                    }
                }
            }
        }
    }
}

• 方案3：提前拼接为干净的分隔字符串（必须使用environment变量传值时用）
  如果你必须把值存在environment块的变量中，就在辅助方法内提前把列表拼接成无多余格式的分隔字符串，避免自动toString()带来的格式问题：

def getValueStr() {
    // 手动用逗号拼接，不会生成中括号
    return ['val1', 'val2', 'val3'].join(',')
}

environment {
    VALUES = getValueStr()
}

// 后续遍历直接按逗号拆分即可
script {
    VALUES.split(',').each {
        def currentVal = it.trim()
        echo "处理值：${currentVal}"
    }
}

注意：不要尝试用[]/{}直接包裹换行值赋值给environment块的字符串变量，这类写法不符合Groovy字符串的语法规则，会直接触发解析报错。

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