如何在Azure Pipelines中配置全局Bash别名以切换Gradle执行方式

针对你要通过参数切换内置Gradle和Gradle Wrapper的需求，这里有几个绕过Bash配置文件限制的实用方法：

方法1：在每个Script步骤中直接注入别名（最直接） #

由于Azure Pipelines的每个script:步骤都是独立的Bash进程，直接在步骤开头根据参数设置别名即可，无需依赖配置文件。

首先在模板中定义参数：

parameters:
  - name: useGradleWrapper
    type: boolean
    default: false

然后在所有Gradle执行步骤中加入判断：

- script: |
    # 根据参数设置别名
    if [ "${{ parameters.useGradleWrapper }}" = "true" ]; then
      alias gradle='./gradlew'
    fi
    # 原命令无需修改
    gradle build test
  displayName: 'Build and Test with Gradle'

这种方式不需要额外维护脚本，每个步骤独立生效，适合步骤数量不多的流水线。

方法2：用统一脚本作为Gradle执行入口（适合多步骤场景） #

如果流水线中有大量Gradle执行步骤，可以创建一个通用脚本作为入口，避免重复写判断逻辑。

1. 在代码仓库根目录创建gradle-runner.sh脚本：

#!/bin/bash
# 根据环境变量判断执行方式
if [ "$USE_GRADLE_WRAPPER" = "true" ]; then
  exec ./gradlew "$@"
else
  exec gradle "$@"
fi

2. 给脚本添加执行权限（可在流水线中完成，也可提前提交到仓库）：

- script: chmod +x ./gradle-runner.sh
  displayName: 'Make Gradle runner script executable'

3. 在模板中设置环境变量，然后所有步骤用这个脚本代替gradle命令：

parameters:
  - name: useGradleWrapper
    type: boolean
    default: false

- script: |
    echo "##vso[task.setvariable variable=USE_GRADLE_WRAPPER]${{ parameters.useGradleWrapper }}"
  displayName: 'Set Gradle execution mode'

- script: ./gradle-runner.sh build test
  displayName: 'Build and Test'
- script: ./gradle-runner.sh publish
  displayName: 'Publish artifacts'

这种方式只需要维护一个脚本，所有Gradle命令都通过它执行，适合复杂流水线。

方法3：正确配置BASH_ENV（修复你之前的尝试） #

之前设置BASH_ENV失败，大概率是变量设置方式不对，或者路径引用存在歧义。Azure Pipelines中需要用任务命令设置变量，且建议用$HOME代替~避免路径问题。

parameters:
  - name: useGradleWrapper
    type: boolean
    default: false

- script: |
    # 创建环境脚本
    echo "alias gradle='./gradlew'" > "$HOME/my_ci_env.sh"
    # 设置BASH_ENV变量，让后续Bash步骤加载该脚本
    echo "##vso[task.setvariable variable=BASH_ENV]$HOME/my_ci_env.sh"
  displayName: 'Configure Gradle alias'
  condition: eq('${{ parameters.useGradleWrapper }}', 'true')

# 后续所有Gradle步骤无需修改命令
- script: gradle build test
  displayName: 'Build with Gradle'

注意：condition确保只有启用Wrapper时才设置别名，避免影响内置Gradle的正常使用。

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