Clean Branches

Clean Branches

清理已合入的 Git 分支，联动删除本地和远程。

核心流程

1. 收集状态

并行执行以下命令：

# 当前分支 + 本地全部分支 + 跟踪关系
git branch -vv

# worktree 列表（防止误删正在使用的分支）
wt list 2>/dev/null || git worktree list

# 所有远程分支
git branch -r

# 已合并入当前分支的本地分支（排除当前分支和 main/master）
git branch --merged | sed 's/^\* //' | grep -vE '^(main|master|develop|HEAD)$' | grep -v "^$(git rev-parse --abbrev-ref HEAD)$"

# 检测 squash merge（GitHub squash merge 无 merge commit，--merged 不识别）
# 两类检测方法：
#   a) release/* 分支：匹配对应 tag 是否存在（release 分支的 version bump 使 three-dot diff 永远非空）
#      如 release/<version> -> 查 v<version> tag
#   b) 其他分支：three-dot diff 为空 -> 分支内容已合入
git branch | sed 's/^\* //' | grep -vE '^(main|master|develop|HEAD)$' | grep -v "^$(git rev-parse --abbrev-ref HEAD)$" | while read -r b; do
  b="${b# }"  # 去掉可能的前导空格
  git merge-base --is-ancestor "$b" HEAD 2>/dev/null && continue

  # release/* 分支用 tag 检测
  if echo "$b" | grep -qE '^release/'; then
    ver=$(echo "$b" | sed 's/^release\///')
    if git tag -l "v$ver" | grep -q .; then
      echo "$b  [squash-merged] (tag v$ver exists)"
      continue
    fi
  fi

  # 非 release 分支用 three-dot diff
  git diff --quiet HEAD..."$b" 2>/dev/null && echo "$b  [squash-merged]"
done

# 已合并入当前分支的远程 tracking branches（如有 origin）
git branch -r --merged origin/HEAD 2>/dev/null | sed 's/^\* //' | grep -vE '^(origin/HEAD|origin/main|origin/master)$'

# 检测远程 squash merge 的分支
git branch -r | sed 's/^\* //' | grep -vE '^(origin/HEAD|origin/main|origin/master)$' | while read -r r; do
  r="${r# }"
  git merge-base --is-ancestor "$r" HEAD 2>/dev/null && continue

  # release/* 分支用 tag 检测
  local_name="${r#origin/}"
  if echo "$local_name" | grep -qE '^release/'; then
    ver=$(echo "$local_name" | sed 's/^release\///')
    if git tag -l "v$ver" | grep -q .; then
      echo "$r  [squash-merged] (tag v$ver exists)"
      continue
    fi
  fi

  # 非 release 分支用 three-dot diff
  git diff --quiet HEAD..."$r" 2>/dev/null && echo "$r  [squash-merged]"
done

2. 分析并呈现

组装一张完整表格，包含：

关键规则：

• 保护当前分支和 main/master，绝不建议删除
• 保护 develop 分支（如果当前不在 develop 上，develop 作为长期分支也应保护）
• 有活跃 worktree 的分支标记为"使用中"，需要用户明确确认才删
• 未合并的分支标记为"未合并"，说明风险
• 远程有而本地无的分支如果已合并，标记可删
• squash-merged 的分支（含 [squash-merged] 标记）视为已合并，标记可删。检测方式：release/* 分支检查对应 tag 是否存在（如 release/0.7.6 -> 查 v0.7.6 tag）；非 release 分支用 three-dot diff 为空判断内容已合入

3. 一次性确认

不要逐个问。 一次性呈现完整表格，让用户用编号或批量范围来选：

以下分支已合并入当前分支 (develop)，建议删除：

本地 (6):
  1. release/v0.2.0        [4963987] [squash-merged] 可删
  2. feature/payment       [548ad1f] 已合并 可删
  3. feature/ui-taste      [4dfcf23] 已合并 可删
  ...

远程 (3):
  a. origin/feature/payment  已合并 可删
  b. origin/bugfix/login     [squash-merged] 可删
  ...

请选择要删除的分支（如 1,2,3,a,b 或 all）：

如果用户说"合并了的都删"或"all"，直接执行全部。

4. 执行删除

# 删除本地分支（安全删除，仅合并过的才会成功）
git branch -d <branch1> <branch2> ...

# 删除远程分支
git push origin --delete <branch1> <branch2> ...

5. 验证并报告

git branch -vv
git branch -r

输出最终状态，确认清理结果。如果有因未合并而删除失败的分支，单独列出说明。

安全防护

• 绝不在删除前运行 git fetch --prune 或 git remote prune — 这会让用户丢失远程分支引用，应先让用户确认
• 使用 git branch -d（小写 d，安全模式），不是 -D（大写 D，强制删除）
• 如果用户要求强制删除未合并分支，必须先警告丢失提交的风险
• 如果当前 worktree 是 detached HEAD、rebase 中、merge 中，先警告不清理