版本控制与协作 / 系统课时
删除已完成的分支
删除已完成的分支
学习目标
完成本课后,你将能够:
- 安全删除已经完成的本地分支
- 理解 -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: yesTips
- 先查看
git branch --merged再批量清理。 - 分支删除只删除名称,不会从已合并历史中删除内容。
- 强制删除前记录提交哈希,必要时创建临时备份分支或标签。
常见错误
1. 删除当前分支
- 错误表现:Git 拒绝删除正在检出的分支。
- 正确处理:先切换到主分支或其他分支,再执行删除。
2. 习惯使用 -D
- 错误表现:未合并提交失去可见分支引用。
- 正确处理:优先使用
-d,只有确认提交不需要时才强制删除。
本课练习
1. 删除已合并分支
- 任务目标:删除已合并分支。
- 输入或初始条件:准备一个快进合并后的功能分支。
- 实现要求:使用安全删除。
- 验收条件:分支名称消失,功能文件仍在主分支。
2. 观察保护机制
- 任务目标:观察保护机制。
- 输入或初始条件:创建含独立提交但未合并的分支。
- 实现要求:尝试使用
-d删除。 - 验收条件:Git 拒绝并提示未完全合并。
3. 恢复误删引用
- 任务目标:恢复误删引用。
- 输入或初始条件:记录分支提交哈希后强制删除测试分支。
- 实现要求:从哈希重新创建分支。
- 验收条件:新分支恢复到原提交。
按自己的节奏,确认真正理解。