git fetch --prune 中 --prune 的含义

一句话解释

--prune（修剪）的作用是：清理掉本地那些"远程已经删除、但本地还残留"的远程跟踪分支引用。

详细说明

问题背景

当你git fetch时，Git 会更新本地的远程跟踪分支（如origin/main、origin/dev）。

但有个问题：如果远程仓库删除了某个分支，默认情况下git fetch不会自动删除你本地对应的origin/xxx引用，导致本地残留一堆"其实远程已经不存在"的分支引用。

--prune做什么

加上--prune后，fetch 时会同步这个删除动作：远程删了的分支，本地对应的远程跟踪引用也一并清除，保持本地和远程一致。

举例说明

假设远程原来有 3 个分支：main、dev、feature-x

# 本地远程跟踪分支 origin/main origin/dev origin/feature-x

现在远程删除了feature-x，然后你执行：

不加 --prune

git fetch origin
# 本地仍然残留： origin/main origin/dev origin/feature-x ← ⚠️ 远程已删除，本地还在（脏数据）

加 --prune

git fetch origin --prune
# 本地同步清理： origin/main origin/dev ← feature-x 被清除，与远程一致 ✅

为什么脚本里要用它

在你的镜像同步脚本里用--prune很重要：

  1. 保证分支列表准确：遍历分支前先 prune，避免把"远程其实已删除的分支"当成有效分支去同步
  2. 避免同步幽灵分支：不加 prune 可能对着一个远程已不存在的origin_ne/xxx做操作，导致出错或无效推送
  3. 保持环境干净：长期运行的自动化脚本，不清理会累积大量失效引用

相关命令对比

命令作用
git fetch origin更新远程跟踪分支，但不删失效的
git fetch origin --prune更新 + 清理远程已删除的跟踪分支
git fetch --prune --all对所有 remote 都 fetch + prune
git remote prune origin只清理不 fetch（单独修剪）
git branch -r查看当前所有远程跟踪分支（可验证 prune 效果）

补充：--prune-tags

还有个--prune-tags，作用类似但针对标签（tag）——清理远程已删除的 tag。一般单独使用较少。

⚠️ 注意

  • --prune只清理"远程跟踪引用"（origin/xxx），不会删除你的本地分支（你自己git branch创建的本地分支不受影响），所以是安全的
  • 可以设为默认行为：
    git config --global fetch.prune true
    之后每次git fetch自动 prune

一句话总结

--prune= fetch 时顺便清除"远程已删除、本地还残留"的远程跟踪分支（origin/xxx），让本地与远程保持一致。它只清理跟踪引用、不动你的本地分支，在自动化同步脚本里能避免对"幽灵分支"误操作。