---
url: /zh/repo/settings-tag.md
description: 介绍如何通过 .cnb/settings.yml 配置自动打 Tag 的触发分支，实现代码推送时自动创建版本标签，规范化版本管理流程。
---
配置自动打 Tag 的触发分支，实现推送代码时自动创建版本标签。

## 使用场景

* 在特定分支（如 hotfix 分支）推送时自动打 Tag
* 规范化版本标签的生成流程
* 减少手动打 Tag 的操作成本

## 配置方式

在 `.cnb/settings.yml` 中添加 `tag` 配置：

```yaml title=".cnb/settings.yml"
# tag 配置，读取仓库默认分支 .cnb/settings.yml 配置
tag:
  # 自动生成 Tag 配置
  auto_tag:
    # 指定触发自动打 Tag 的分支名，如不配置则默认使用仓库默认分支来创建 Tag
    branch: hotfix
```

## 参数说明

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `tag.auto_tag.branch` | string | 仓库默认分支 | 触发自动打 Tag 的分支名 |

:::tip
如果不配置 `branch` 参数，则默认使用仓库的默认分支来创建 Tag。
:::