如何在Jenkins流水线中根据前置参数选择条件隐藏参数？

阿华AIGC实验室

2026-5-11

实现Jenkins流水线参数的条件性显示/隐藏

完全可以做到！你之前用的Active Choices插件其实有个更强大的变体——Active Choices Reactive Reference Parameter，结合Jenkins Pipeline就能实现整个参数的条件显示/隐藏，而不只是控制选项内容。

具体实现步骤

确保安装必要插件：首先要在Jenkins插件管理里安装Active Choices Plugin（这个插件包含了Reactive Reference类型的参数）。
Pipeline示例代码：

pipeline {
    agent any
    parameters {
        // 前置选择参数
        choice(
            name: 'DEPLOY_ENV',
            choices: ['dev', 'prod', 'test'],
            description: '选择部署环境'
        )
        // 条件显示的参数：只有当选择prod环境时才显示
        activeChoiceReactiveReference(
            name: 'PROD_APP_VERSION',
            description: '生产环境指定版本（仅prod环境可见）',
            reference: ['DEPLOY_ENV'], // 依赖的前置参数
            script: '''
                if (DEPLOY_ENV == 'prod') {
                    return true // 显示该参数
                } else {
                    return false // 隐藏该参数
                }
            ''',
            choiceType: 'TEXTBOX', // 文本框类型参数
            filterable: false
        )
        // 另一个条件参数：当选择dev或test时显示
        activeChoiceReactiveReference(
            name: 'DEV_TEST_BUILD_NUMBER',
            description: '开发/测试环境构建号（仅dev/test可见）',
            reference: ['DEPLOY_ENV'],
            script: '''
                return DEPLOY_ENV in ['dev', 'test']
            ''',
            choiceType: 'TEXTBOX',
            filterable: false
        )
    }
    stages {
        stage('Demo') {
            steps {
                script {
                    echo "部署环境: ${params.DEPLOY_ENV}"
                    if (params.PROD_APP_VERSION) {
                        echo "生产版本: ${params.PROD_APP_VERSION}"
                    }
                    if (params.DEV_TEST_BUILD_NUMBER) {
                        echo "构建号: ${params.DEV_TEST_BUILD_NUMBER}"
                    }
                }
            }
        }
    }
}

关键细节说明

reference字段：用来指定当前参数依赖的前置参数，当依赖参数的值变化时，当前参数的显示状态会自动更新。
script块：这里的Groovy脚本返回布尔值，true表示显示参数，false表示隐藏。你可以根据需要编写任意复杂的判断逻辑，比如多个前置参数的组合判断。
choiceType：支持多种类型，比如TEXTBOX（文本框）、SINGLE_SELECT（单选框）、CHECKBOX（多选框）等，满足不同参数类型的需求。