SVN转GitHub迁移：如何单命令克隆SVN Trunk多目录至单仓库

嘿，我来帮你搞定这个SVN转Git的迁移问题！

你可以利用git svn的路径过滤参数，通过一条命令直接克隆Trunk下指定的多个目录。核心是用--include-paths参数配合正则表达式来匹配你需要的目录：

场景1：遵循标准SVN目录结构（trunk/tags/branches） #

如果你的SVN仓库是标准布局，想同时保留后续处理tags/branches的能力，可以用这条命令：

git svn clone --stdlayout --include-paths="^trunk/(dir1|dir2|dir3)" --authors-file=authors.txt "https://svn repo url"

• --stdlayout：让git svn自动识别SVN的trunk/tags/branches目录结构
• --include-paths：正则表达式匹配，^trunk/(dir1|dir2|dir3)表示只包含trunk下的dir1、dir2、dir3三个目录
• --authors-file：可选但推荐，用来映射SVN用户名到Git的「用户名 <邮箱>」格式（后面会详细讲）

场景2：只需要Trunk下的目录，不需要tags/branches #

如果完全不需要处理分支和标签，可以直接指向trunk路径，简化命令：

git svn clone --include-paths="^(dir1|dir2|dir3)" --authors-file=authors.txt "https://svn repo url/trunk"

这里的正则^(dir1|dir2|dir3)直接匹配trunk根目录下的目标目录，写法更简洁。

单纯克隆目录只是第一步，要做到平滑迁移、保留完整历史和规范的Git记录，建议按以下步骤操作：

1. 准备作者映射文件
   创建一个authors.txt文件，把SVN里的用户名对应到Git的标准作者格式，比如：

svn_user1 = John Doe <john.doe@example.com>
svn_user2 = Jane Smith <jane.smith@example.com>

这样迁移后的Git提交记录会显示正确的作者信息，避免出现混乱的SVN用户名。

2. 克隆并转换SVN仓库
   用上面提到的包含目录的git svn clone命令，加上--authors-file参数，确保作者信息正确映射。如果仓库很大，可以加上--no-metadata参数跳过SVN元数据的存储，加快克隆速度（但会丢失SVN版本号关联，按需选择）。

3. 清理和优化本地Git仓库
   克隆完成后，执行以下命令清理SVN遗留的临时数据，优化仓库：

git svn gc

如果需要整理提交历史（比如合并零散的小提交），可以用git rebase -i HEAD~N（N是你要修改的提交数），但注意只在本地仓库修改，推送到GitHub后不要改写公共历史。

4. 关联GitHub仓库并推送
   创建好GitHub空仓库后，在本地仓库添加远程地址并推送：

git remote add origin "https://github.com/your-username/your-repo.git"
git push -u origin main  # 如果GitHub默认分支是master就写master

5. 可选：迁移SVN分支和标签
   如果需要把SVN中对应目录的分支和标签也迁移过来，可以调整--include-paths的正则表达式，同时匹配分支和标签下的目标目录：

git svn clone --stdlayout --include-paths="^(trunk/(dir1|dir2|dir3)|branches/.*(dir1|dir2|dir3)|tags/.*(dir1|dir2|dir3))" --authors-file=authors.txt "https://svn repo url"

不过这种情况要注意，SVN的分支和标签结构可能比较复杂，建议先在本地测试，确保分支和标签被正确转换为Git的分支和标签。

• 先在本地完成克隆和验证，检查提交历史、作者信息、文件结构是否正确，再推送到GitHub
• 如果目标目录之间有文件依赖，要确保迁移后依赖关系正常（比如相对路径引用）
• git svn对SVN的复杂权限或特殊文件（比如大文件、二进制文件）支持有限，如果遇到问题，可以考虑用svn2git工具（但需要额外安装）

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