如何使用命令执行结果判断Jenkins stage是否执行

首先澄清一个普遍的认知偏差：声明式Jenkins Pipeline的环境变量并非完全不可变，只是无法在结构化的普通步骤中直接重新赋值，所有变量修改操作放在script块内执行的话，完全可以实现跨阶段的变量读写、状态传递，足够支撑你判断配置变更、按需跳过阶段的需求，不需要安装额外插件。

方案1：顶层环境变量+script块赋值（最推荐，无额外依赖） #

你只需要在pipeline顶层的environment块预先给变更标识赋初始值，后续在配置对比步骤中，通过script块根据diff命令的执行结果修改变量值，后续所有阶段都可以直接读取该值，配合when指令即可实现阶段按需跳过。
可直接参考的可用示例：

pipeline {
    agent any
    environment {
        // 预先定义变更标识，默认无变更
        CONFIG_CHANGED = 'NO'
    }
    stages {
        stage('拉取远程配置并对比差异') {
            steps {
                // 从API拉取最新配置文件
                sh 'curl -s https://your-internal-config-api/target/config.yaml -o remote_config.yaml'
                script {
                    // 执行diff对比，注意必须加returnStatus参数捕获退出码
                    // diff命令规则：文件无差异返回0，有差异返回1，命令执行错误返回>1的值
                    def diffExitCode = sh(
                        script: 'diff remote_config.yaml ./repo/config.yaml',
                        returnStatus: true
                    )
                    if (diffExitCode == 1) {
                        // 检测到差异，修改全局标识，替换本地旧文件
                        CONFIG_CHANGED = 'YES'
                        sh 'cp remote_config.yaml ./repo/config.yaml'
                    } else if (diffExitCode > 1) {
                        // 对比命令本身执行异常（比如文件不存在、权限不足），直接中断流程
                        error("配置文件对比执行失败，退出码：${diffExitCode}")
                    }
                }
            }
        }
        stage('提交新配置到代码仓库') {
            // 仅当检测到配置变更时执行当前阶段
            when {
                environment name: 'CONFIG_CHANGED', value: 'YES'
            }
            steps {
                dir('./repo') {
                    sh '''
                        git config user.name "jenkins-bot"
                        git config user.email "jenkins-bot@your-company.local"
                        git add config.yaml
                        git commit -m "chore: 自动同步远程最新配置"
                        git push origin ${BRANCH_NAME}
                    '''
                }
            }
        }
        // 其余需要配置变更才触发的阶段，复用相同的when条件即可
        stage('配置变更后触发服务重载') {
            when {
                environment name: 'CONFIG_CHANGED', value: 'YES'
            }
            steps {
                echo '检测到配置变更，执行服务重载逻辑'
                // 填入你的后续业务步骤
            }
        }
    }
}

关键避坑点：执行diff命令时必须加returnStatus: true参数。如果不加该参数，只要两个文件存在差异导致diff返回退出码1，Jenkins会直接判定步骤失败、中断整个pipeline，这是写文件对比逻辑最容易踩的坑。

方案2：pipeline外层定义Groovy全局变量 #

如果不想使用environment块管理变量，也可以直接在pipeline结构最外层定义Groovy变量，所有stage的script块都可以直接读写该变量，效果和环境变量一致：

// pipeline块外定义的变量为全局作用域，所有阶段均可访问
def configChanged = false

pipeline {
    agent any
    stages {
        stage('对比配置差异') {
            steps {
                script {
                    def diffCode = sh(script: 'diff remote_config.yaml local_config.yaml', returnStatus: true)
                    configChanged = (diffCode == 1)
                }
            }
        }
        stage('提交配置变更') {
            when {
                // 全局变量判断需要用expression条件
                expression { return configChanged }
            }
            steps {
                echo '执行配置提交逻辑'
            }
        }
    }
}

通用注意事项 #

• 所有变量赋值操作必须放在script块内执行，声明式Pipeline的普通结构化步骤不支持直接修改变量值
• 不要尝试通过sh步骤内的shell变量跨步骤传值，shell变量的作用域仅限当前sh命令启动的独立进程，步骤执行结束进程销毁后变量会直接丢失
• 如果你的pipeline配置了多节点执行（不同stage运行在不同agent机器上），不需要额外处理变量同步，上述两种方式定义的变量都会由Jenkins主节点统一维护，自动注入到各个节点的执行上下文里

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