1. 引言
Git 的标签（tag）功能在很多场景下都非常实用：
- 标记特定的提交（commit）
- 使用可读性强的名称引用提交
- 元信息组织
- 版本分层
然而，本地标签与远程标签之间的同步并不是自动完成的。也就是说，删除本地标签并不意味着远程仓库中的标签也会被删除。
在本文中，我们将探讨如何同步本地与远程 Git 标签，以及如何删除本地和远程的标签。我们会先介绍如何获取远程仓库中的标签，然后讨论如何将本地标签推送到远程，最后演示如何删除本地和远程的标签。
我们使用 localrepo $ 和 remoterepo $ 分别表示在本地仓库和远程仓库中执行命令。
我们使用的测试环境是 Debian 12（Bookworm）搭配 GNU Bash 5.2.15，除非另有说明，这些命令在大多数 POSIX 兼容环境中都适用。
2. 从远程仓库获取标签
如前所述，本地仓库与远程仓库之间的标签同步取决于我们的操作方式，它们之间并不要求一一对应。
2.1 使用 clone 和 fetch 获取标签
我们可以使用 git clone 来克隆远程仓库，它会自动拉取所有标签：
$ git clone https://github.com/git/git
执行完成后，我们可以查看远程仓库的元信息：
$ git remote show origin
然后列出所有标签：
$ git tag --list
✅ 结论：使用 git clone 会自动拉取远程仓库的所有标签。
2.2 不获取标签的 fetch 操作
如果我们手动初始化仓库并添加远程仓库，然后执行 git fetch，默认情况下不会拉取所有标签。
$ git init && git remote add origin https://github.com/git/git
$ git fetch
此时，我们不会看到任何标签。
如果我们想拉取所有标签，需要加上 --tags 参数：
$ git fetch --tags
⚠️ 注意：默认的 fetch 只会拉取那些被引用的标签（例如被分支引用的标签），要拉取所有标签，必须加上 --tags。
3. 将本地标签推送到远程仓库
如果我们本地创建了标签，默认的 git push 不会自动将标签推送到远程。
3.1 初始化本地与远程仓库
我们先创建一个远程仓库 remoterepo 并提交一些内容：
$ mkdir remoterepo && git init remoterepo
$ echo 'content' > file && git add file && git commit --all --message 'init commit'
然后克隆这个远程仓库到本地：
$ git clone remoterepo localrepo
$ cd localrepo
此时本地仓库中没有标签：
localrepo $ git tag --list
3.2 创建并推送标签
我们为某个提交创建一个标签：
localrepo $ git tag minor 3a5377c
查看标签是否创建成功：
localrepo $ git log --all --decorate --oneline --graph
此时远程仓库中还没有这个标签。我们尝试普通的 git push：
localrepo $ git push
没有推送成功。我们需要加上 --tags 参数才能推送标签：
localrepo $ git push --tags
此时远程仓库中可以看到这个标签了。
✅ 结论：**要推送本地标签到远程，必须使用 git push --tags**。
4. 删除远程标签
现在我们来看看如何删除远程标签，同时保留本地标签。
4.1 使用空引用推送删除远程标签
我们可以使用如下命令删除远程标签：
localrepo $ git push origin :refs/tags/minor
⚠️ 注意：虽然可以省略 refs/tags/ 前缀，但这样做可能导致误删分支，因为 Git 的引用命名空间是共用的。
4.2 使用 --delete 参数删除远程标签
更推荐的方式是使用 --delete 参数：
localrepo $ git push --delete origin minor
这样更直观，也更不容易出错。
验证远程仓库是否已删除标签：
remoterepo $ git tag --list
此时远程仓库中已看不到 minor 标签。
4.3 删除本地标签
上面两种方式只会删除远程标签，本地标签仍然存在：
localrepo $ git tag --list
如果我们也想删除本地标签，可以使用：
localrepo $ git tag --delete minor
也可以一次性删除所有本地标签：
localrepo $ git tag --delete $(git tag)
⚠️ 警告：删除本地标签后，即使再次执行 git push，也不会影响远程标签，因为标签是静态的，不会因为本地删除而自动同步远程。
5. 总结
| 操作 | 命令 | 说明 |
|---|---|---|
| 拉取所有标签 | git fetch --tags |
默认 fetch 不会拉取所有标签 |
| 推送所有本地标签 | git push --tags |
普通 push 不会包含标签 |
| 删除远程标签 | git push --delete origin <tag> |
推荐方式 |
| 删除本地标签 | git tag --delete <tag> |
可批量删除 |
✅ 总结：Git 标签的同步需要显式控制，尤其是推送和删除操作。理解 fetch、push 和 tag 的行为对于维护仓库一致性非常重要。合理使用 --tags 和 --delete 参数可以有效避免标签不同步的问题。