SVN转Git迁移后无法单独克隆子项目的技术咨询

这个问题我碰到过好多次了——SVN的「稀疏检出」和Git的工作逻辑完全不一样，默认把整个SVN仓库转成单一Git仓库后，确实没法直接单独克隆projectname/webapps/app1这类子项目。问题出在迁移时没针对子项目做拆分处理，下面给你两种解决方案，对应不同的场景：

一、还没完成迁移？用git svn单独迁移子项目 #

如果还没完成全仓库迁移，或者可以重新迁移，直接用git svn clone指定SVN的子路径，就能把每个子项目转成独立的Git仓库：

# 把webapps/app1转成独立Git仓库
git svn clone http://你的SVN仓库地址/projectname/webapps/app1 git-app1
# 同理迁移service1
git svn clone http://你的SVN仓库地址/projectname/services/service1 git-service1

这样每个子项目都是独立的Git仓库，后续就能单独克隆它们了，完美复刻SVN里单独checkout子目录的体验。

二、已经完成全仓库迁移？拆分现有Git仓库 #

如果已经把整个SVN仓库转成了Git仓库，推荐用git filter-repo（比旧的git filter-branch更稳定可靠）来拆分出子项目：

1. 先把已有的全量Git仓库克隆到本地（或者直接在本地仓库操作）：

git clone https://你的Git仓库地址/projectname.git temp-repo
cd temp-repo

2. 用filter-repo提取指定子目录，生成独立仓库：

# 只保留webapps/app1相关的所有提交，生成新仓库
git filter-repo --subdirectory-filter webapps/app1

这个命令会重写Git历史，只保留和webapps/app1相关的提交记录，最后你得到的就是一个只包含app1代码的独立Git仓库，把它推送到新的远程仓库后，就能单独克隆了。

三、为什么默认迁移后不行？ #

SVN是基于目录的版本控制，每个子目录都可以单独检出；但Git是基于仓库的，默认克隆会拉取整个仓库的所有历史和文件。除非你把子项目拆成独立仓库，或者用Git的稀疏检出——不过稀疏检出只是本地只显示指定目录，还是会下载整个仓库的历史，不是真正的“单独克隆子项目”。

四、临时需求？用Git稀疏检出 #

如果只是本地不想拉整个仓库，只想获取某个子目录，可以用稀疏检出应急：

# 初始化仓库但不拉取文件
git clone --no-checkout https://你的Git仓库地址/projectname.git
cd projectname
# 启用稀疏检出功能
git config core.sparseCheckout true
# 指定要拉取的目录
echo "webapps/app1/" >> .git/info/sparse-checkout
# 拉取指定目录的文件
git checkout main

注意：这个方法还是会下载整个仓库的历史数据，只是本地只展示指定目录，适合临时用用，不是长期解决方案。

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