jenkins-conditional-step插件仅适用于自由风格项目中的简单条件步骤控制，不支持pipeline分支动态跳转，官方推荐使用原生when指令、multibranch pipeline及script块实现分支差异化构建逻辑。
在 Jenkins 中，Jenkins-Conditional-Step 插件（现已被更现代的 Pipeline Utility Steps 和原生 when 指令逐步替代）主要用于自由风格项目中实现条件执行步骤。但需注意：该插件**不支持 Pipeline 语法中的分支动态跳转逻辑**，且自 Jenkins 2.0+ 后，官方推荐使用声明式或脚本化 Pipeline 的 when、script、stage 嵌套等原生能力完成分支差异化构建逻辑。
确认插件适用场景与局限
Jenkins-Conditional-Step 是为“自由风格项目（Freestyle Project）”设计的构建后操作/构建步骤条件插件，它通过 UI 配置字段（如“Run only if build succeeds”、“Based on environment variable”等）控制是否执行某一步骤。它无法感知 Git 分支名、不能动态读取 SCM 信息、也不支持在构建过程中根据当前检出分支跳转到不同执行路径。
常见误用场景：
- 试图在 Freestyle 项目中用该插件“根据 $GIT_BRANCH 跳转 stage”——实际只能做简单布尔判断，无分支路由能力；
- 在 Pipeline 中安装 Conditional-Step 并期望用它替代
when { branch 'dev' }——该插件对 Pipeline 无效，Jenkins 会忽略或报错。
推荐方案：用原生 Pipeline 实现分支动态逻辑
真正实现“不同分支间动态逻辑跳转”，应使用 Jenkins Pipeline（尤其是声明式 Pipeline），配合 when 指令和 script 块灵活控制流程：
-
基础分支路由：用
when { branch 'main' }或when { expression { env.BRANCH_NAME == 'develop' } }控制 stage 执行； -
多分支复合逻辑：结合
expression+ 正则匹配，例如env.BRANCH_NAME =~ /^feature\/.*$/匹配所有 feature 分支； -
运行时分支探测：若未通过 Multibranch Pipeline 自动注入
BRANCH_NAME，可在script块中调用sh(returnStdout: true, script: 'git rev-parse --abbrev-ref HEAD').trim()获取当前分支； -
条件嵌套与跳转模拟：用
script定义变量currentStage = 'test'，再用多个if/else分支执行不同命令，达到“逻辑跳转”效果。
Multibranch Pipeline 是最佳实践
如果你的目标是为不同 Git 分支自动触发不同构建逻辑（如 main 发布、develop 测试、feature 验证），请直接采用 Multibranch Pipeline 项目类型：
- Jenkins 自动扫描仓库分支，为每个分支创建独立流水线实例；
- 每个分支可共用同一份
Jenkinsfile，通过env.BRANCH_NAME动态决定行为； - 支持
when+branches、not、anyOf等组合，清晰表达分支策略； - 天然隔离，避免手动配置错误，也无需依赖 Conditional-Step 这类过时插件。
如果必须用 Freestyle + Conditional-Step（遗留系统）
仅限极简场景，例如：只区分 main 和 other，且分支名已通过参数或环境变量传入：
- 在 Freestyle 项目中启用 “This build is parameterized”，添加字符串参数
BRANCH_NAME； - 在构建步骤中添加 “Conditional step (single)” → “Execute shell” → 设置 “Run? Based on environment variable”，变量填
BRANCH_NAME，值填main； - 该步骤只在
BRANCH_NAME=main时执行发布命令；其他逻辑需另建条件步骤并设为!main（注意 Conditional-Step 不支持取反语法，需用expression类型配合${BRANCH_NAME != 'main'}）。
这种方式耦合高、难维护，不建议用于复杂分支策略。
总之，Conditional-Step 插件不是为分支路由设计的。用对工具才能少踩坑：分支逻辑交给 Pipeline 的 when，分支管理交给 Multibranch，环境变量和脚本辅助做运行时判断——这才是稳定、可读、可持续的方式。
