Jenkins DSL：如何用构建参数覆盖FreeStyleJob的环境变量？

要让用户输入的构建参数覆盖预设的环境变量，核心是在DSL中将环境变量的值绑定到参数变量，具体有两种常见实现方式：

方式一：参数名与环境变量名一致 #

直接把参数名设为和目标环境变量同名，环境变量引用该参数，用户输入的参数值会自动覆盖默认值：

freeStyleJob('myjob') {
    // 添加字符串参数，参数名与环境变量名保持一致
    parameters {
        stringParam('MY_VARIABLE', 'default value', '输入值将覆盖MY_VARIABLE环境变量')
    }

    environmentVariables {
        // 引用参数值，构建时优先使用用户输入的参数，无输入则用参数默认值
        env('MY_VARIABLE', '${MY_VARIABLE}')
    }
}

方式二：参数名与环境变量名不同 #

如果需要参数名和环境变量名区分开，直接在环境变量中引用参数名即可：

freeStyleJob('myjob') {
    parameters {
        stringParam('USER_INPUT', 'default value', '输入值将映射到MY_VARIABLE环境变量')
    }

    environmentVariables {
        // 将环境变量值绑定到参数USER_INPUT
        env('MY_VARIABLE', '${USER_INPUT}')
    }
}

补充说明 #

Jenkins在带参数构建时，所有参数会自动注入为环境变量。如果参数名与环境变量名完全一致，甚至可以省略environmentVariables块的显式配置，但显式绑定能让变量逻辑更清晰，避免后续维护歧义。

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