一句话解释

--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. 保持环境干净：长期运行的自动化脚本，不清理会累积大量失效引用

相关命令对比

补充：--prune-tags

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

⚠️ 注意

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

  git config --global fetch.prune true

  之后每次git fetch自动 prune

一句话总结

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