GitLab流水线部分项目git tag -l无输出，本地运行正常

问题详情 #

• 部分项目在GitLab流水线里执行git tag -l无输出，另一些项目能正常返回标签；本地环境所有项目执行该命令均正常
• 相关代码片段：

tag = None
tag = subprocess.check_output(
                    ["git", "tag", "-l"]) \
                    .decode("utf-8").rstrip("\n")
if not tag:
    version = default_version

• 异常表现：命令无输出时程序会使用默认版本；给问题项目新建标签后，git tag -l能正常返回新标签，但旧标签仍无法被识别

原因分析 #

GitLab流水线默认采用浅克隆（shallow clone），仅拉取仓库最新的少量提交，不会同步全量标签历史：

• 新建标签关联了最新提交，所以能被浅克隆捕获到
• 旧标签若关联较早提交，不在浅克隆的覆盖范围内，就无法被git tag -l查到
• 部分项目正常，是因为它们的标签刚好关联在最新提交上，或是流水线已配置完整克隆

解决办法 #

1. 主动拉取所有标签
   在.gitlab-ci.yml的before_script中添加拉取标签的命令，确保执行代码前同步全量标签：

before_script:
  - git fetch --tags

2. 切换为完整克隆
   在流水线配置中设置不限制克隆深度，拉取完整仓库历史：

variables:
  GIT_DEPTH: 0

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