GitHub Actions容器模式运行作业时.git文件夹丢失问题咨询

核心原因 #

• checkout动作的默认行为：actions/checkout@v3及以上版本默认使用浅克隆（fetch-depth: 1），仅拉取当前提交的文件内容，不会保留.git目录。当作业以容器模式运行时，GitHub Actions会将运行器上的工作目录（即checkout后的文件）挂载到容器内，既然运行器上的目录本身就没有.git，容器里自然也看不到。
• 运行器与容器的环境差异：直接在运行器上执行作业时，若你之前的checkout配置包含完整克隆（比如手动设置了fetch-depth: 0），或者运行器上的仓库是完整克隆状态，就会存在.git目录；而容器模式下如果沿用默认checkout配置，就会出现缺失。

解决办法 #

修改checkout动作的参数，强制获取完整仓库及.git目录：

- name: 拉取代码（包含.git目录）
  uses: actions/checkout@v4
  with:
    fetch-depth: 0  # 执行完整克隆，获取所有提交历史及.git目录
    persist-credentials: true  # 可选，保留Git凭证，方便后续执行push等需要权限的操作

配置完成后，重新运行作业，容器内的工作目录就会包含完整的.git文件夹，此时就能正常执行git命令了。

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