首页/开发/Git 与协作速查/分支命名约定

分支命名约定

给分支起可检索的名字:前缀 + 简短描述(如需带工单号),常见前缀有 feat/ fix/ hotfix/ release/。

Git 与协作速查开发更新于 2026-10-13

分支命名约定

给分支取可检索、可被工具识别的名字:前缀加简短描述,必要时带上工单号。常见前缀有 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发布准备分支
命名稳定后平台规则与脚本能按前缀做自动化处理,例如让热修复分支跳过部分排队流程,或让发布分支只允许特定角色推送。
工单号放在前缀之后,既能按类型检索,也能按单号反查,是多数团队采用的折中写法。
命名规范要写进团队的开发文档,并在评审模板里提示;只靠口头约定,新成员加入后很快就会出现各种风格。

易错点

  • 使用空格、中文或特殊符号会让部分平台的引用名解析与命令行补全出问题,统一用小写英文加连字符
  • 前缀与团队规范不一致会破坏自动化规则,改名要连远端引用一起处理,先对齐规范再批量调整
  • 分支名过长或把整句描述塞进去,检索与列表展示都不方便,控制在能看懂用途的长度即可
  • 改名后忘记同步远端旧分支,仓库里同时存在新旧两个名字,统计与清理时容易重复处理

数据来源与参考

  • GitLab 官方文档(分支命名建议)
  • GitHub 官方文档(分支命名与团队约定)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌