GitHub Actions拉取子模块时使用变量失败的问题求助

问题分析 #

你遇到的情况是：硬编码Tag执行git checkout v2.4.7能正常拉取子模块，但用GitHub Actions输入变量${{ inputs.IRIS_VERSION }}执行相同值的命令时，却报pathspec 'v2.4.7' did not match any file(s) known to git错误。虽然日志显示执行的命令一致，但本质是变量使用时的几个细节没处理到位。

解决方法 #

1. 先确认输入变量的实际值（排查隐形字符）

有时候输入变量可能被自动添加了空格、换行等隐形字符，导致git无法识别。先在步骤里添加变量输出，验证值是否正确：

- name: Git Submodule Update
  run: |
    echo "当前IRIS_VERSION值: '${{ inputs.IRIS_VERSION }}'"
    git submodule update --remote --recursive
    # 切换到子模块目录（替换成你实际的子模块路径）
    cd your-submodule-directory
    git checkout "${{ inputs.IRIS_VERSION }}"

如果输出里的v2.4.7前后有多余空格或其他字符，说明变量解析有问题，可以用trim函数过滤：

git checkout "${{ inputs.IRIS_VERSION | trim }}"

2. 切换到子模块目录并拉取Tags

默认情况下，git checkout是在主仓库执行的，而你要checkout的Tag属于子模块。另外，git submodule update --remote只会拉取子模块的最新commit，不会同步所有Tags，所以需要先进入子模块目录，拉取Tags后再checkout：

- name: Git Submodule Update
  run: |
    git submodule update --remote --recursive
    # 遍历所有子模块，拉取Tags并checkout指定版本
    git submodule foreach 'git fetch --tags && git checkout "${{ inputs.IRIS_VERSION | trim }}"'

如果只有单个子模块，也可以直接指定目录：

- name: Git Submodule Update
  run: |
    git submodule update --remote --recursive
    cd path/to/your/submodule
    git fetch --tags
    git checkout "${{ inputs.IRIS_VERSION | trim }}"

3. 用环境变量中转输入变量

有时候GitHub Actions的模板变量在bash中解析会有异常，先把输入变量赋值给bash环境变量再使用：

- name: Git Submodule Update
  env:
    IRIS_TAG: ${{ inputs.IRIS_VERSION | trim }}
  run: |
    git submodule update --remote --recursive
    cd path/to/your/submodule
    git fetch --tags
    git checkout "$IRIS_TAG"

为什么硬编码能成功？ #

硬编码时，可能你之前的操作（比如手动测试）已经在子模块目录拉取过对应Tag，或者git submodule update刚好同步到了包含该Tag的commit；而使用变量时，由于没切换目录、没拉取Tags，或者变量存在隐形字符，导致git在主仓库里找不到对应Tag，从而报错。

内容的提问来源于stack exchange，提问作者김남진