Git 分支命名规范：90% 的开发者都忽略的细节

在团队协作中，Git 分支管理混乱是导致代码冲突、合并错误的主要原因之一。今天分享一套经过验证的分支命名规范。

为什么分支命名重要？

想象一下，当你看到 fix-bug 和 fix-login-timeout-issue 两个分支，哪个更清晰？好的命名能让你在三个月后还能快速理解这个分支的用途。

推荐命名格式

<type>/<scope>/<short-description>

常见类型 (type)

• feat: 新功能
• fix: Bug 修复
• docs: 文档更新
• refactor: 代码重构
• test: 测试相关
• chore: 构建/工具配置

实际案例

feat/auth/add-oauth-login
fix/payment/timeout-handling
docs/api/update-endpoint-list
refactor/user/optimize-query

实用技巧

1. 用小写字母：Feat/Login ❌ feat/login ✅
2. 用连字符分隔：feat_add_login ❌ feat-add-login ✅
3. 保持简短：分支名不超过 50 字符
4. 避免特殊字符：只用字母、数字、连字符、斜杠

我的自动化脚本

我在 .gitconfig 中添加了别名：

[alias]
    nb = !"f() { git checkout -b feat/$1; }; f"

使用 git nb add-search 自动创建 feat/add-search 分支。

总结

好的分支命名是专业开发者的标志。花 5 秒钟想个好名字，能节省后续 50 分钟的沟通成本。