SVN 非标准布局迁移至 Git：3种分支映射策略与实战命令

在企业级代码仓库迁移场景中，约23%的SVN仓库采用非标准目录结构。这些项目往往因历史原因形成独特的版本控制布局，给迁移工作带来额外挑战。本文将深入解析三种针对非标准SVN布局的Git迁移策略，并提供可直接复用的配置方案。

1. 非标准SVN仓库诊断与预处理

1.1 仓库结构探测脚本

执行以下Shell脚本可自动识别SVN仓库布局特征：

#!/bin/bash SVN_URL="svn://your-repo-url" echo "=== SVN仓库结构分析报告 ===" echo "仓库根目录:" svn ls $SVN_URL echo -e "\n潜在主干路径检测:" find_trunk() { paths=("trunk" "main" "core" "dev") for path in "${paths[@]}"; do if svn ls "$SVN_URL/$path" &>/dev/null; then echo "检测到主干路径: $path" return fi done echo "未发现标准主干路径" } find_trunk echo -e "\n潜在分支路径检测:" find_branches() { paths=("branches" "versions" "releases") for path in "${paths[@]}"; do if svn ls "$SVN_URL/$path" &>/dev/null; then echo "检测到分支路径: $path" return fi done echo "未发现标准分支路径" } find_branches

典型非标准布局可能呈现以下特征：

1.2 作者信息映射处理

创建authors.txt文件处理提交者映射：

john = John Doe <john@company.com> admin = System Admin <admin@company.com> dev01 = Developer One <dev1@team.com>

使用以下命令提取SVN提交者列表：

svn log -q $SVN_URL | awk -F '|' '/^r[0-9]+/ {print $2}' | sort -u

2. 三种核心迁移策略

2.1 单分支映射策略

适用于无明确分支结构的仓库：

git svn clone $SVN_URL \ --no-metadata \ --authors-file=authors.txt \ --trunk=/ \ --no-minimize-url \ target_dir

关键参数说明：

• --trunk=/将根目录映射为Git主分支
• --no-minimize-url保持完整SVN路径

典型问题处理： 当遇到路径包含特殊字符时，添加：

--ignore-paths=".*\.tmp$"

2.2 多路径映射策略

适用于分散但可识别的主干/分支结构：

git svn init $SVN_URL \ --trunk=main_code \ --branches=dev_versions \ --tags=releases \ --prefix=svn/ git svn fetch -A authors.txt \ --log-window-size=10000

目录映射关系表：

2.3 正则表达式映射策略

适用于复杂嵌套结构：

git svn init $SVN_URL \ --prefix=svn/ \ --trunk=/project/trunk \ --branches=/project/branches/{feature,hotfix}/* \ --tags=/project/tags/* git config svn-remote.svn.branches \ "branches/{experimental,legacy}/*:refs/remotes/svn/*"

路径匹配模式示例：

branches/(.*)/feature-([0-9]+) => refs/remotes/svn/feat-$2 tags/release-(.*) => refs/tags/rel-$1

3. 迁移后规范化处理

3.1 分支清理与转换

# 转换SVN标签为Git原生标签 git for-each-ref --format='%(refname)' refs/remotes/svn/tags | while read tagref; do tag=${tagref#refs/remotes/svn/tags/} git tag -a "$tag" -m"SVN tag $tag" "$tagref" git branch -d -r "$tagref" done # 优化分支结构 git branch -r | grep -v 'tags/' | while read branch; do newname=${branch#svn/} git branch "$newname" "$branch" done

3.2 历史记录优化

执行交互式变基清理提交历史：

git filter-branch \ --tree-filter 'rm -f *.tmp *.log' \ --prune-empty \ -- --all

常见清理操作：

4. 企业级迁移方案

4.1 大型仓库迁移优化

对于超过10GB的SVN仓库：

git svn clone \ --stdlayout \ --authors-file=authors.txt \ --log-window-size=1000 \ --no-checkout \ $SVN_URL cd repo git config core.compression 9 git config core.loosecompression 9 git svn fetch --memory-cache-size=1024

性能对比数据：

4.2 迁移验证流程

1. 完整性检查：

   git svn verify diff <(svn log -q | grep '^r' | cut -d'|' -f1) \ <(git log --pretty=format:'svn:r%h')

2. 内容一致性验证：

   svn checkout $SVN_URL/trunk svn-co git checkout master diff -qr svn-co git-co | grep -v '.git'

3. 钩子脚本示例（pre-receive）：

   #!/bin/bash while read oldrev newrev refname; do if git diff --name-only $oldrev $newrev | grep -q '\.svn'; then echo "错误：提交包含SVN元数据" exit 1 fi done

5. 典型问题解决方案

5.1 大文件处理

使用Git LFS迁移大型二进制文件：

git lfs install git lfs track "*.psd" git add .gitattributes git commit -m "启用LFS支持"

5.2 忽略路径配置

创建.git/info/exclude文件：

.svn/ *.tmp build/

5.3 子项目拆分

使用git subtree拆分模块：

git subtree split -P modules/auth -b auth-module git remote add auth-repo git@host:auth.git git push auth-repo auth-module:master

迁移完成后，建议运行以下命令优化本地仓库：

git gc --aggressive git repack -ad