Vercel忽略步骤脚本中无法获取Git标签问题求助

本地环境中可正常获取Git标签，但在Vercel的构建忽略脚本里执行标签查询时，返回结果为空或undefined，核心原因是Vercel默认采用浅克隆（--depth=1）方式拉取仓库，这种方式只会获取最近1次提交的内容，不会同步标签、完整提交历史等信息。

解决方法 #

方法1：修改Vercel克隆配置 #

在Vercel项目的「Settings」→「Git」页面，找到「Git Clone Depth」选项，将其设置为0（表示完整克隆仓库）。这样Vercel会拉取包括标签在内的所有仓库数据，之后再执行标签查询脚本就能正常获取结果。

方法2：在脚本中手动拉取标签 #

如果不想修改全局克隆配置，可以在执行标签查询前，先添加拉取标签的命令。调整后的脚本如下：

git fetch --tags
echo "GIT_TAG: $(git name-rev --name-only --tags HEAD)"
echo "GIT_TAGS: $(git tag --list)"

该命令会主动从远程仓库拉取所有标签信息，之后再执行查询就能得到正确结果。

验证说明 #

执行调整后的脚本后，GIT_TAGS会输出仓库所有标签，GIT_TAG也能正确返回当前提交关联的标签（如果有的话）。

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