必须用 -a 才算真正发布用的标签，因为轻量标签仅是 commit 指针，无作者、时间、GPG 签名等元数据，CI/CD 和审计工具通常忽略；而附注标签是独立 Git 对象，含完整签名信息，被 GitHub/GitLab 识别为可信发布标记。
Git 默认不自动保存标签作者、时间或说明，git tag -a 是唯一能生成带完整元数据标签的命令，不用它就等于只存了个“书签”。
为什么必须用 -a 才算真正发布用的标签
轻量标签（比如直接 git tag v1.0）只是个指向 commit 的指针，没有作者、时间、GPG 签名能力，CI/CD 流水线或审计工具通常直接忽略它。附注标签才是 Git 官方推荐的发布标记方式。
-
git tag -a v1.0 -m "release candidate"会生成一个独立对象，包含 Tagger、Date、message - 执行
git show v1.0能看到完整签名信息；而轻量标签执行同样命令只显示 commit 内容 - GitHub/GitLab 页面上，只有附注标签才会显示「Tagged by XXX on YYYY-MM-DD」这类可信信息
git tag -a 不加 -m 会卡住，别硬等编辑器弹出来
如果你运行 git tag -a v1.0 却没跟 -m，Git 会立刻调用默认编辑器（通常是 vim 或 nano），但很多人没意识到这点，以为命令卡死或失败了。
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
- 在终端里看到空白界面或冒号提示符（vim）→ 按
i进入输入模式，写完按Esc，再输:wq保存退出 - 想跳过编辑器交互？直接加
-m：例如git tag -a v1.0 -m "v1.0 final" - 如果误进了编辑器又不想写，按
Esc后输:q!强制退出，标签不会被创建
给历史提交打标签时，commit ID 写错一位就失败
git tag -a 支持给任意历史 commit 打标签，但 commit ID 必须存在且可解析——哪怕少输一位字符，Git 就报 fatal: Not a valid object name。
- 先用
git log --oneline -n 5查最近几条提交，复制前 7～8 位哈希（如9fbc3d0）足够唯一 - 命令格式严格：
git tag -a v0.9.1 9fbc3d0 -m "hotfix for login"，顺序不能颠倒（tag 名必须在 commit ID 前） - 打完后用
git tag -l "v0.9*"验证是否成功，别只信终端没报错
本地打了 -a 标签，远程却看不到？推送不是自动的
git push origin main 之类操作完全不会上传任何标签，这是新手最常漏掉的一步。
- 推单个标签：
git push origin v1.0（注意：不是git push origin tag v1.0） - 推所有新标签：
git push origin --tags（注意是--tags，不是-tags或--tag） - 如果远程已有同名标签，
--tags不会覆盖，得先git push origin --delete v1.0再重推
附注标签的 author 和 committer 信息来自 git config user.name/user.email，改配置后新打的标签才会更新——旧标签的元数据不可变，这点容易被忽略。
