GitHub Actions路径过滤中使用变量的问题求助

为什么你的写法不生效？ #

GitHub Actions的paths/paths-ignore过滤逻辑是在工作流初始化阶段执行的，这个阶段还无法访问env、steps这类运行时上下文变量，也不支持在这个位置使用模板表达式（${{ ... }}），这就是你遇到A template expression is not allowed in this context报错的原因。而直接用format()的写法，因为env.Parent在初始化阶段根本读不到值，所以路径过滤完全不生效。

可行解决方案 #

方案1：使用工作流级别的vars（推荐，GitHub Actions 3.0+支持）

vars是工作流解析阶段就能访问的静态变量，完美适配路径过滤的场景。你可以在工作流顶部定义父目录变量，后续所有jobs的路径过滤直接引用即可：

name: Path Filter with Variable
vars:
  Parent: "your-parent-directory"  # 这里定义父目录，后续只改这一行

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  job1:
    runs-on: ubuntu-latest
    if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }}
    steps:
      - uses: actions/checkout@v4
    # 路径过滤直接引用vars变量
    paths:
      - "${{ vars.Parent }}/actions_subdirectory/**"
      - "${{ vars.Parent }}/another_subdirectory/**"

  job2:
    runs-on: ubuntu-latest
    if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }}
    steps:
      - uses: actions/checkout@v4
    paths:
      - "${{ vars.Parent }}/third_subdirectory/**"

方案2：使用YAML锚点与别名（兼容旧版本）

如果你的环境不支持vars，可以用YAML的锚点特性，把父目录定义成一个可复用的锚点，各个jobs的路径过滤引用这个锚点：

name: Path Filter with YAML Anchor
# 定义锚点，存储父目录
x-parent-dir: &parent-dir "your-parent-directory"

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  job1:
    runs-on: ubuntu-latest
    if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }}
    steps:
      - uses: actions/checkout@v4
    paths:
      - *parent-dir/actions_subdirectory/**
      - *parent-dir/another_subdirectory/**

  job2:
    runs-on: ubuntu-latest
    if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository }}
    steps:
      - uses: actions/checkout@v4
    paths:
      - *parent-dir/third_subdirectory/**

验证要点 #

• 不管用哪种方案，修改父目录时只需要更新vars.Parent或者锚点的值，所有引用的路径过滤都会自动生效。
• 路径结尾的/**是必须的，用来匹配目录下的所有文件和子目录变更，确保能触发工作流。

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