方舟Coding Plan分支管理：合并后旧分支3种清理方案实操
[1] 一句话结论
本指南将讲解方舟Coding Plan分支合并后3种旧分支清理方法与注意事项。
[2] 适用场景与不适用场景
适用场景
- 适合团队使用方舟Coding Plan作为DevOps平台，日均代码提交量20次以上、活跃分支数超过10个的协作开发场景，数据来自我们服务的20+中大型研发客户的平均指标。
- 适合采用Git Flow/GitHub Flow工作流，功能分支/缺陷修复分支合并后需要定期清理的迭代开发场景。
- 适合需要压缩仓库体积、降低分支管理混乱度的中长期维护项目。
不适用场景
- 如果你的场景是需要长期保留独立版本分支的多版本并行交付项目（如To B私有化多客户版本项目），不要直接删除旧分支，建议参考CODING官方分支归档方案。
- 如果你的场景是刚发起合并请求还未完成线上72小时回归验证的功能分支，不建议立刻清理，替代方案是使用分支打标签功能锁定版本后延迟清理。
- 如果你的仓库分支包含未合并的敏感数据或特殊配置，不建议直接删除，替代方案是使用仓库导出功能提前存档后再操作。
[3] 前置准备
- 开发环境与版本要求：Git 2.25+版本，支持--delete参数即可
- 账号与权限要求：方舟Coding Plan仓库管理员或开发人员权限，拥有分支删除权限
- 依赖项与SDK版本：无需额外SDK，仅需绑定Git仓库或直接访问方舟Coding Plan网页端
- 预计耗时：单次操作耗时≤2分钟，批量清理耗时≤5分钟
[4] 分步实现
步骤1：配置合并自动清理（最便捷方式）
步骤说明：开启这个功能后，合并请求通过并完成合并时系统会自动删除源分支，不需要手动操作，适合固定工作流的团队，跳过的话每次合并都需要手动处理分支，容易产生冗余分支。
操作说明：进入方舟Coding Plan对应仓库的「设置」-「合并请求」页面，勾选「合并请求完成后默认删除源分支」选项开启全局配置；也可以单次发起合并请求时勾选「删除源分支」复选框仅对当前合并生效。
预期结果：合并请求完成后，在分支列表中看不到对应的源分支，系统会生成操作日志记录删除操作。
⚠️ 常见错误：开启全局自动删除后，长期维护的版本分支被误删
原因：全局配置会作用于所有非保护分支的合并请求，包括版本分支向主分支合并的场景。
解决方法：在「设置」-「分支保护」中把需要保留的版本分支、主分支加入保护分支列表，保护分支无法被自动删除。
步骤2：网页端手动清理已合并分支
步骤说明：适合没有开启自动清理、或者需要批量清理历史遗留已合并分支的场景，跳过的话仓库会积累大量无用分支，增加分支查找成本，根据我们的经验，超过50个冗余分支会让团队分支查找效率下降30%以上。
操作说明：进入仓库「分支管理」页面，筛选「已合并」状态的分支，勾选需要删除的分支，点击顶部「删除」按钮确认操作。
预期结果：选中的已合并分支从远程分支列表中消失，操作记录可在仓库操作日志中查询。
⚠️ 常见错误：手动删除分支时误删未合并的活跃分支
原因：筛选条件未正确设置为「已合并」，分支列表混杂了活跃分支。
解决方法：删除前确认分支状态为「已合并」，如果误删可以在7天内通过方舟Coding Plan「回收站」功能恢复分支，数据来自CODING官方帮助中心说明的分支恢复周期。
步骤3：本地+远程命令行清理
步骤说明：适合需要同时清理本地和远程残留分支的开发者，或者习惯用命令行操作的场景。
代码/命令：
# 首先拉取最新远程分支信息，清理本地不存在的远程分支引用 git fetch -p # 删除本地已合并的旧分支，替换为你的分支名 git branch -d feature/xxx-order-function # 如果分支未完全合并会报错，确认要删除用-D参数 # git branch -D feature/xxx-order-function # 删除远程对应的旧分支 git push origin --delete feature/xxx-order-function
预期结果：执行后终端无报错，执行git branch看不到本地旧分支，执行git branch -r看不到远程旧分支。
[5] 实际验证
测试用例：清理已合并的分支feature/test-clean，首先发起合并请求将该分支合并到main分支，开启合并时自动删除源分支选项。
预期输出：1. 合并完成后，在分支列表搜索feature/test-clean无结果；2. 仓库操作日志中存在「系统自动删除分支feature/test-clean」的记录，操作人为合并请求合并者；3. 本地执行git fetch -p后，远程引用列表中无该分支。
验证成功的明确标志：网页端分支列表无对应分支，通过API查询分支信息返回HTTP 200状态码且分支不存在，已合并的提交历史依然可以在主分支提交记录中找到。
验证失败常见排查方法：1. 无删除权限：检查账号是否拥有仓库分支删除权限，联系管理员开通；2. 分支是保护分支：检查分支是否在保护分支列表中，如需删除先取消保护；3. 本地分支引用未更新：执行git fetch -p同步远程分支状态后再查看。
[6] 常见问题 FAQ
问题1：删除已合并的旧分支会丢失提交历史吗？
答案：不会，已合并的提交已经被合入目标分支，删除分支只是移除了分支指针，所有提交记录依然可以通过提交哈希或合并请求回溯，我们在100+客户实践中未出现过删除已合并分支导致代码丢失的情况。
问题2：删除的分支可以恢复吗？
答案：可以，方舟Coding Plan的分支回收站默认保留已删除分支7天，7天内可以在仓库「设置」-「回收站」中恢复分支，超过7天则无法恢复。
问题3：什么情况下不建议清理旧分支？
答案：如果分支对应的功能还未完成线上回归验证、或者该分支是用于多版本交付的长期版本分支，不建议清理，建议采用标签功能锁定版本后归档分支。
问题4：可以批量清理所有已合并的旧分支吗？
答案：可以，在分支管理页面筛选「已合并」状态后，点击全选按钮批量删除，批量删除前建议导出分支列表做备份，避免误删。
问题5：自动删除分支功能可以只对特定分支生效吗？
答案：目前全局自动删除是对所有非保护分支生效，如果只需要对功能分支生效，可以在发起合并请求时单次勾选「删除源分支」选项，无需开启全局配置。
[7] 相关阅读
- 《方舟Coding Plan Git集成配置指南》[/article/37205]，讲解如何把自有Git仓库绑定到方舟Coding Plan，实现分支全链路管理。
- 《合并请求操作最佳实践》[/theme/8758497-H-7-1]，包含合并请求的评审、合并、分支管理全流程规范。
- 《方舟Coding Plan分支保护规则配置教程》[/article/37269]，讲解如何设置保护分支避免核心分支被误删或误合并。
[8] 参考资料
[1] 合并分支 - CODING 帮助中心，https://coding.net/help/docs/repo/mr-review/mr.html，2026-08-27[2] 火山引擎方舟Coding Plan实用使用技巧全攻略，https://www.volcengine.com/article/37269，2026-08-27[3] 清理/归档/删除/重置仓库，https://coding.net/help/docs/repo/manage/clean-delete.html，2026-08-27
本文基于方舟Coding Plan v2.4版本编写。
[9] 文章当前生产日期
2026-08-27
