告别在Jenkins声明式流水线中使用if语句伪装stage的错误做法！正确的方法是利用when指令，根据choice参数（如'ME'、'FC'、'ME_and_FC'）动态控制stage执行。本教程将帮助你避免语法错误，实现精准的分支调度。

先来解释为什么你可能会遇到“not a valid syntax”这个错误——因为直接使用if语句包裹stage，Jenkins声明式流水线根本不会识别。它不允许在stages块内混入Groovy控制流，正确做法是采用内置的when指令，既安全又清晰，而且与参数完美兼容。下面是一个完整的可运行示例，支持三种构建类型：FC（仅执行FC相关的stage）、ME（仅执行ME并行子stage）、ME_and_FC（两者都执行）。

pipeline {
    parameters {
        choice choices: ['ME', 'FC', 'ME_and_FC'], description: 'Select build type', name: 'Build_type'
    }
    agent {
        node {
            label 'Sla ve_APP_Train_32'
            customWorkspace 'App_WS'
        }
    }
    stages {
        // ✅ FC-only stages — triggered only when Build_type is 'FC' or 'ME_and_FC'
        stage('FC Stage 1') {
            when { expression { params.Build_type == 'FC' || params.Build_type == 'ME_and_FC' } }
            steps { echo "FC Stage 1: D6-EPS EXECUTED" }
        }
        stage('FC Stage 2') {
            when { expression { params.Build_type == 'FC' || params.Build_type == 'ME_and_FC' } }
            steps { echo "FC Stage 2: D6-EPS EXECUTED" }
        }
        stage('FC Stage 3') {
            when { expression { params.Build_type == 'FC' || params.Build_type == 'ME_and_FC' } }
            steps { echo "FC Stage 3: D6-EPS EXECUTED" }
        }
        // ✅ ME-only parallel stages — triggered only for 'ME' or 'ME_and_FC'
        stage('ME Parallel Execution') {
            when { expression { params.Build_type == 'ME' || params.Build_type == 'ME_and_FC' } }
            steps {
                script {
                    parallel(
                        'D6 SRA': {
                            node('Sla ve_APP_Train_32') {
                                ws('App_WS') {
                                    echo "ME - D6 SRA: D6-EPS EXECUTED"
                                }
                            }
                        },
                        'D6 EPS': {
                            node('Sla ve_APP_Train_32') {
                                ws('App_WS') {
                                    echo "ME - D6 EPS: D6-EPS EXECUTED"
                                }
                            }
                        },
                        'C3 EPS': {
                            node('Sla ve_APP_Train_32') {
                                ws('App_WS') {
                                    echo "ME - C3 EPS: D6-EPS EXECUTED"
                                }
                            }
                        }
                    )
                }
            }
        }
    }
}

⚠️ 关键注意事项：

• when { expression { ... } }中的闭包必须返回布尔值。虽然Groovy默认返回最后一行，但显式写return会更可靠，不要偷懒。
• ❌ 错误写法：if(${params.Build_type=='ME'})——注意，${...}是字符串插值，不是Groovy表达式，而且if不能作为stage容器。
• ✅ 正确访问参数：始终使用params.Build_type（大小写敏感），不要尝试用env.BUILD_TYPE碰运气。
• 如果判断逻辑复杂，可以提取为函数，但when内部不支持函数调用，因此建议保持表达式简洁，或者把逻辑放在script块里。
• parallel必须放在steps内，推荐配合script { parallel(...) }使用，确保兼容性。

通过when指令，你不仅能实现参数驱动的stage路由，还能在Jenkins UI上看到清晰的“Skipped”标记，流水线的可维护性和可观测性瞬间提升。