Git filter-repo：它可以用于特定的分支吗？

Question

我正在学习 git filter-repo 的用法，因为我想用它做一个小实验。我有一个仓库，我只想获取其中一个目录的历史记录，例如从 master 分支开始，但我不想在 master 上工作。我想创建一个新分支，比如 filter-repo-test，并让 git filter-repo 对该分支进行操作。我看了一下手册，但没有找到指定特定分支的选项。这可行吗？

参考链接：https://htmlpreview.github.io/?https://github.com/newren/git-filter-repo/blob/docs/html/git-filter-repo.html

- eftshift0

Answer 1

'Miscellaneous Options'包括--refs

--refs <refs+>

将历史重写限制为指定的引用。暗示 --partial。
除了--partial的常规注意事项（混合旧和新的历史，不自动重新映射refs/remotes/origin/*到refs/heads/*等）之外，当指定负修订时，这也可能导致消除退化空合并提交的问题。

而且......它将移动标签，正如我在“Git Subdirectory Filter with tags”中记录的那样，它使用了--refs作为示例。

---

Ryan Wheale在评论中指出：

您可以使用分支名称来限制过滤到该分支。
再次注意--partial的注意事项。

--refs filter-repo-test

- VonC

---

只是提醒其他人：您应该能够使用分支名称来将过滤限制为该分支。再次注意 --partial 的注意事项：--refs filter-repo-test。 - Ryan Wheale

@RyanWheale 感谢您的反馈。我已经将您的评论包含在答案中，以增加其可见性。 - VonC

Answer 2

没事了，我找到了。它就在我的眼皮底下。它是用--refs定义的。

- eftshift0