git subtree split 只生成空提交，通常因--prefix路径错误：须以斜杠结尾、大小写及历史路径完全匹配，且该目录需在相关提交中真实存在。
git subtree split 为什么只生成空提交
执行 git subtree split 后新分支里没有文件，只有空提交？大概率是 --prefix 写错了。这不是报错，而是静默失败。
-
--prefix必须以斜杠结尾，比如--prefix=src/lib/，写成src/lib或src/lib（缺末尾斜杠）都会匹配失败 - 路径严格区分大小写，且必须和历史中真实出现的路径完全一致——比如某次提交里是
Src/utils/，你写src/utils/就找不到 - 如果该子目录在某些早期提交中根本不存在（例如项目初期还没建这个目录），
split会跳过那些提交，不提示、不报错，只保留它“见过”的部分历史 - 建议先用
git log --oneline --name-only --all | grep -E "^[a-f0-9]{7,}.*src/lib/"确认该路径是否真实出现在提交记录中
拆分时该用 --prefix 还是 --subdirectory-filter
git subtree split 和 git filter-repo --subdirectory-filter 解决的是同一类问题，但行为逻辑不同：前者是“提取路径+保留父仓库上下文”，后者是“重写历史+把子目录升为根”。
-
git subtree split -P src/lib/ -b lib-only：生成的新分支仍属于原仓库，所有 commit hash 不变，只是内容被裁剪；适合后续还要和原仓库做git subtree pull/push同步 -
git filter-repo --subdirectory-filter src/lib/：彻底重写历史，把src/lib/下的文件提到仓库根目录，commit hash 全部变更；适合真正独立、不再和原仓库联动的场景 - 如果你只是想“临时切出一个干净分支用于审查或备份”，用
subtree split更轻量；如果目标是“立刻上线新仓库并切断依赖”，filter-repo更彻底
拆出来的分支怎么推到全新远程仓库
别直接 git subtree push 到新地址——它会把父仓库的完整 commit hash 带过去，新仓库里能看到其他路径的空壳提交，不干净。
- 先执行
git subtree split -P src/lib/ -b lib-only - 然后
git checkout lib-only切到该分支 git remote add origin-new https://github.com/user/new-repo.git- 最后
git push origin-new lib-only:main（注意不是lib-only:lib-only，要推到目标仓库的默认分支名） - 如果目标仓库已有
main分支且非空，首次推送需加-f；但更稳妥的做法是新建空仓库，不预设任何分支
拆完分支后发现 .gitignore 或 README 修改还在提交里
这些文件明明不在 --prefix 路径下，为什么还出现在拆分后的提交中？这是 git subtree split 默认启用 -h（即 --rejoin）模式导致的副作用。
-
--rejoin模式会在每次 split 后自动 merge 回主干，顺便把无关路径的修改也带进来 - 解决方法：显式禁用它，改用
git subtree split -P src/lib/ --no-rejoin -b lib-only - 或者更干脆——不用
subtree split，直接上git filter-repo --path src/lib/ --path-rename lib/，它天然只保留指定路径下的变更 - 注意：
filter-repo需提前安装（pip install git-filter-repo），且要求 Git ≥ 2.22
