必须通过VSCode集成终端执行git tag -a v1.2.0 -m "Production release"创建附注标签,因其含作者、时间、签名等完整元数据,是CI/CD触发发布的唯一可靠依据,轻量标签无法升级且不被识别。

VSCode 中 Git 标签不会自动推送到远程仓库,必须手动触发推送;轻量标签适合临时标记,附注标签才是正式发布的唯一可靠选择。
怎么在 VSCode 里创建附注标签而不是轻量标签
VSCode 的图形界面本身不提供「创建附注标签」的按钮,必须通过集成终端执行 git tag -a 命令。轻量标签(git tag v1.0.0)只是对某次提交的引用,没有作者、时间、签名等元数据,CI/CD 系统通常无法识别其发布意图。
- 附注标签是完整 Git 对象,含作者邮箱、时间戳、消息体,部分 CI 工具(如 GitHub Actions)靠它触发 release 流程
-
git tag -a v1.2.0 -m "Production release"是最低安全要求;省略-m会唤起编辑器,容易卡住流程 - 不要用
git tag v1.2.0后再补注释——轻量标签无法升级为附注标签,只能删掉重打
为什么 git push origin --tags 有时会推送错标签
这个命令会把所有本地标签一股脑推上去,包括你忘了删的测试标签(比如 v1.2.0-test 或 tmp-debug),污染远程 tags 列表,且无法撤回(Git 不允许强制覆盖已推送的标签)。
- 团队协作中,应只推送明确用于发布的附注标签
- 推荐始终用单个推送:
git push origin v1.2.0,确保精准可控 - 如果真要批量推送,先用
git tag --sort=version:refname检查顺序,再人工确认范围
VSCode 源代码管理面板里的 “Push Tags” 按钮到底推什么
该按钮等价于 git push origin --tags,不是智能筛选,也不区分轻量/附注类型,更不会跳过已存在的同名标签。它只是把当前本地所有 git tag 输出的内容全部发走。
- 如果你本地有 50 个标签,其中 3 个是正式版,47 个是废弃测试标签,点一次就全上去了
- 该按钮不校验标签是否已存在远程——重复推送同名标签会失败并报错
error: failed to push some refs to '...' - 建议关闭对该按钮的依赖,改用终端命令,眼见为实
真正容易被忽略的是:附注标签一旦推送到远程,就不该修改或删除;哪怕发现消息写错,也应新建 v1.2.1 而非覆盖 v1.2.0 ——很多 CI/CD 系统和包管理器(如 npm、PyPI)依赖标签的不可变性做版本解析。


















