如何在GitHub Actions中仅在主仓库运行指定步骤？

要让工作流只在主仓库触发，同时兼容push、定时任务、PR等所有场景，你可以通过以下方式实现：

1. 全局限制整个工作流 #

在工作流文件的最顶层添加if条件，直接让整个工作流仅在主仓库启动：

name: Main Repo Workflow
on:
  push:
    branches: ["main"]
  pull_request:
    branches: ["main"]
  schedule:
    - cron: '0 0 * * *'
# 核心条件：仅当当前仓库是主仓库时才运行
if: github.repository == 'octo-org/octo-repo-prod'

这个条件对所有触发事件都生效，复刻仓库的任何触发都会直接跳过整个工作流。

2. 针对单个Job设置限制 #

如果只需要限制某个特定Job不在复刻仓库运行，在Job级别添加if条件即可：

jobs:
  production-build:
    runs-on: ubuntu-latest
    if: github.repository == 'octo-org/octo-repo-prod'
    steps:
      - uses: actions/checkout@v4
      # 后续构建/部署步骤

3. PR场景的额外兼容 #

你之前用的github.event.pull_request.head.repo.full_name仅对PR事件有效，非PR事件中该变量不存在会导致判断失效。如果需要在PR场景下额外限制源分支来自主仓库，可以结合事件类型做复合判断：

if: >
  github.repository == 'octo-org/octo-repo-prod' &&
  (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == 'octo-org/octo-repo-prod')

这个条件既保证了工作流在主仓库运行，又在PR事件时验证PR的源分支来自主仓库，避免复刻仓库的PR触发工作流。

排查之前方法无效的原因 #

你之前用if: github.repository == 'octo-org/octo-repo-prod'无效，大概率是以下问题：

• 仓库全名拼写错误（注意组织名、仓库名的大小写和字符）
• 把条件放在了Step级别而非Workflow/Job级别
• 可以在工作流中添加打印步骤排查变量值：

  steps:
    - run: echo "当前仓库: ${{ github.repository }}"
  

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