报错“remote origin already exists”表示本地已存在同名远程仓库映射，git拒绝重复添加；解决方法为：先用git remote remove origin删除旧配置，再git remote add origin 重新添加，或改用其他名称如upstream。
git remote add 添加远程仓库时命名不能重复
本地已有同名 remote 时，git remote add 会直接报错：remote origin already exists.。这不是警告，是阻断性错误，后续 fetch 和 merge 都无法执行。
解决办法很简单：先删掉旧 remote（如果确定不再需要），再重新 add；或者换一个名字，比如把目标仓库命名为 upstream 或 vendor，而不是默认的 origin。
- 查当前 remote 列表：
git remote -v - 删指定 remote：
git remote remove upstream - 添加新 remote：
git remote add upstream git@xxx.com:repo.git
fetch 后必须用完整 refspec 指定分支，不能只写分支名
git fetch upstream 只拉取远程所有分支的 commit 记录，但不会自动创建本地对应分支。如果你接着执行 git checkout upstream/master，Git 会进入 detached HEAD 状态——这不是你想要的“可编辑分支”。
正确做法是显式创建本地跟踪分支：
- 拉取并创建本地分支：
git checkout -b vendor-main upstream/main - 或先 fetch 再 checkout：
git fetch upstream main:refs/remotes/upstream/main，再git checkout --track upstream/main - 注意：分支名大小写敏感，
master和main是两个不同分支，别搞混
merge --allow-unrelated-histories 不是可选开关，而是必需参数
跨仓库合并时，两个仓库的提交历史完全不共享祖先 commit，Git 默认拒绝合并，报错：fatal: refusing to merge unrelated histories。
必须显式加上 --allow-unrelated-histories，否则命令直接失败。这个参数没有副作用，它只是告诉 Git：“我知道历史无关，仍要合并”。
- 安全写法：
git merge --no-ff --allow-unrelated-histories vendor-main -
--no-ff强制生成 merge commit，保留合并意图，方便日后追溯 - 如果省略该参数，哪怕冲突已解决，merge 也会卡在“拒绝无关历史”这一步
subtree add 更适合保留完整提交历史的目录级合并
如果目标不是把整个仓库代码平铺进当前项目，而是想把另一个仓库作为子模块嵌入某个子目录（比如 lib/external-tool），且要保留对方全部 commit 历史，git subtree add 比 merge 更合适。
它本质是重写对方历史，把所有 commit 的路径前缀统一加上 --prefix= 指定的目录，再 rebase 进当前仓库。
- 命令示例：
git subtree add --prefix=third-party/axios upstream/axios:main --squash（加--squash可压缩为单次提交） - 不加
--squash就会把对方几百次 commit 全部带进来，可能让当前仓库历史爆炸 - 后续更新用
git subtree pull，不是git pull，这点容易记错
git status 扫一眼根目录下有没有意外变更，尤其关注配置类文件。
