在日常开发中，Git 的 push 命令通常是可预测的：它将本地当前仓库的分支推送到远程。但最近不少开发者反映了一个令人困惑的问题——“Git pushing another repository together with the one I actually want to push”（执行推送时，另一个仓库竟被一同推送上去了）。这一现象在 Stack Overflow、Reddit 等技术社区引发热议，不少开发者因此遭遇远程仓库混乱、历史被污染的窘境。究竟是哪里出了问题？本文将深入剖析成因，并提供解决方案。
现象：推送一个，附赠一个
一位后端工程师在论坛中描述：他在项目 A 的根目录下执行 git push origin main，结果远程仓库不仅收到了项目 A 的更新，还多出了一整套来自项目 B 的文件、分支甚至提交历史。更令人迷惑的是，项目 B 从未被显式添加为该仓库的子模块或子树。检查本地 .git/config，也未发现异常的多重 remote 配置。
类似的案例并不少见。有用户反映，在推送包含子模块的项目时，远程仓库突然多出了子模块仓库的全部内容；也有人在使用 git push --all 后，发现自己另一个无关仓库的引用也被推送了。这些异常都指向同一个核心问题：Git 在推送时，究竟“看到了”哪些仓库？
原因解析：子模块、镜像与误配置
-
子模块的递归推送
最典型的原因之一是子模块（submodule）的递归推送。当父仓库启用了push.recurseSubmodules on-demand或check模式，且子模块目录本身也关联了独立的远程仓库时，git push会尝试先推送子模块的变更，再推送父仓库。如果子模块的远程 URL 恰好指向了另一个不相关的仓库（例如因错误克隆或手动修改.gitmodules导致），就会“附赠”整个子模块的内容。 -
误用
--mirror或--all
git push --mirror会推送所有本地引用（包括分支、标签和远程跟踪分支），如果当前仓库的 remote 配置包含多个 fetch 来源，或者本地仓库存在与另一个仓库共享的对象目录（例如通过--reference克隆），就可能将其他仓库的引用一并推送到远程。git push --all则推送所有本地分支，当工作目录下存在多个 Git 仓库（如通过git worktree add创建的关联工作树）时，也可能造成混淆。 -
错误的 remote 别名或推送目标
另一种不常见但确有其事的情况：当本地仓库的origin远程被错误地指向了另一个仓库的 URL，且另一个仓库的本地副本恰好存在于同一系统或同一.git/objects共享目录中时，推送会触发对象传输，导致“附赠”。此外，若开发者使用git push --force并指定过宽的 refspec（如+refs/heads/*:refs/heads/*），也可能覆盖不相关的分支。
专家解读：如何诊断和修复
针对这一问题，Git 核心贡献者曾建议：执行任何危险推送前，务必使用 --dry-run 选项。git push --dry-run 会模拟推送而不实际传输数据，能提前暴露将受影响的远程引用。如果发现输出中出现了预期之外的远程分支或仓库名称，应立即中止操作。
具体排查步骤如下：
- 检查子模块配置：运行
git submodule status查看子模块路径，并确认.gitmodules中的 URL 是否正确。若子模块的远程仓库与父仓库无关，可临时设置git config push.recurseSubmodules no避免递归。 - 审视 remote 设置：
git remote -v列出所有 remote 及对应 URL；git remote show origin可查看每个远程分支的跟踪关系。若发现多余的 fetch 条目（如fetch = +refs/heads/*:refs/remotes/upstream/*），且该 remote 指向另一仓库，需清理。 - 验证对象存储：当怀疑存在共享对象目录时，运行
git rev-parse --git-dir查看当前仓库的.git路径，并检查父目录下是否有其他.git文件夹。同一文件系统下多个仓库的objects目录若通过alternates链接，可能导致对象意外共享。 - 使用
-n与--porcelain：git push -n --porcelain会以机器可读格式列出将要推送的每个引用，便于脚本化检查。
预防措施：养成良好习惯
为避免“附赠仓库”的尴尬，建议开发者采取以下措施：
- 明确配置推送行为：在全局或项目级设置
git config --global push.default current，确保只推当前分支；若使用子模块，将push.recurseSubmodules设为no或check（后者会在子模块未推送时直接报错）。 - 利用 Git Hooks 增加安全网：编写
pre-push钩子，检查即将推送的引用列表，若包含非预期远程或分支则拒绝操作。GitLab 和 GitHub 也支持推送规则，可限制不允许推送特定模式的分支。 - 避免
--mirror的盲目使用：只有在完全镜像仓库时（如备份）才使用此参数，日常推送请用git push配合明确的分支名。 - 定期审查
.git/config：尤其在使用第三方脚本或复制仓库后，确认 remote 和子模块配置未被篡改。
结语
“Git 推送另一个仓库”虽看似诡异，但根源往往是子模块递归、远程配置失误或对推送选项理解不足。随着 Git 功能的日益丰富，开发者更需谨慎对待每一次 git push。记住：在按下回车前，先跑一遍 --dry-run——这道简单的“安检”步骤，能帮你省去数小时的灾难恢复时间。毕竟，版本控制的核心价值在于可靠，而非意外。