git subtree add 报“refusing to merge unrelated histories”是因为目标仓库与当前仓库无共同祖先，需加 --allow-unrelated-histories 参数（git 2.9+支持）；旧版本需先 fetch 再手动 merge。
subtree add 时提示 fatal: refusing to merge unrelated histories
这是最常见问题，因为目标仓库和当前仓库没有共同提交历史。Git 默认拒绝合并无关历史，必须显式允许。
- 在
git subtree add命令末尾加上--allow-unrelated-histories参数 - 例如：
git subtree add --prefix=vendor/libfoo https://github.com/user/libfoo.git main --allow-unrelated-histories - 注意：不是所有 Git 版本都支持该参数（Git 2.9+ 才有），旧版本需先 fetch 再手动 merge + commit
subtree push 后远程分支没更新，或提示“non-fast-forward”
根本原因是 subtree 推送生成的提交不在远程分支的祖先链上，Git 认为这是强制覆盖风险操作。
batch-git-url-replace
下载
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
- 确保你用的是
git subtree push而不是git push—— 后者不会处理 subtree 的提交映射 - 推送前确认本地 subtree 分支已正确同步：
git subtree split --prefix=vendor/libfoo --branch libfoo-upstream，再查git log libfoo-upstream - 若远程已有提交且冲突，先
git subtree pull拉取最新，解决合并后重试 push
如何更新已嵌入的 subtree 子目录
更新不是简单 git pull，而是用 git subtree pull 把上游新提交“嫁接”进当前仓库的提交图中。
- 命令格式：
git subtree pull --prefix=vendor/libfoo https://github.com/user/libfoo.git main - 如果上游改了默认分支名（比如从
master改成main），必须显式指定，否则报错fatal: couldn't find remote ref master - 若 pull 出现冲突，Git 会暂停并提示，此时需手动解决
vendor/libfoo/下的文件，然后git add+git commit - 不要在
vendor/libfoo/目录里直接改代码——那是 subtree 管理区，修改应发生在上游仓库
为什么 git subtree split 生成的 commit hash 和原仓库不一致
这是正常行为，不是 bug。subtree 操作本质是复制+重写历史：它把原仓库某路径下的文件提取出来，再按当前仓库的 parent 关系重新 commit，所以 SHA-1 必然不同。
-
git subtree split输出的 hash 是“子树视图”下的新 commit ID，只在本仓库有意义 - 无法用这个 hash 去原仓库
git show，但可用git log --oneline --all配合--grep查原始提交信息（如果原提交 message 被保留） - 若需精确追溯，建议在每次
subtree push后记录原仓库 commit hash 到本地注释里，例如：git commit --amend -m "push libfoo to v1.2.3 (origin: abcdef7)"
