Subgit导入SVN为Git的映射、重命名与历史过滤配置问题

结论前置：你提出的保留双项目完整历史、移除多余父层级、重命名目录、过滤无关提交的全部需求，都可以通过Subgit原生配置实现，不需要导入后再做二次Git历史改写，之前的导入异常是对includePath的适用场景存在误解，没有用到Subgit内置的自定义路径映射能力。

原配置的问题根因 #

你之前的配置出现三类不符合预期的结果，核心原因如下：

• includePath的规则是在当前声明的SVN映射根路径下，保留从根到目标子路径的完整相对层级做内容裁剪，而非把映射根直接切换到目标子路径，因此即使添加了两个项目的includePath，subfolder1、subfolder2的父目录层级仍然会保留在最终Git结构中
• includePath仅支持路径过滤，不支持路径重命名，因此无法自动把原project1、project2目录修改为自定义的新名称
• 你把trunk指向了branches/qua这个上层公共路径，Subgit会扫描该路径下所有提交，哪怕没有命中includePath的过滤规则，只要同一次提交同时涉及目标项目和其他无关项目（比如project3）的修改，就会把整条提交记录带入Git历史，造成无关提交混入

正确配置方法 #

核心是使用Subgit的svn.path配置段做自定义路径重映射，替代原有includePath的裁剪逻辑，配置示例如下：

[svn]
# 将SVN映射根锚定到两个项目共同所在的qua分支路径，避免锚定到更高层级的SVN根目录
root = https://<你的SVN仓库实际地址>/branches/qua
# 将当前锚定的根路径直接映射到Git的master分支
trunk = .:refs/heads/master
# 清空默认的分支、标签自动扫描规则，避免引入无关路径的扫描任务
branches =
tags =

# 针对project1做路径映射：裁剪掉中间subfolder1父目录，直接重命名为project1newName放到Git根目录
[svn.path "project1-rule"]
from = subfolder1/project1
to = project1newName

# 针对project2做路径映射：裁剪掉中间subfolder2父目录，直接重命名为project2newName放到Git根目录
[svn.path "project2-rule"]
from = subfolder2/project2
to = project2newName

配置匹配效果 #

这套配置可以直接解决之前的三类异常：

• 移除多余父目录层级：svn.path的映射逻辑是把SVN端from路径下的所有文件，直接放置到Git端to路径下，不会保留subfolder1、subfolder2的中间层级，最终Git根目录仅存在两个重命名后的项目目录
• 自动完成目录重命名：映射规则会在提交转换阶段直接替换文件路径，不需要导入后执行git mv类的历史改写操作
• 过滤无关历史提交：Subgit会自动过滤所有未修改两个映射路径下文件的SVN提交，仅保留和project1、project2相关的提交记录，不会把project3等其他无关项目的提交带入最终Git历史

注意事项 #

• 不要继续使用includePath做裁剪，该配置仅支持保留原相对层级的路径过滤，无法实现路径重命名和中间层级移除
• 如果已经用错误配置初始化过Subgit工作区，需要清空本地工作目录后，重新基于修改后的配置执行导入流程，旧的缓存映射会干扰最终转换结果

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