TRAE-AI编程
你本地攒了一堆试错分支，远端也堆了过期功能分支，想清理却怕误删正在用的那条，该怎么办？Git 删除分支有 3 种常见做法：用 git branch -d 安全删除已合并的本地分支、用 git push --delete 删除远程分支、以及用 git branch -D 强制删除未合并分支。选错方式最常见的问题是误删未合并分支丢改动、或删了别人正在用的远程分支。本文以 Git 2.x 为例，从最小场景讲到三种方式的边界与常见失败，并给出一份实操清单，帮你清理分支时不再误删或丢改动。
先看结论
| 你的意图 | 命令 | 注意点 |
|---|---|---|
| 删除已合并的本地分支 | git branch -d 分支名 |
未合并会拒绝，安全 |
| 删除远程分支 | git push --delete origin 分支名 |
会影响协作者，先沟通 |
| 强制删除未合并分支 | git branch -D 分支名 |
丢弃未合并改动，不可逆 |
一句话：本地已合并用 -d，远程用 push --delete，确定不要的未合并分支才用 -D，删前务必确认改动已保存别处。
一、最小场景与预期结果
先看看当前有哪些分支，确认要删的是哪条。
git branch # 列出本地分支，* 指当前所在
git branch -a # 含远程跟踪分支
git checkout main # 先切到别的分支，不能删自己正处的分支
先过一遍 Git 教程 理解 Git 删除分支的本质：分支只是指向提交的一个指针，删除分支并不会立刻删除那些提交（只要还有别的分支或标签指向它们）。实操清单：删前先 git branch 确认目标分支存在；git checkout 到一个"不是要删那条"的分支；再用对应命令删除。预期：你能列出所有分支，并切到一个安全分支上。Git 不允许删除当前所在分支，所以删之前一定先 checkout 走。
二、方法一：删除本地分支（-d 与 -D）
最常用的 Git 删除分支写法是 git branch -d，它只删"已经合并进当前分支"的分支，是个安全闸。
git branch -d feature/login # 已合并则删除，未合并报错
git branch -D feature/login # 强制删除，无论是否合并
命令与运行：执行 -d 后预期分支被移除，git branch 列表里不再出现它。检查：若 -d 报错"分支未合并"，说明还有改动只存在于该分支，Git 在保护你。失败处理：确认不要了就改用 -D，但 -D 之后未合并的提交如果没有别的引用就会变成"悬空提交"，虽然还能靠 git reflog 短暂找回，长期会被回收。常用参数可查 Git 速查手册 的 branch 章节；-d 与 -D 的差异确认后再动手，删前用 git branch -v 还能看到每条分支最后一次提交，便于核对没删错目标。
三、方法二：删除远程分支（push --delete）
本地删完，远程那条还在，需要单独推一个删除指令。
git push origin --delete feature/login
# 旧写法（不推荐但常见）：git push origin :feature/login
git fetch -p # 清理本地过期的远程跟踪分支
运行预期：远端仓库的 feature/login 消失，协作者再 git fetch 时就看不到它了。检查：推完后让一名协作者执行 git fetch 确认分支已不在远端列表。失败处理：这是一个会影响团队的动作——别人若正基于该分支工作，删除后他们推送会失败。所以删远程分支前一定先在协作工具里确认无人依赖，删完让成员执行 git fetch -p 同步。关于远程分支与本地清理的配合，可延伸阅读相关笔记（见文末）。
操作清单：删远程前先在协作工具里 @ 相关同事确认无人依赖该分支；执行后让对方 git fetch -p 同步；若对方已基于该分支推送过改动，先让他另存再清理，避免互相踩踏。
四、方法三：批量与强制清理及边界避坑
当试错分支攒了一堆，可以批量清理已合并的本地分支，或对确认无用的分支强制删除。
# 删除所有已合并进 main 的本地分支（危险，先 dry-run 确认）
git branch --merged main | grep -v "main" | xargs git branch -d
# 强制清理一条明确不要的分支
git branch -D temp/experiment
运行预期：合并过的分支被批量移除，工作区只留下还在用的分支。检查：批量删除前先把 git branch --merged main 的结果单独看一遍，确认没有误伤。失败处理：-D 是单向操作，未合并改动若没推到远端或存成补丁就 truly 丢失；删远程分支后别忘了 git fetch -p 清掉本地残留的远程跟踪引用，否则 git branch -a 里还挂着死链接。收尾检查：批量删除后跑一遍 git branch 确认只剩预期分支；远程侧用 git ls-remote 或仓库页面核对分支数是否一致。更系统的分支模型可参考 Git Magic 教程 的分支管理章节，它讲清了分支指针与提交对象的内部结构，能帮你建立"删分支不等于删提交"的正确心智模型。
边界、反例与常见失败一并放在这里：
- 批量删除务必先 dry-run：直接接
xargs对着错误列表误删；正确做法是先单独看列表、确认无误再执行。 - -D 后的改动难找回：没有别的分支或标签引用时，悬空提交会被回收，重要改动记得先合并或推远端。
- 删远程后同伴推送失败：因远端分支已被删，需对方
git fetch -p清理过期跟踪分支再重建。 - 不能删当前分支：忘了先 checkout 走会报 "Cannot delete branch"，切走即可。
总结
Git 删除分支有 3 种常见做法，选型看场景：
- 本地已合并的分支，用 git branch -d 安全删除；
- 推到远端的过期分支，用 git push --delete 删除并通知协作者；
- 确定不要的未合并分支，才用 git branch -D 强制删除，且删前确认改动已另存。
记住分支只是指针，删分支不等于删提交；但 -D 掉的未合并改动若没有别的引用，时间久了就真找不回，动手前多看一眼。
延伸学习
想把这块知识系统补齐，可以按这个顺序来：
- 想跟着课程动手练，Git 入门实战课程 是边学边写的形式；
- 看分支与回退的安全操作，Git 删除分支笔记 讲清本地与远程分支的删除细节；
- 需要更完整的命令参考，Git 官方中文手册 适合随时查阅。
常见问题
Q：git branch -d 删不掉分支报"未合并"怎么办？
A：这是 Git 在保护你，说明该分支有提交还没合并进当前分支。先 git log 分支名 --not main 看看有哪些独有提交；确认不要就改用 git branch -D 强制删除，或者先 git merge 把改动并进来再 -d。
Q：删了远程分支，别人再推送为什么会失败？
A：因为你已经把远端的分支引用删掉了，别人本地还指着它。让他先 git fetch -p 清理过期的远程跟踪分支，再基于最新远端重新拉取或重建分支即可。删远程分支属团队动作，务必提前沟通。
Q：git branch -D 之后还能找回丢掉的分支吗？
A：如果那些提交没被别的分支或标签引用，它们会变成悬空提交。短期内用 git reflog 找到分支最后的哈希，再 git branch 新名 哈希 就能复活；但 Git 的垃圾回收会定期清理悬空提交，所以别拖太久，重要改动记得先合并或推远端。
