git分支命名是协作基础设施而非风格问题，必须用feature/全小写连字符语义化命名（如feature/proj-456-login-a11y），绑定jira编号、明确范围与意图，并配合保护规则与自动化清理。
Git分支命名不是风格问题，而是协作基础设施——命名不规范，PR没人敢合，CI跑不通，线上回滚找不到源头。
feature/ 开头的分支为什么必须带语义，不能叫 feature/login
叫 feature/login 看似合理，但实际在多人项目中极易撞名、歧义、难追溯。比如：是“登录页UI”？“微信扫码登录”？还是“登录态续期逻辑”？
真正可落地的写法是：feature/user-login-flow（强调流程）、feature/oauth2-login-backend（明确范围和角色）、feature/PROJ-456-login-a11y（绑定需求ID+关注点）。
关键判断标准：别人第一次看到这个分支名，是否能立刻判断出它影响哪些模块、是否已上线、是否要参与Code Review。
- 全小写 + 连字符
-，禁用下划线_或驼峰（Git对大小写敏感，Windows/macOS/Linux行为不一致） - 避免泛动词如
fix、update、change——它们无法表达变更意图 - 如果项目用Jira等需求系统，强烈建议嵌入ID：
feature/APP-789-password-reset-email - CI脚本常靠分支名触发不同流水线，例如匹配
^feature/.*$走单元测试+构建，而^hotfix/.*$跳过部分耗时检查
hotfix/ 分支必须从 main 拉，而不是 develop
线上崩溃了，你紧急建了个 hotfix/db-timeout，但它是从 develop 拉的——这就埋了雷。develop 里可能有未测试的新功能、API变更、甚至破坏性改动。一旦把这个 hotfix 合回 main，等于把整条 develop 的不稳定状态一起带上生产环境。
- 正确操作：先
git checkout main，再git checkout -b hotfix/db-timeout - 修复完后，必须同时合并到
main和develop（顺序：先合main，打 tag，再合develop） - 很多团队漏掉第二步，导致
develop缺少该修复，下次发布又出同样问题 - GitFlow 工具如
git flow hotfix start xxx默认按此路径执行；纯命令行务必手动校验上游分支
release/ 分支不是“测试分支”，它的唯一任务是冻结版本
常见错误：把 release/v2.3.0 当成日常测试集散地，让多个功能 PR 都往里合——结果变成“谁最后推谁赢”，历史不可控，发布清单丢失。
-
release/分支应只包含即将发布的全部内容，且只允许两类操作：① 从feature/合入已完成并通过验收的功能；② 仅允许修 release 阶段发现的阻塞性 Bug（必须走hotfix/流程并 cherry-pick） - 生命周期极短：从
develop拉出 → 冻结 → 测试 → 打 tag → 合入main和develop→ 删除 - CI 应对该分支启用额外检查：镜像构建、端到端测试、合规扫描，但禁用 lint 或单元测试（这些应在 feature 阶段完成）
- 如果团队没有明确发布节奏（比如持续交付），
release/分支可完全省略，直接用main+ tag 管理版本
删除远程分支不是“善后”，而是防止误操作的关键动作
合完 PR 后没删 feature/user-login-flow，三天后有人顺手 git checkout feature/user-login-flow 继续开发——但他本地代码早已落后于 main，push 后触发二次冲突，甚至覆盖他人提交。
- GitHub/GitLab 在 PR 合并界面默认勾选 “Delete source branch”，别取消它
- 本地分支也要及时清理：
git branch -d feature/user-login-flow（-d安全删除，-D强制删） - 定期用
git branch -r --format='%(refname:short)' | grep 'feature/' | xargs -I {} git push origin --delete {}批量清理陈旧远程 feature 分支 - 更彻底的做法：CI 在成功 merge 后自动调用 API 删除对应远程分支（需配置 token 权限）
最常被忽略的一点：分支命名规范只有配合保护规则才有意义。光写 feature/xxx 没用，得在 Git 平台把 main 设为 protected branch，禁止 force-push、禁止直接 push、要求至少 1 个 approval 才能 merge——否则命名再规范，也挡不住随手一个 git push --force origin main。
