版本控制与协作 / 系统课时

删除已完成的分支

删除已完成的分支

学习目标

完成本课后,你将能够:

  • 安全删除已经完成的本地分支
  • 理解 -d 的合并保护机制
  • 判断分支删除是否会丢失未合并提交

问题背景或应用场景

功能分支合并后继续保留会使分支列表越来越混乱。删除已完成分支可以保持仓库清晰,但删除前必须确认其提交已经被其他需要保留的分支包含。Git 的安全删除选项会在可能丢失未合并提交时主动阻止操作。

核心原理

git branch -d <name> 删除本地分支引用,但要求该分支已合并到当前分支或其上游。提交对象不会因为删除引用立即消失,只要仍被其他分支、标签或 reflog 引用就可以访问。-D 相当于强制删除,会跳过合并检查。

不能删除当前正在检出的分支,必须先切换到其他分支。远程分支和本地分支是不同引用,删除本地分支不会自动删除远程分支;远程清理需要后续使用推送删除语法。

基础用法

合并后先运行 git branch --merged 查看已被当前分支包含的分支,再使用 git branch -d feature/name。若 Git 拒绝删除,先查看分支日志和差异,确认是否需要合并、创建标签或备份。不要把 -D 当作默认清理方式。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
rm -rf git-delete-branch-demo
mkdir git-delete-branch-demo
cd git-delete-branch-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base\n" > app.txt
git add app.txt
git commit -q -m "chore: create base"
BASE=$(git branch --show-current)
git switch -q -c feature/cleanup
printf "cleanup done\n" > cleanup.txt
git add cleanup.txt
git commit -q -m "feat: add cleanup marker"
git switch -q "$BASE"
git merge -q --ff-only feature/cleanup
git branch -d feature/cleanup
printf "feature exists: "
git show-ref --verify --quiet refs/heads/feature/cleanup && echo yes || echo no
printf "file remains: "
test -f cleanup.txt && echo yes

预期输出

text
Deleted branch feature/cleanup (was <COMMIT_ID>).
feature exists: no
file remains: yes

Tips

  • 先查看 git branch --merged 再批量清理。
  • 分支删除只删除名称,不会从已合并历史中删除内容。
  • 强制删除前记录提交哈希,必要时创建临时备份分支或标签。

常见错误

1. 删除当前分支

  • 错误表现:Git 拒绝删除正在检出的分支。
  • 正确处理:先切换到主分支或其他分支,再执行删除。

2. 习惯使用 -D

  • 错误表现:未合并提交失去可见分支引用。
  • 正确处理:优先使用 -d,只有确认提交不需要时才强制删除。

本课练习

1. 删除已合并分支

  • 任务目标:删除已合并分支。
  • 输入或初始条件:准备一个快进合并后的功能分支。
  • 实现要求:使用安全删除。
  • 验收条件:分支名称消失,功能文件仍在主分支。

2. 观察保护机制

  • 任务目标:观察保护机制。
  • 输入或初始条件:创建含独立提交但未合并的分支。
  • 实现要求:尝试使用 -d 删除。
  • 验收条件:Git 拒绝并提示未完全合并。

3. 恢复误删引用

  • 任务目标:恢复误删引用。
  • 输入或初始条件:记录分支提交哈希后强制删除测试分支。
  • 实现要求:从哈希重新创建分支。
  • 验收条件:新分支恢复到原提交。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

删除已完成的分支

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通