git fetch 是同步前必须做的第一步，它只下载远程分支最新提交记录，不改动工作区、暂存区或本地分支指针；跳过它直接 pull 或 merge 易导致冲突、多余合并提交或 push 被拒。

git fetch 是同步前必须做的第一步

跳过 git fetch 直接 git pull 或 git merge，等于在没看清路况时就踩油门。它只下载远程分支的最新提交记录，不改动你本地工作区、暂存区或当前分支指针。

常见错误现象：执行 git pull 后发现多了一个 merge commit，或者 git push 被拒绝，提示 “non-fast-forward”。根本原因往往是本地没先获取远程最新状态。

• git fetch origin：拉取所有远程分支更新（日常推荐）
• git fetch origin main：只拉取 main 分支，省带宽
• 执行后，origin/main 这个远程追踪分支就更新了，但你的本地 main 仍不动
• 用 git log --oneline main..origin/main 能一眼看出远程多了哪些提交

git reset --hard origin/xxx 覆盖本地分支

当你确认要丢弃本地所有修改（包括未提交更改、未推送提交），让本地分支完全对齐远程 HEAD，这是最直接的方式。

注意：这个操作不可逆，且会清空工作区和暂存区。别在没备份时直接跑。

• 先确保已执行 git fetch origin
• 再运行 git reset --hard origin/main（把 main 换成你要同步的分支名）
• 如果想避免硬编码分支名，可用 git reset --hard @{u}（@{u} 指向上游分支，需加双引号在 PowerShell 中）
• 若还要清理未跟踪文件（比如编译产物、临时日志），补一句 git clean -df，但务必先 git clean -n -f 预览

本地有未推送提交时，用 git rebase 同步更干净

如果你本地已有几个 commit，又想保持线性历史（避免 merge commit），git rebase 比 git merge 更合适。但它不是“无痛同步”，冲突时会暂停，需要你介入。

Cnb Cool Git

CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。

下载

容易踩的坑：变基后强行 git push 会失败，因为远程历史已被改写。

• 执行 git fetch origin 更新 origin/main
• 再运行 git rebase origin/main
• 冲突时，编辑文件删掉 和 <code>>>>>> commit-id 及中间的分隔线，保留正确逻辑
• 保存后 git add （不是 git commit）
• 继续变基：git rebase --continue；想放弃：git rebase --abort
• 变基完成后，若该分支已推过远程，需 git push --force-with-lease origin main

远程分支被删了，本地还显示怎么办

这不是 bug，是 Git 默认不自动清理过期的远程追踪分支。比如别人删了 origin/feat/search，git branch -a 仍能看到它。

不处理会导致 git checkout feat/search 失败，或误以为分支还存在。

• 先用 git remote show origin 查看远程真实分支列表
• 确认哪些分支已不存在后，运行 git fetch --prune（或简写 git fetch -p）
• 这会主动删除本地残留的 remotes/origin/xxx 记录
• 也可配置全局自动清理：git config --global fetch.prune true

真正麻烦的不是命令记不住，而是没搞清「当前本地到底有没有未保存的修改」「远程分支是否真被删了」「上游追踪关系有没有设对」——这些细节不查清楚，任何同步操作都可能倒退一步甚至覆盖他人代码。