核心用法
post-merge-rename 是一款 Git 分支管理工具,专注于历史保留式分支清理。与传统直接删除分支的做法不同,它通过重命名(而非删除)来标记已合并分支的状态。
三种使用模式:
- 批量扫描并重命名所有已合并分支
--dry-run预览模式,安全验证操作结果- 针对特定分支的精准重命名
工作流程: 扫描 main 分支的已合并分支 → 过滤已重命名分支(含 --merged- 标识)→ 提取合并日期 → 执行重命名(如 feature-branch → feature-branch--merged-2026-03-09)→ 推送新分支至远程 → 清理旧分支名
显著优点
1. 零数据丢失:物理保留分支历史,满足审计与回溯需求
2. 状态可识别:日期后缀清晰标识分支生命周期节点
3. 自动化集成:作为 wip-release 流水线第10步运行,减少人工干预
4. 操作可逆:重命名操作比删除更容易恢复
潜在缺点与局限性
- 命名污染:长期积累会导致分支列表膨胀,影响可读性
- 远程同步复杂:需同时处理本地与远程分支的重命名与清理
- 日期依赖:合并日期提取依赖 Git 历史,变基或快进合并可能导致日期不准确
- 无权限管控:脚本无内置权限检查,可能误操作保护分支
适合人群
- 需要严格审计追踪的金融、医疗等合规敏感团队
- 偏好保守分支策略的企业级开发流程
- 使用
wip-release工具链的 DevOps 工程师
常规风险
- 误将未稳定分支识别为已合并(依赖
git branch --merged准确性) - 远程分支清理失败导致新旧分支并存
- 日期格式硬编码,跨时区协作可能产生歧义
- 无交互确认机制,批量运行时风险集中