Github Actions执行git diff报错：main参数未知或不在工作树

核心原因 #

actions/checkout@v2 默认只拉取当前分支的单条提交记录，本地仓库没有main分支的本地引用，也未拉取远程origin的main分支数据，所以无论写main还是origin/main都会触发找不到分支的报错。

修复方案 #

1. 调整Checkout步骤，拉取完整仓库数据 #

将checkout步骤添加fetch-depth: 0参数，拉取完整的仓库历史及所有分支：

- name: Checkout Repository
  uses: actions/checkout@v2
  with:
    fetch-depth: 0  # 拉取完整仓库历史，包含所有分支引用

若不想拉取全量历史，也可单独拉取main分支：

- name: Checkout Repository
  uses: actions/checkout@v2
  with:
    fetch-depth: 1
    ref: ${{ github.head_ref }}
- name: Fetch main branch
  run: git fetch origin main:main

2. 修正脚本中的转义错误与diff命令 #

原脚本里的"是HTML转义后的引号，需替换为正常双引号"；同时git diff直接使用origin/main对比当前HEAD即可：

- name: Detect Spec File
  id: spec-file-changes
  run: |
    array=()
    git diff --name-only origin/main HEAD >> changed_files.txt
    grep -iE 'provider-apis/spec-files/rest/.*\.(json|yml|yaml)' changed_files.txt >> specpath.txt
    while IFS= read -r line; do
        array+=("$line")
    done < "specpath.txt"
    echo "paths=$(printf '%s\n' "${array[@]}" | jq -R . | jq -cs )" >> "$GITHUB_OUTPUT"

另外注意：grep正则里的rest/*/需改为rest/.*，因为正则语法中*仅匹配前一个字符的零次或多次，.*才是匹配任意长度的任意字符。

额外建议 #

建议将actions/checkout@v2升级到v3版本，兼容性与稳定性更好：

uses: actions/checkout@v3

若仓库默认分支不是main（比如是master），需对应替换为正确的分支名称。

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