Bitbucket Cloud：如何通过变量条件性跳过阶段或步骤

目前Bitbucket Pipelines的condition字段确实不支持直接引用仓库/工作区变量来控制阶段执行，但可以通过以下两种实用方式实现需求：

方法1：用前置脚本判断跳过阶段 #

在阶段的首个步骤里加入变量判断逻辑，不满足条件就直接正常退出（返回码0），后续步骤会自动跳过：

pipelines:
  default:
    - stage: QA
      steps:
        - script:
            - if [ "${QA_STAGE_ENABLED}" != "true" ]; then exit 0; fi
        - script:
            - echo "执行QA阶段的测试任务..."

这种方式下，当QA_STAGE_ENABLED不为true时，整个阶段会标记为"成功"但跳过实际业务操作，无需手动修改配置文件。

方法2：结合when字段与变量判断（特定触发场景适用） #

如果阶段是基于分支、标签或PR触发，可通过when.condition结合自定义变量实现条件控制，前提是QA_STAGE_ENABLED为仓库或工作区级变量：

pipelines:
  branches:
    '**':
      - stage: QA
        when:
          condition:
            - "${QA_STAGE_ENABLED} == 'true'"
        steps:
          - script: echo "执行QA阶段任务..."

注意：部分旧版本Bitbucket Pipelines可能存在自定义变量在when条件中不生效的情况，需确认平台版本兼容性。

批量阶段的优化替代方案 #

如果有多个需要控制的阶段，可以统一用脚本判断模板来简化配置：

pipelines:
  default:
    - stage: QA
      steps:
        - script:
            - |
              if [ "${QA_STAGE_ENABLED}" != "true" ]; then
                echo "QA阶段已禁用，跳过执行"
                exit 0
              fi
              # 这里写QA阶段的实际任务命令
              echo "运行自动化测试..."
    - stage: Production
      steps:
        - script:
            - |
              if [ "${PROD_STAGE_ENABLED}" != "true" ]; then
                echo "生产阶段已禁用，跳过执行"
                exit 0
              fi
              # 这里写生产部署的实际任务命令
              echo "开始部署生产环境..."

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