Git filter-branch：拆分目录时保留重命名文件全提交的技术问询

我完全懂你的困扰——git filter-branch --subdirectory-filter确实有个大局限：它只会保留那些文件路径从始至终没变化的提交，完全没法追踪文件被重命名或移动的历史，这和gitk --follow能一路追着文件变迁的能力差太远了。你之前尝试的--index-filter命令本质上和--subdirectory-filter逻辑一致，自然达不到预期效果。

下面给你两个可行的方案，分别基于git filter-branch（兼容旧版本Git）和官方推荐的git filter-repo（更高效可靠）：

方案一：使用git filter-branch实现追踪历史路径 #

这个方案通过在每个提交中动态找出所有曾经属于目标目录的文件（包括重命名/移动过的），只保留这些文件的记录：

git filter-branch --index-filter '
  # 获取当前提交中所有与目标目录相关的历史文件（含重命名/移动）
  files=$(git log --pretty=format: --name-only --follow -- FOLDER-NAME | sort -u)
  if [ -n "$files" ]; then
    # 清空索引中所有无关文件
    git rm --cached -qr --ignore-unmatch -- .
    # 将目标文件重新加入索引
    git reset -q $GIT_COMMIT -- $files
  else
    # 无相关文件时清空索引，方便后续--prune-empty清理空提交
    git rm --cached -qr -- .
  fi
' --prune-empty -- --all

命令解释： #

• git log --follow --name-only -- FOLDER-NAME：模拟gitk --follow的逻辑，找出所有涉及目标目录文件的历史路径（包括重命名后的路径）
• git rm --cached -qr -- .：清空当前提交的索引，移除所有无关文件
• git reset -q $GIT_COMMIT -- $files：只把目标文件重新加入索引
• --prune-empty：自动移除那些过滤后没有任何文件的空提交

方案二：使用git filter-repo（官方推荐，更高效） #

Git官方已经不再推荐git filter-branch，而是建议使用git filter-repo（需要单独安装，Git 2.22+支持），它原生支持追踪文件重命名，命令更简洁：

git filter-repo --path FOLDER-NAME --path-rename FOLDER-NAME/: --follow-renames

命令解释： #

• --path FOLDER-NAME：指定要保留的目标目录
• --path-rename FOLDER-NAME/: ：把目标目录下的所有文件移到新仓库的根目录（和--subdirectory-filter的最终路径效果一致）
• --follow-renames：开启文件重命名追踪，保留所有涉及目标文件的历史提交

重要注意事项 #

1. 备份仓库：这两个命令都会重写Git历史，执行前一定要备份整个仓库目录，避免数据丢失
2. 强制推送：如果需要推送到远程仓库，后续需要执行git push --force，但务必提前通知所有协作成员，避免历史冲突
3. filter-repo优势：对于大型仓库，git filter-repo的速度比git filter-branch快几十倍，且更稳定，优先推荐使用

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