git tag
为特定提交创建标签,通常用于标记发布版本号
语法
git tag [<options>] [<tagname>] [<commit>]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
-a |
创建附注标签(包含作者、日期、信息) | |
常用 |
-m <message> |
指定标签信息 | |
常用 |
-d |
删除本地标签 | |
常用 |
-l <pattern> |
列出匹配模式的标签 | |
常用 |
-f |
强制覆盖已存在的标签 | |
常用 |
示例
创建轻量标签
git tag v1.0.0
创建附注标签并添加说明
git tag -a v1.0.0 -m "正式发布 1.0.0 版本"
为历史提交打标签
git tag -a v0.9.0 abc1234
列出所有 v1 开头的标签
git tag -l "v1.*"
v1.0.0
v1.0.1
v1.1.0
推送单个标签到远程
git push origin v1.0.0
推送所有本地标签到远程
git push origin --tags
删除本地标签
git tag -d v1.0.0
技巧
- 发布版本时建议使用附注标签(-a),包含更多元信息
- 标签默认不会被 push,需要显式推送
- 删除远程标签:git push origin --delete v1.0.0
- 遵循语义化版本号:主版本.次版本.修订号(如 v2.1.3)