## 2.6 打标签
Git 可以给历史中的某一个提交打上标签,以示重要,比如用来标记发布结点,即版本号。
### 2.6.1 列出标签 {#451-查看标签}
如果想要查看仓库中的标签信息,可以使用 `tag` 命令列出所有标签:
```
$ git tag
```
并且可以配合搜索模式列出符合条件的标签:
```
$ git tag -l 'v1.4.2.*'
```
以及查看指定标签信息:
```
$ git show [tag]
```
### 2.6.2 创建标签
Git 使用两种主要类型的标签:轻量标签(lightweight)与附注标签(annotated)。
* **轻量标签:**轻量标签只是一个特定提交的引用,就像一个不会改变的分支。
* **附注标签:**附注标签是存储在 Git 数据库中的一个完整对象。 可以被校验的;其中包含打标签者的名字、电子邮件地址、日期时间;还有一个标签信息;并且可以使用 GNU Privacy Guard (GPG)签名与验证。
**附注标签**
新建含附注的标签,只要附加`-a`选项:
```
$ git tag -a [tag] -m 'info'
```
`-m`选项指定了一条将会存储在标签中的信息,如果没有为附注标签指定一条信息,Git 会运行编辑器要求输入信息。
**轻量标签**
轻量标签本质上是将提交校验和存储到一个文件中 - 没有保存任何其他信息。 创建轻量标签,不需要使用`-a`、`-s`或`-m`选项,只需要提供标签名字:
```
$ git tag [tag]
```
**追加标签**
Git 支持对过去的某个提交添加标签,只需在执行添加标签操作时指定提交的 `SHA-1` 即可:
```
$ git tag [tag] [SHA-1]
$ git tag -a [tag] -m 'info [SHA-1]
```
### 2.6.3 标签管理
**共享标签**
默认情况下,`git push` 命令不会传送标签到远程服务器上,所以在创建标签后需要显式地推送标签:
```
$ git push [remote] [tag]
```
如果想要一次性推送多个标签,可以使用 `--tags` 参数命令 Git 将所有不在远程库上的标签如数上传:
```
$ git push [remote] --tags
```
**删除标签**
如果想要删除指定标签需要指定参数 `-d`:
```
$ git tag -d [tag]
```
而如果想要删除已经推送的远程标签,需要先在本地删除标签,然后通过命令推送到远程服务器:
```
$ git push [remote] :refs/tags/[tag]
```
**检出标签**
在 Git 中并不能真的检出一个标签,因标签不能像分支一样来回移动,所以如果需要使工作目录与仓库中某个标签版本一样,可以使用 `checkout` 命令创建一个新分支,Git 会在指定标签上新创建一个分支:
```
$ git checkout -b [branch] [tag]
```
- 介绍
- 第一章 起步
- 1.1 关于版本控制
- 1.2 Git 简史
- 1.3 Git 基础
- 1.4 命令行
- 1.5 安装 Git
- 1.6 初次运行 Git 前的配置
- 1.7 获得帮助
- 第二章 基础
- 2.1 获取仓库
- 2.2 记录每次更新到仓库
- 2.3 查看提交历史
- 2.4 撤销操作
- 2.5 远程仓库的使用
- 2.6 打标签
- 2.7 Git 别名
- 第三章 分支
- 3.1 分支简介
- 3.2 分支的新建与合并
- 3.3 分支管理
- 3.4 分支开发工作流
- 3.5 远程分支
- 3.6 变基
- 第四章 服务器上的 Git
- 4.1 协议
- 4.2 在服务器上搭建 Git
- 4.3 生成 SSH 公钥
- 4.4 配置服务器
- 4.5 Git 守护进程
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 第三方托管的选择
- 第五章 分布式 Git
- 5.1 分布式工作流程
- 5.2 向一个项目贡献
- 5.3 维护项目
- 第六章 GitHub
- 6.1 账户的创建和配置
- 6.2 对项目做出贡献
- 6.3 维护项目
- 6.4 管理组织
- 6.5 脚本 GitHub
- 第七章 Git 工具
- 7.1 选择修订版本
- 7.2 交互式暂存
- 7.3 储藏与清理
- 7.4 签署工作
- 7.5 搜索
- 7.6 重写历史
- 7.7 重置揭密
- 7.8 高级合并
- 7.9 Rerere
- 7.10 使用Git调试
- 7.11 子模板
- 7.12 打包
- 7.13 替换
- 7.14 凭证存储
- 第八章 自定义 Git
- 8.1 配置 Git
- 8.2 Git 属性
- 8.3 Git 钩子
- 8.4 使用强制策略的一个例子
- 第九章 Git 与其他系统
- 9.1 作为客户端的 Git
- 9.2 迁移到 Git
- 第十章 Git 内部原理
- 10.1 底层命令和高层命令
- 10.2 Git 对象
- 10.3 Git 引用
- 10.4 包文件
- 10.5 引用规格
- 10.6 传输协议
- 10.7 维护与数据恢复
- 10.8 环境变量
