如何高效为Git单分支浅克隆同步指定上游标签

方案一：本地直接创建对应标签（最快，无额外下载） #

既然你的本地浅克隆已经包含目标标签指向的提交，完全可以通过git ls-remote获取上游标签信息，再批量在本地创建标签，全程不用从上游下载额外数据：

1. 先获取上游仓库的jdk-*标签列表，保存到临时文件：

git ls-remote --refs -t upstream 'refs/tags/jdk-*' > tags.txt

2. 过滤出本地已存在的提交对应的标签（跳过本地没有的提交的标签）：

while read hash tag; do
  if git cat-file -e "$hash^{commit}" 2>/dev/null; then
    echo "$hash ${tag#refs/tags/}"
  fi
done < tags.txt > local_tags.txt

3. 批量创建本地标签：

while read hash tag; do
  git tag "$tag" "$hash"
done < local_tags.txt

整个流程几秒就能完成，完全不会产生GB级的下载量。

方案二：先同步标签到GitHub Fork，再从Fork拉取 #

如果希望把上游标签同步到自己的Fork方便后续复用，可以用GitHub CLI（gh）操作：

1. 确保已安装并登录gh，执行以下命令同步上游jdk-*标签到你的Fork：

gh repo sync your-username/jdk --source openjdk/jdk --tags --filter 'jdk-*'

2. 回到本地浅克隆仓库，从你的Fork拉取这些标签（因为Fork已经有标签，拉取时不会下载大量冗余数据）：

git fetch origin 'refs/tags/jdk-*:refs/tags/jdk-*'

补充：为什么常规git fetch会下载大量数据？ #

Git默认拉取标签时，会自动拉取标签指向提交的完整依赖历史——哪怕你用了浅克隆，这个逻辑也会触发全量数据下载。目前Git原生的fetch对标签的浅拉取支持有限，所以上面的两种方法是更高效的替代方案。

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