git pull本质是fetch+merge（或rebase），先下载远程提交记录，再自动合并到当前分支；它不是简单覆盖，遇未提交修改或冲突会失败或触发手动解决。

git pull 本质是 fetch + merge，不是单纯“下载更新”

很多人以为 git pull 就是把远程最新代码“拉下来覆盖本地”，其实它先执行 git fetch 获取远程分支的提交记录，再自动调用 git merge（或 git rebase，取决于配置）尝试合并到当前分支。这意味着：如果本地有未提交的修改，或者远程提交和本地有冲突，git pull 会直接失败或进入合并冲突状态，而不是静默覆盖。

遇到 “refusing to merge unrelated histories” 错误怎么办

这个错误常见于首次将本地仓库与一个已有提交历史的远程仓库关联时（比如你新建了本地 repo，又添加了一个别人初始化好的远程 origin）。Git 默认拒绝合并两个没有共同祖先的历史。

• 临时解决：加 --allow-unrelated-histories 参数，例如 git pull origin main --allow-unrelated-histories
• 但更稳妥的做法是先 git fetch origin，再手动 git merge origin/main 或 git rebase origin/main，便于审查差异
• 注意：该参数仅用于一次性场景，不要写进 alias 或脚本里长期使用

如何避免 pull 自动 merge 导致的意外提交

默认 git pull 触发 merge，会产生一个合并提交（merge commit），哪怕没有冲突。这对线性历史不友好，也容易掩盖真实开发脉络。

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

• 全局设置改用 rebase：运行 git config --global pull.rebase true，之后 git pull 等价于 git pull --rebase
• 只对当前项目生效：去掉 --global，在项目根目录下运行 git config pull.rebase true
• 临时禁用：加 --no-rebase 强制走 merge；临时启用：加 --rebase
• 注意：rebase 会重写本地提交 SHA，如果已推送过这些提交，后续 git push 需要加 --force-with-lease

pull 前该检查什么，才能少踩坑

直接 git pull 是高风险操作，尤其在团队协作中。建议养成前置检查习惯：

• 运行 git status 确认工作区干净，或至少暂存/提交了本地修改
• 用 git log --oneline --graph --all 快速看一眼本地和远程分支分叉情况
• 想预览远程更新内容？先 git fetch，再 git log HEAD..origin/main（假设跟踪的是 main）
• 如果本地分支没设置 upstream（即没 run git branch --set-upstream-to=origin/main），git pull 会报错 “No remote configured”，此时需指定远程和分支名：git pull origin main

最常被忽略的一点：pull 的目标分支由当前所在分支的 upstream 决定，而不是你本地分支的名字是否和远程一致。一旦 upstream 配错了，pull 可能更新错分支，且不会警告。