如何仅在特定文件变更时执行Buildkite流水线步骤？

Buildkite没有直接提供和GitLab rules: change:完全一致的change字段，但可以通过以下两种方式实现相同效果：

一、Buildkite内置条件判断方案 #

利用Buildkite的**条件步骤（Conditional Steps）**结合Git命令直接判断文件变更，这是最简洁的内置实现方式：

steps:
  - command: "package_dependencies.sh"
    if: |
      git diff --name-only HEAD~1 HEAD | grep -q "^./requirements.txt$"

细节说明： #

• git diff --name-only HEAD~1 HEAD：对比当前提交与上一次提交的变更文件列表
• grep -q "^./requirements.txt$"：静默检查列表中是否包含目标文件，匹配成功则返回0（条件成立，步骤执行）
• 如果是PR流水线，可对比基准分支而非上一次提交：

  steps:
    - command: "package_dependencies.sh"
      if: |
        git diff --name-only origin/${BUILDKITE_PULL_REQUEST_BASE_BRANCH:-main} HEAD | grep -q "^./requirements.txt$"
  

  这里用参数展开处理了非PR场景（直接推分支时默认对比main分支）

二、自定义脚本方案（适合复杂场景） #

如果需要判断多个文件、路径匹配或更复杂的逻辑，可以写一个bash脚本封装判断逻辑：

1. 创建check_file_changes.sh脚本：

#!/bin/bash
# 定义需要监控的文件/路径
TARGETS=(
  "./requirements.txt"
  "./src/dependencies/"
  "./setup.py"
)

# 对比基准分支（PR场景用PR基准，否则用上一次提交）
if [[ -n "$BUILDKITE_PULL_REQUEST_BASE_BRANCH" ]]; then
  BASE_REF="origin/$BUILDKITE_PULL_REQUEST_BASE_BRANCH"
else
  BASE_REF="HEAD~1"
fi

# 遍历目标，检查是否有变更
for TARGET in "${TARGETS[@]}"; do
  if git diff --name-only "$BASE_REF" HEAD | grep -q "^${TARGET}"; then
    exit 0 # 存在变更，返回成功
  fi
done

exit 1 # 无匹配变更，返回失败

2. 在流水线中引用：

steps:
  - command: "package_dependencies.sh"
    if: "./check_file_changes.sh"

也可以直接把判断逻辑内嵌到command中，省去单独脚本：

steps:
  - command: |
      if git diff --name-only HEAD~1 HEAD | grep -q "^./requirements.txt$"; then
        package_dependencies.sh
      fi

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