使用svn2git仅迁移SVN Trunk并保留历史：方法与报错排查

当然可以！svn2git完全支持只迁移SVN的Trunk目录并完整保留所有提交历史，这是非常常见的迁移场景，接下来我会帮你梳理正确的操作方式，以及解决你遇到的报错问题。

一、基础操作命令优化 #

你执行的命令方向是对的，但可以补充几个参数来避免潜在问题，同时让迁移过程更透明：

svn2git repoPath/trunk --authors authors.txt --no-minimize-url --verbose

各参数的作用：

• --authors authors.txt：指定SVN用户名到Git作者的映射文件，这是必须项，否则迁移时会因为作者信息缺失失败
• --no-minimize-url：避免svn2git自动简化SVN路径，防止路径解析错误（尤其是当你的SVN路径包含特殊结构时）
• --verbose：开启详细日志输出，方便后续排查任何报错

二、解决command failed: git checkout -f master报错 #

这个报错通常由以下几种原因导致，你可以逐一排查：

1. 本地存在冲突的Git仓库 #

如果你在同一个目录下多次执行迁移命令，可能残留了损坏的.git目录。解决方法：

• 完全删除当前目录下的.git文件夹（如果是新建的空目录，直接清空整个目录重新开始）
• 创建一个全新的空目录，在里面重新执行优化后的svn2git命令

2. SVN Trunk历史存在异常提交 #

SVN的提交历史中可能存在空提交、包含特殊字符的文件名、或者权限属性冲突的情况，导致git checkout失败。解决方法：

• 先用svn log repoPath/trunk查看SVN提交历史，定位最近的异常提交（比如某个提交没有任何文件变更）
• 如果不想修改SVN端历史，可以尝试改用Git原生的git svn命令来迁移（稳定性更好，适合处理复杂历史），步骤如下：

  # 创建空目录并初始化Git
  mkdir git-trunk-repo && cd git-trunk-repo
  git init
  
  # 关联SVN Trunk路径
  git svn init repoPath/trunk --no-metadata
  
  # 编辑.git/config，在[svn-remote "svn"]下添加作者映射路径
  # 示例：authorsfile = ../authors.txt（确保authors.txt路径正确）
  
  # 拉取所有SVN历史
  git svn fetch
  
  # 将SVN分支转换为Git的master分支
  git checkout -b master remotes/git-svn
  

3. 依赖版本不兼容 #

svn2git对Git和Subversion的版本有一定要求，如果版本过旧可能出现兼容性问题。解决方法：

• 更新Git到2.30以上的稳定版本
• 更新Subversion到1.14以上的稳定版本
• 重新安装最新版的svn2git

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