如何在GitHub Actions中从主仓库调用子模块仓库的工作流？

能否调用子模块的工作流？ #

可以，但不能直接通过本地相对路径引用，必须通过子模块仓库的完整地址+版本指定的方式调用，同时需要确保主仓库的工作流能拉取到子模块内容。

报错原因 #

你遇到的no version specified错误，是因为GitHub Actions引用外部（包括子模块）工作流时，必须明确指定版本（分支名、标签、commit哈希），不能仅用相对路径。另外，直接写本地路径会被识别为当前主仓库内的文件，而非子模块中的文件。

具体修复步骤 #

1. 先拉取子模块内容 #

在主仓库工作流的前置job（比如你的core job）中，添加拉取子模块的checkout步骤，确保子模块代码被拉取：

jobs:
  core:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取主仓库及子模块
        uses: actions/checkout@v4
        with:
          submodules: recursive  # 递归拉取所有子模块
          fetch-depth: 0  # 如果需要子模块的完整历史，可添加这行

2. 修改子模块工作流的引用方式 #

将原来的本地相对路径引用，替换为子模块仓库的完整地址+版本。格式为{仓库所有者}/{子模块仓库名}/.github/workflows/{工作流文件名}@{版本}，比如子模块仓库是your-org/test，分支为main，则修改为：

cicd:
  needs: [core]
  uses: your-org/test/.github/workflows/devops-core-cicd.yml@main
  with:
      repo_name: ${{ github.repository }}  
      postcheckout: ${{ needs.core.outputs.par_postcheckout }}

注意：版本可以是分支名（如main）、标签（如v1.0）或commit哈希（如a1b2c3d），推荐用commit哈希，避免子模块分支更新导致主仓库工作流意外变更。

3. 配置必要权限 #

如果子模块是私有仓库：

• 确保主仓库的GitHub Actions工作流权限设置为Read and write permissions（在仓库设置的Settings > Actions > General > Workflow permissions中调整）。
• 若子模块在不同组织下，需在子模块仓库的Settings > Actions > Access中，添加主仓库所在组织或仓库的访问权限。

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