如何让Jenkins声明式Pipeline的Stage兼容Windows与Linux？

你当前的实现通过两个Stage分别适配环境，虽然可行但存在大量重复代码，维护成本较高。以下几种方式可以在保持声明式风格的前提下优化实现：

方案一：单个Stage内置条件判断 #

将重复逻辑合并到同一个Stage中，通过条件判断执行对应平台的命令，避免冗余代码：

stage('Integration Tests') {
    steps {
        dir('') {
            script {
                if (env.OS == 'BAT') {
                    bat 'gradlew.bat integrationTest'
                } else if (env.OS == 'UNIX') {
                    sh './gradlew integrationTest'
                }
            }
            // 测试报告收集逻辑统一执行
            junit '**/build/test-results/integrationTest/*.xml'
        }
    }
}

方案二：利用环境变量简化命令判断 #

通过声明式的environment块预定义平台相关变量，让代码结构更清晰：

stage('Integration Tests') {
    environment {
        GRADLE_TASK = 'integrationTest'
        GRADLE_CMD = env.OS == 'BAT' ? "gradlew.bat ${GRADLE_TASK}" : "./gradlew ${GRADLE_TASK}"
    }
    steps {
        dir('') {
            script {
                env.OS == 'BAT' ? bat(GRADLE_CMD) : sh(GRADLE_CMD)
            }
            junit '**/build/test-results/integrationTest/*.xml'
        }
    }
}

方案三：封装到Jenkins共享库（适合多项目复用） #

如果你的团队有多个Jenkins Pipeline需要跨平台适配，建议将平台判断逻辑封装到共享库中，实现复用：

共享库脚本（vars/runGradleTask.groovy） #

def call(String taskName) {
    if (isUnix()) {
        sh "./gradlew ${taskName}"
    } else {
        bat "gradlew.bat ${taskName}"
    }
}

Pipeline中调用共享库 #

stage('Integration Tests') {
    steps {
        dir('') {
            runGradleTask('integrationTest')
            junit '**/build/test-results/integrationTest/*.xml'
        }
    }
}

优化后的优势 #

• 减少冗余：避免重复编写几乎完全相同的Stage逻辑，降低后续维护成本
• 逻辑集中：所有集成测试相关逻辑统一在一个Stage内，可读性更强
• 扩展性好：后续新增平台适配时，只需修改条件判断或共享库逻辑，无需新增Stage

内容的提问来源于stack exchange，提问作者Fábio Pires