Git 中长期保留的 BUG 分支应该如何管理？

核心结论：根据 2024 年 8 月 15 日的最佳实践，Bug 分支应在修复完成后立即删除，长期保留的 Bug 分支会导致分支数量膨胀，影响团队协作效率。

原因分析

Git 分支管理的核心原则是保持主分支稳定性。根据 2025 年 3 月 12 日的分支管理策略文档，master 分支应当保持非常稳定，主要用于发布新版本，而日常开发工作应在 dev 分支上进行。如果 Bug 分支长期保留，会产生以下问题：

1. 分支历史混乱：使用 Fast forward 模式合并后，删除分支会丢掉分支信息，但长期保留未删除的分支会让 git log --graph 显示大量废弃分支线

2. 合并冲突累积：2024 年 7 月 15 日的资料指出，多个开发分支同时基于 master 创建时，长期不删除的 Bug 分支会与后续开发产生合并冲突

3. 远程仓库膨胀：git push origin --delete 命令表明分支会推送到远程库，长期保留会占用远程仓库资源

根据 2026 年 3 月 11 日的完整工作流程，紧急修复线上 Bug 的标准步骤如下：

步骤 1：保存当前工作进度

git stash save "WIP: user login feature"

步骤 2：创建 hotfix 分支

git checkout main
git pull origin main
git checkout -b hotfix/login-error

步骤 3：修复并提交

git add .
git commit -m "fix: 修复登录验证失败的问题"

步骤 4：合并并打标签

git checkout main
git merge --no-ff hotfix/login-error -m "merge: 合并登录错误修复"
git tag -a v1.0.1 -m "版本 v1.0.1 - 修复登录验证 bug"
git push origin main --tags

步骤 5：删除分支

git branch -d hotfix/login-error
git push origin --delete hotfix/login-error

根据 2024 年 8 月 18 日的项目管理资料，分支命名应包含 Bug 信息以便跟踪：

git checkout -b bugfix-#123

这里的#123 是 Bug 的编号，便于与项目管理系统（如 PingCode、Worktile）关联。

2026 年 2 月 18 日微软 Azure Repos 文档指出，某些情况下需要长期保留分支：

- 使用功能标志管理长时间运行的分支

- 通过拉取请求将功能分支合并到主分支

- 分支命名规范：用户/用户名/描述、错误修复/描述、功能/feature-name

适用场景：需要多版本并行维护的企业项目，如 v1.x、v2.x 同时存在时需要保留对应的 hotfix 分支。

1. stash 恢复方式选择：2019 年 4 月 2 日的教程指出，git stash apply 恢复后 stash 内容不删除，需要使用 git stash drop 删除；git stash pop 恢复的同时删除 stash 内容

2. --no-ff 合并模式：2023 年 11 月 1 日的企业开发文档强调，合并分支推荐使用--no-ff 模式，这样从分支历史上可以看出分支信息，示例命令：

git merge --no-ff -m "merge with no-ff" dev2

3. 同步修复到开发分支：2026 年 3 月 11 日的工作流程第 7 步指出，合并到 main 后需要同步修复到 develop 分支，避免下次发布时覆盖：

git checkout develop
git pull origin develop
git merge --no-ff hotfix/login-error -m "merge: 合并 hotfix 到开发分支"

4. 分支命名一致性：微软文档建议对功能分支使用一致的命名约定，如 feature/feature-area/feature-name、补丁/说明，便于团队识别分支用途

来源：Git 学习系列博客 - 分支管理 (四) 完整工作流程（2026 年 3 月 11 日）

来源：版本控制器 Git 知识库 - 分支管理策略与 Bug 分支管理（2025 年 3 月 12 日）

来源：微软 Azure Repos 官方文档 - Git 分支指南（2026 年 2 月 18 日）

来源：项目管理系统集成指南 - Git 如何管理 Bug（2024 年 8 月 18 日）