如何在Azure Pipelines中为Bash脚本执行的命令添加自定义前缀回显？

针对Azure Pipelines环境下需要让Bash命令执行前自动输出##[command]前缀的需求，提供两种低开销、适配多步骤的解决方案：

方案1：全局自动注入（无需修改现有命令） #

利用Bash的DEBUG陷阱机制，实现所有命令执行前自动输出指定前缀。结合Azure Pipelines的环境变量特性，可实现全局生效：

配置步骤 #

在Pipeline的YAML中添加初始化步骤，后续所有Bash步骤会自动继承配置：

jobs:
- job: Build
  variables:
    # 指定Bash执行前自动加载的配置文件
    BASH_ENV: /tmp/command_prefix_config.sh
  steps:
  - bash: |
      # 写入DEBUG陷阱配置到指定文件
      echo 'trap '\''echo "##[command]$BASH_COMMAND"'\'' DEBUG' > $BASH_ENV
    displayName: 'Configure automatic command prefix'
  - bash: |
      # 直接执行命令，自动输出前缀
      ls -l
      pwd
      echo "Hello Azure Pipelines"
    displayName: 'Run commands with auto prefix'

效果说明 #

执行后每条命令都会先输出##[command]+命令内容，再执行命令输出结果，完全符合示例要求。该方案开销极低，仅在命令执行前增加一次echo操作。

方案2：函数调用（可控性更强） #

定义一个run函数，仅对包裹的命令添加前缀输出，适合需要选择性添加前缀的场景：

配置步骤 #

同样通过BASH_ENV实现全局共享函数：

jobs:
- job: Build
  variables:
    BASH_ENV: /tmp/run_func_config.sh
  steps:
  - bash: |
      # 定义run函数并写入配置文件
      echo 'run() {
          echo "##[command]$*"
          "$@"
      }' > $BASH_ENV
    displayName: 'Configure run function'
  - bash: |
      # 用run包裹需要加前缀的命令
      run ls -l
      run mkdir test_dir
      # 不需要前缀的命令直接执行
      echo "This command has no prefix"
    displayName: 'Run commands with selective prefix'

效果说明 #

只有通过run函数调用的命令会输出##[command]前缀，直接执行的命令则不会，灵活性更高。

关于.bashrc加载的说明 #

Azure Pipelines的Bash步骤默认以非交互式非登录shell执行，不会自动加载~/.bashrc或系统级bash配置文件。通过BASH_ENV环境变量指定配置文件，是官方推荐的在多步骤间共享Bash配置的方式，比手动修改.bashrc更可靠且无额外开销。

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