工程开发
git-branch-cleanup avatar

git-branch-cleanup

分析并安全清理本地 Git 分支,提供交互式分类、安全防护与工作树 (worktree) 支持。

简介

git-branch-cleanup 是一个专为开发人员与 DevOps 工程师设计的工具,旨在维护整洁的本地开发环境。随着时间推移,本地 Git 存储库往往会积累过时、已合并或孤立的分支,这会使开发工作流程变得混乱并增加认知负担。此技能通过根据分支与基础分支(如 main 或 master)的关系、最后提交活动以及远程追踪状态进行分类,自动执行这些分支的识别与安全移除。

  • 将分支分为特定类别:已合并(安全删除)、远程已删除(gone)、过时(30 天以上无活动)、未合并(进行中)以及与 Git 工作树相关联的分支。

  • 实施严格的安全防护机制,防止删除 main、master、trunk 等关键分支及当前检出的分支。

  • 提供交互式分步骤工作流程:分析当前状态、审核安全分类、确认删除并执行清理。

  • 支持高级 Git 功能,包括检测与正确管理 git worktree 关联,以避免删除过程中导致文件系统损坏。

  • 具备预览删除(Dry Run)模式,用户可在执行任何指令前预览删除结果,确保对存储库维护的完全掌控。

  • 利用标准 Git 指令(如 for-each-ref、branch --merged 及 branch -vv)确保在标准 Git 环境下的可靠性。

  • 推荐给管理大型存储库或遵循敏捷开发工作流程(频繁产生功能分支)的开发者使用。

  • 此工具需具备 Git 2.17+ 以获得完整工作树支持,建议 Git 2.22+ 以获得最佳分支识别能力。

  • 常见使用场景包括:合并后清理分支、移除链接至已删除远程 PR 的分支,以及识别长期遗忘的实验性分支。

  • 用户需注意,「过时」门槛是可配置的;默认的 30 天窗口可根据特定团队的冲刺(Sprint)周期或项目需求进行调整。

  • 该技能区分了针对已合并分支的「git branch -d」安全删除,以及针对未合并或孤立分支的强制「-D」删除,并提供何时使用何者清楚的指导。

仓库统计

Star 数
382
Fork 数
26
Open Issue 数
3
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月1日 07:05
在 GitHub 查看