如何将SVN分支提交历史迁移至Git并获取全部分支提交记录

我来帮你搞定这个问题！你遇到的情况在SVN转Git的场景里挺常见的，核心问题大多出在分支路径的匹配规则上，咱们一步步来排查解决：

1. 先确认当前已识别的SVN分支 #

首先得搞清楚现有仓库里git svn已经追踪了哪些分支，进入你的tempProject目录，执行：

git svn branch

这个命令会列出所有git svn已识别的SVN分支，对比你实际的SVN分支列表，就能明确哪些分支没被拉取到。

2. 调整分支路径匹配规则 #

你之前用的--branches=branches/*/*/*只匹配了branches目录下三级子目录的分支，如果你的分支有不同层级（比如直接在branches根目录下，或者只有两级子目录），这些分支就会被git svn直接忽略。这里有两种处理方式：

方式一：重新克隆（适合还没做太多本地修改的情况） #

修改--branches参数，用多个路径模式覆盖不同层级的分支，比如：

git svn clone --trunk=https://svnpath/project \
  --branches=branches/* \
  --branches=branches/*/* \
  --branches=branches/*/*/* \
  --tags=tags/* \
  --authors-file=authors.txt \
  https://svnpath/project tempProject

git svn允许多次使用--branches参数，这样就能匹配branches下1级、2级、3级的所有分支。如果你的分支有更深的层级，继续添加--branches=branches/*/*/*/*即可。

方式二：在现有仓库中修改配置（适合已经做了本地修改的情况） #

进入tempProject/.git目录，编辑config文件，找到[svn-remote "svn"]部分，修改branches行，添加多个匹配路径：

[svn-remote "svn"]
  url = https://svnpath/project
  fetch = trunk:refs/remotes/svn/trunk
  branches = branches/*:refs/remotes/svn/*
  branches = branches/*/*:refs/remotes/svn/*/*
  branches = branches/*/*/*:refs/remotes/svn/*/*/*
  tags = tags/*:refs/remotes/svn/tags/*

保存后回到项目根目录，执行：

git svn fetch

这会拉取所有新匹配到的分支及其完整提交历史。

3. 将SVN远程分支转换为Git本地分支 #

git svn拉取的分支会存在refs/remotes/svn/下，属于远程追踪分支，你需要把它们转换成Git本地分支才能正常使用：
比如要把svn/feature-branch转换成本地分支：

git checkout -b feature-branch svn/feature-branch

如果分支数量很多，可以用脚本批量处理（bash环境下）：

for branch in $(git branch -r | grep -v tags | grep -v trunk); do
  git checkout -b ${branch#svn/} $branch
done

4. 额外排查点 #

• 确认SVN分支的实际路径：有些团队可能会把分支放在其他目录（比如release/），如果是这种情况，需要在--branches里加上对应路径，比如--branches=release/*。
• 检查authors.txt：如果分支里有新的提交作者不在你的authors.txt里，git svn会报错，这时候需要补充作者映射，格式是svn_username = Git Name <git_email@example.com>。

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