git subtree push 报“prefix does not exist”错误，说明指定子树路径在当前分支未提交存在，需确保目录已创建、添加并提交，且路径大小写准确、无通配符。
git subtree push 为什么总是报错 “prefix does not exist”
这个错误说明你指定的子树路径在当前分支里根本不存在，不是远程仓库的问题，而是本地工作区没准备好。常见于：目标目录压根没创建、刚初始化空目录但没 git add、或者路径写错了（比如漏了 src/lib 里的斜杠或大小写）。git subtree push 不会自动创建目录，它只认已提交到索引里的路径。
实操建议：
- 先确认路径存在且已提交：
git ls-tree -r HEAD -- <code>path/to/subtree，有输出才说明 Git 认得这个前缀 - 如果目录是新建的，必须
git add path/to/subtree && git commit -m "add subtree dir"后再 push - 路径区分大小写，Windows 上容易忽略这点；Mac 默认不区分，但推送到 Linux 远程时可能失败
- 别用通配符或相对路径（如
../shared），git subtree只接受工作区内的绝对路径（相对于仓库根）
如何让两个独立项目 A 和 B 的 lib/ 目录保持双向同步
子树本身不提供“自动双向同步”，它是单向操作工具，所谓“双向”必须靠人工约定流程 + 显式命令组合。核心思路是：A 把自己的 lib/ 推到共享远程（比如 origin-lib），B 从该远程拉取并合并进自己的 lib/；反过来同理。关键在于避免冲突和历史污染。
实操建议：
- 统一使用一个中间远程仓库（如
git@github.com:org/shared-lib.git）作为“源权威”，而非直接互推 - A 向中间库推送：
git subtree push --prefix=lib origin-lib main（假设中间库的默认分支叫main） - B 从中间库拉取：
git subtree pull --prefix=lib origin-lib main --squash，加--squash避免把中间库的完整提交历史拖进 B 的主分支图谱 - 每次同步前，先
git fetch origin-lib确保本地有最新远程引用，否则pull可能静默失败
git subtree merge 与 git subtree pull 的区别到底在哪
git subtree pull 是 git subtree merge 的封装，本质都是执行一次合并操作，但触发方式和默认行为不同。真正影响结果的是你传给 merge 的参数，而不是命令名。
实操建议：
-
git subtree pull --prefix=lib origin main等价于：git fetch origin main && git subtree merge --prefix=lib FETCH_HEAD - 如果你需要精细控制合并策略（比如强制使用
ours解决冲突），必须用git subtree merge，因为pull不暴露-s参数 -
git subtree merge支持--rejoin，适合长期维护同一子树的多个分支；而pull没这个选项 - 当子树历史被重写（比如中间库 force-push 过），
pull可能拒绝合并，这时只能手动merge并指定--allow-unrelated-histories
为什么 subtree 同步后，git log --oneline lib/ 看不到子项目原始提交
这是 subtree 的设计使然：它把子项目的提交压缩成一个“合成提交”，只保留变更内容，丢弃原始作者、时间戳、提交信息等元数据（除非你显式用 --no-commit + 手动 git commit --allow-empty 拼接）。这不是 bug，是为避免主项目历史被子项目噪音淹没。
实操建议：
- 若需追溯原始提交，必须在子项目自己的仓库里查，不要依赖主项目的
log --oneline lib/ - 可以在每次
push前加注释：git subtree push --prefix=lib origin-lib main -m "sync lib from project-A v2.3.1"，把版本线索留在主项目日志里 - 如果真要保留完整历史，别用 subtree —— 改用
git submodule或直接 fork +git remote add+cherry-pick，但代价是协作流程变重
子树同步最麻烦的从来不是命令怎么敲，而是团队对“谁改什么、何时推、冲突谁来合”的约定是否清晰。一旦多人同时向同一个子树路径提交又各自 push/pull，历史很快变成无法回溯的线团。建议把子树操作封装成脚本，并在 CI 中校验 git subtree split --prefix=lib HEAD 输出是否与中间库一致——这比人眼盯日志可靠得多。
