在 Git 中，`tag` 是用来标记某个特定的提交点（通常是发布版本或重要的里程碑）的工具。通过 `git tag`，你可以为版本号创建标记，帮助团队跟踪不同版本的代码。
如果你想创建一个新的版本号标签，可以按照以下步骤进行：
### 1. **查看已有标签**
在创建新的版本号之前，你可以查看当前已有的标签，以避免版本号重复。
```bash
git tag
```
这会列出所有当前的标签。
### 2. **创建新标签**
在 Git 中，你可以创建**轻量标签**（lightweight tag）或**附注标签**（annotated tag）。
- **轻量标签**：只是某个提交的引用，没有附加的元数据。
- **附注标签**：包含标签的作者、日期、说明和提交等信息，推荐用于发布版本。
#### 创建附注标签（推荐用于发布版本号）
假设你要为版本 `v1.0.0` 创建一个标签，命令如下：
```bash
git tag -a v1.0.0 -m "Release version 1.0.0"
```
- `-a v1.0.0`：指定标签名称为 `v1.0.0`。
- `-m "Release version 1.0.0"`：为标签添加一条注释（可以描述版本的更改、特点等）。
#### 创建轻量标签
如果不需要附加信息，直接创建一个轻量标签：
```bash
git tag v1.0.0
```
这将为当前提交创建一个标签 `v1.0.0`。
### 3. **为特定的提交创建标签**
如果你不想给当前的提交打标签，而是给某个历史提交打标签，可以通过提交的哈希值来指定。
```bash
git tag -a v1.0.0 <commit-hash> -m "Release version 1.0.0"
```
其中，`<commit-hash>` 是你想要打标签的提交的哈希值，可以使用 `git log` 查看。
### 4. **推送标签到远程仓库**
默认情况下，Git 标签只存在于本地仓库。要将标签推送到远程仓库，使用以下命令：
- 推送单个标签：
```bash
git push origin v1.0.0
```
- 推送所有标签：
```bash
git push --tags
```
### 5. **查看标签信息**
要查看某个标签的详细信息，可以使用 `git show` 命令：
```bash
git show v1.0.0
```
这将显示标签 `v1.0.0` 所关联的提交信息。
### 6. **删除标签**
如果你创建了一个错误的标签或需要删除旧的标签，可以使用以下命令删除本地和远程的标签。
- 删除本地标签：
```bash
git tag -d v1.0.0
```
- 删除远程标签：
```bash
git push origin --delete tag v1.0.0
```
删除标签后，你可以重新创建一个新的标签。
业务系统中使用该sdk,需要拉取,会自动更新到最新的tag标签
### 总结
- 使用 `git tag -a v1.0.0 -m "message"` 创建版本标签。
- 使用 `git push origin v1.0.0` 将标签推送到远程仓库。
- 使用 `git tag` 查看和管理标签。
通过 Git 标签管理，你可以轻松跟踪项目的不同版本，尤其在发布新版本时非常有用。
