应使用附注标签（annotated tag）标记正式发布版本，因其包含作者、时间、签名和说明，便于团队协作与CI/CD识别；需用git tag -a配合-m参数创建，遵循语义化版本规范，并显式推送至远程。直接用附注标签（annotated tag）标记正式发布版本，这是最稳妥、最推荐的做法。它自带作者、时间、签名和说明，团队协作和 CI/CD 流程都能可靠识别。
创建带说明的正式标签
打开终端（比如 vscode 内置终端或系统 terminal），确保你在要发布的分支上（通常是 main 或 master），然后运行：
git tag -a v1.2.0 -m "Release version 1.2.0: new dashboard and API stability fixes"- 版本号建议遵循语义化规范（MAJOR.MINOR.PATCH），如
v2.1.3或预发布版v3.0.0-rc.1 - 如果漏写
-m参数，Git 会自动唤起编辑器让你填写说明，保存退出即可
确认标签已正确生成
执行以下命令检查：
-
git tag—— 列出所有本地标签（附注标签会显示在列表中） -
git show v1.2.0—— 查看标签详情，确认包含 Tagger、Date 和你的 -m 信息 - 注意：轻量标签（
git tag v1.2.0）不带元数据，不适合正式发布
把标签推送到远程仓库
本地标签默认不会随 git push 一起上传，必须显式推送：
-
git push origin v1.2.0—— 推送单个正式标签（推荐，精准可控） -
git push origin --tags—— 推送所有本地标签（慎用，可能误推测试用标签） - 推送后，GitHub/GitLab 等平台的 “Tags” 页面就能看到该版本，并可自动生成 Release
后续维护与常见问题
如果打错标签或需更新：
- 删除本地标签：
git tag -d v1.2.0 - 删除远程标签：
git push --delete origin v1.2.0 - 重新打标再推送即可。注意：已推送的标签被他人拉取后，强制覆盖会影响协作，应避免
