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

分支命名约定

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

Git 与协作速查开发更新于 2026-10-12
组成前缀/描述(可含工单号)
常见前缀feat、fix、hotfix、release、chore
检索git branch --list 'feat/*'

常用示例

常用示例
# 命名示例
# feat/login-sso
# fix/231-retry
# hotfix/1.2.1
# release/2.4.0
git branch -a --list 'feat/*'
命名稳定后,平台规则与脚本能按前缀做自动化处理,例如 hotfix 走快速通道。

易错点

  • 空格、中文与特殊符号会给平台与工具链带来兼容问题,统一用小写英文加连字符
  • 前缀与团队规范不一致会破坏自动化规则,先对齐再批量改名

数据来源与参考

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