如何更改 git 历史记录中的文件路径？

Question

这是我所拥有的 - 我的代码的 git 存储库：

projects
       |-proj1 (no git repo here yet)
             |-subproj1 <- current git repo here

这是我想要的 - 一个 git 存储库，它现在正在跟踪使用我的代码的新项目：

projects
       |-proj1 <-git repo moved to here, but still tracking files in subproj1
             |-subproj1 (no git repo here)

我想保持历史记录完整，因此新存储库将是指比原始文件深一级的文件。最无痛的方法是什么？

Answer 1

可以使用 git filter-branch 命令来重写历史记录。事实上，将目录树移动到子目录中是 git filter-branch 联机帮助页：

git filter-branch --index-filter '
  git ls-files -s |
  sed "s-\t\"*-&subproj1/-" |
  GIT_INDEX_FILE=$GIT_INDEX_FILE.new git update-index --index-info &&
  mv $GIT_INDEX_FILE.new $GIT_INDEX_FILE
' HEAD

Answer 2

Git 并不擅长跟踪文件的移动，因此如果您想保留文件历史记录，则必须确保旧存储库始终将其文件放在您现在需要的子目录中

git-filter-branch 工作得足够好，但是 git-filter-repo，它允许您以更简单的方式追溯移动文件（以及您可以使用 git-filter-branch 执行的其他操作）。

复制自我自己的答案：

export SUBTREE_PREFIX="subproj1"

git remote add -f "${SUBTREE_PREFIX:?}-remote" https://my-git-repo.invalid/subproj1.git

git checkout "${SUBTREE_PREFIX:?}-remote"/master -b "${SUBTREE_PREFIX:?}-master"

# --force is to skip the "freshly cloned repo" check.
# All the refs we'll be operating on are fresh, even if the repo isn't

# Remove --dry-run once you've checked .git/filter-repo/fast-export.filtered
# to be sure that everything is correct.
git filter-repo --refs "${SUBTREE_PREFIX:?}-master" --to-subdirectory-filter "${SUBTREE_PREFIX:?}" --force --dry-run

git checkout master
git merge "${SUBTREE_PREFIX:?}-master" --allow-unrelated-histories

# Repeat for however many repos you need to add

另请参阅如何合并两个 Git 存储库？

Answer 3

只需在存储库中创建您想要的目录结构 - 即将所有文件和文件夹移动到“subproj1”文件夹。

然后暂存所有添加和删除的文件，git 会发现它们实际上是重命名的：

git add .
git add -u .
git commit -m "Moved to a subfolder"