git tag
是 Git 中的一个命令,用于创建、列出、删除或验证标签。标签通常用于为特定的提交点提供一个易于记忆的名称,这在发布软件版本时特别有用。下面是 git tag
的一些常见用法:
1. 列出所有标签
列出仓库中的所有标签:
git tag
2. 创建标签
为当前HEAD指向的提交创建标签:
git tag v1.0
为特定提交创建标签(使用提交的哈希值或引用):
git tag v1.0 commit_hash
创建带注释的标签(通常用于发布):
git tag -a v1.0 -m "Version 1.0"
这会打开一个文本编辑器来输入标签的注释信息。
3. 查看标签信息
查看特定标签的详细信息:
git show v1.0
4. 推送标签
将标签推送到远程仓库:
git push origin v1.0
推送所有标签到远程仓库:
git push origin --tags
5. 删除标签
删除本地标签:
git tag -d v1.0
删除远程标签(先删除本地标签,再推送删除到远程):
git tag -d v1.0
git push origin :refs/tags/v1.0
6. 校验标签
校验一个已签名的标签:
git tag -v v1.0
这将验证标签的GPG签名。
7. 检出标签
虽然不常见,但你可以检出标签,这会将你的工作目录切换到标签所指向的状态,但请注意,这将处于一个“分离头指针”状态,此时任何提交都会创建一个新的匿名分支。
git checkout v1.0
通常,你会希望创建一个新的分支来基于标签工作:
git checkout -b new_branch_name v1.0
这些只是 git tag
的一些基本用法。根据具体的用例和需求,可能还有其他高级选项和用法。要获取完整的 git tag
命令选项和文档,可以在命令行中输入 git tag --help
。