SVN 到 Git 平滑迁移：svn2git 工具实践指南
迁移痛点与解决方案
常见迁移问题分析：
- 分支结构混乱，难以识别主干和分支
- 标签信息丢失，版本追踪困难
- 提交记录不完整，历史追溯受阻
- 需要大量手动配置和人工干预
svn2git 的智能应对：
- 自动识别 SVN 标准布局（trunk、branches、tags）
- 智能转换分支为 Git 原生分支
- 准确映射标签为 Git 标签对象
- 保持完整的提交历史记录
核心迁移流程详解
svn2git 的核心迁移逻辑基于关键模块，通过调用 git-svn 命令与 SVN 仓库交互，然后进行后处理优化。
标准布局迁移示例： 对于遵循标准 SVN 布局的仓库，迁移命令简单直接：
svn2git http://svn.example.com/path/to/repo
迁移前后对比效果： 迁移前 SVN 分支显示为远程分支，迁移后转换为 Git 本地分支和标签，极大提升了版本管理的便捷性。
实战迁移场景解析
标准 SVN 仓库迁移
如果你的 SVN 仓库采用标准的 trunk、branches、tags 布局，svn2git 能够完美处理。迁移完成后，你将获得：
- 清晰的主分支（master）
- 完整的本地分支结构
- 准确的标签版本信息
非标准布局处理
对于不遵循标准布局的 SVN 仓库，svn2git 提供了灵活的配置选项：
只有 trunk 和 tags 的情况：
svn2git http://svn.example.com/path/to/repo --trunk dev --tags rel --nobranches
根目录即为 trunk 的情况：
svn2git http://svn.example.com/path/to/repo --rootistrunk
复杂场景应对
- 排除特定目录：使用
--exclude参数过滤不需要的文件 - 密码保护仓库：通过
--username和--password进行认证 - 指定迁移版本范围：使用
--revision参数控制迁移范围
高级配置技巧
作者信息映射
创建作者映射文件，确保 Git 提交记录中的作者信息准确无误：
# 创建 authors.txt 文件
jcoglan = James Coglan <[email protected]>
stnick = Santa Claus <[email protected]>
# 使用作者映射
svn2git http://svn.example.com/path/to/repo --authors ~/authors.txt
持续同步更新
svn2git 2.0 版本新增了镜像同步功能，允许你将 Git 仓库与源 SVN 仓库保持同步：
cd <EXISTING_REPO> && svn2git --rebase
