分支命名约定
给分支取可检索、可被工具识别的名字:前缀加简短描述,必要时带上工单号。常见前缀有 feat、fix、hotfix、release、chore。命名稳定之后,平台规则与流水线才能按前缀做自动化处理,团队检索也更加轻松。
基本信息
| 组成 | 前缀加简短描述,可含工单号 |
|---|---|
| 常见前缀 | feat 功能、fix 缺陷、hotfix 热修复、release 发布、chore 杂务 |
| 命名风格 | 小写英文加连字符,避免空格与中文 |
| 检索方式 | git branch --list 'feat/*' |
| 自动化收益 | 按前缀触发不同流水线,热修复可走快速通道 |
典型使用场景
- 团队统一命名以便检索与统计分支数量
- 按前缀触发不同的流水线配置
- 热修复与常规开发走不同的评审通道
- 批量审阅时按类型分组查看分支列表
- 新人按命名规范快速理解分支用途
常用示例
常用示例
git switch -c feat/login-sso # 新功能分支
git switch -c fix/231-retry # 缺陷修复,带工单号
git switch -c hotfix/1.2.1 # 线上热修复,对应补丁版本
git switch -c release/2.4.0 # 发布准备分支
git branch -a --list 'feat/*' # 按前缀检索
git branch -m fix/232-timeout # 命名不合规时及时改名命名示例
| 分支名 | 含义 |
|---|---|
| feat/login-sso | 新功能开发,单点登录支持 |
| fix/231-retry | 缺陷修复,关联工单号 |
| hotfix/1.2.1 | 线上紧急修复,对应补丁版本 |
| release/2.4.0 | 发布准备分支 |
命名稳定后平台规则与脚本能按前缀做自动化处理,例如让热修复分支跳过部分排队流程,或让发布分支只允许特定角色推送。
工单号放在前缀之后,既能按类型检索,也能按单号反查,是多数团队采用的折中写法。
命名规范要写进团队的开发文档,并在评审模板里提示;只靠口头约定,新成员加入后很快就会出现各种风格。