使用git-filter-repo --subdirectory-filter后更新Git仓库的高效方法

嘿，我完全懂你这种重复操作的烦躁——每次都重新克隆、过滤确实太折腾了。其实Git本身就有更优雅的方式来处理这种从子目录拆分出来的仓库同步问题，不用再走那种繁琐的流程。下面是具体的步骤：

一次性初始化配置 #

首先，给你的过滤后仓库添加原仓库作为远程源（我们叫它upstream）：

git remote add upstream <原仓库的Git URL>

定期同步原仓库变更 #

每次需要同步原仓库的最新改动时，只需要执行以下几步：

• 拉取原仓库的最新提交：

  git fetch upstream
  

• 合并原仓库中tools目录的变更到当前仓库（假设原仓库的主分支是main）：

  git merge upstream/main --strategy=subtree --strategy-option=subtree=path/to/tools
  

  这里的path/to/tools是原仓库中tools文件夹的原始路径，要和你当初用git-filter-repo时指定的路径一致。

  如果更习惯用rebase来保持线性提交历史，可以换成：

  git rebase upstream/main --strategy=subtree --strategy-option=subtree=path/to/tools
  

为什么这个方法有效？ #

subtree合并策略专门用来处理这种“子目录对应独立仓库根目录”的场景。它会自动将原仓库中指定子目录下的所有变更，映射到当前仓库的根目录中，完全不需要重新执行git-filter-repo的过滤操作。

额外小贴士 #

• 如果第一次合并遇到冲突，正常解决冲突后提交即可，后续同步的冲突概率会大大降低。
• 如果原仓库中tools目录的路径发生了变化，记得同步调整--strategy-option=subtree=...里的路径。
• 可以把同步步骤写成一个简单的Shell脚本，比如sync-upstream.sh，每次运行脚本就能完成同步，更省心：

  #!/bin/bash
  git fetch upstream
  git merge upstream/main --strategy=subtree --strategy-option=subtree=path/to/tools
  

内容的提问来源于stack exchange，提问作者amirblum