同步 fork 仓库需三步闭环：先用 git remote add upstream 添加上游远程，再 git fetch upstream 获取更新，最后 git merge --ff-only upstream/main（或 rebase）安全合并；漏任一步都会报错或覆盖修改。
同步 fork 仓库不是“一键更新”，而是三步闭环：加 upstream → fetch → merge（或 rebase）。漏掉任何一步，git pull upstream/main 都会报错或覆盖本地修改。
怎么确认并添加 upstream 远程？
很多人卡在第一步：根本没配 upstream，却直接跑 git pull upstream/main，结果报 There is no tracking information for the current branch。这不是网络问题，是 Git 根本不认识 upstream 这个名字。
- 先执行
git remote -v，只看到origin？说明upstream没加 - 用 GitHub 页面右上角的
Code按钮复制原始仓库 HTTPS 地址（比如https://github.com/vuejs/core），别手输——少个斜杠或大小写错误都会失败 - 运行
git remote add upstream https://github.com/original-owner/repo-name.git，注意别在 feature 分支上操作，确保当前在main或master - 再跑一次
git remote -v，应该看到两行upstream（fetch/push），两行origin
为什么不能直接 git pull upstream/main？
git pull 是 fetch + merge 的组合命令，但默认 merge 行为不安全：它可能触发非快进合并（non-fast-forward），把你的本地提交“塞”进上游历史里，导致分支图混乱，甚至丢弃你还没推的改动。
Cnb Cool Git
下载
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
- 生产环境或协作中，推荐分两步：
git fetch upstream（只下载对象，不动工作区）→git merge --ff-only upstream/main（只允许快进，失败即提醒你有 diverge） - 如果
merge --ff-only报错，说明你本地有未 push 的提交，这时不该强合，而该用git rebase upstream/main整理历史（前提是没人基于你的分支开发） - 切记：
fetch后，upstream/main才真正在你本地存在；没fetch就merge，Git 会提示unknown ref
遇到 refusing to merge unrelated histories 怎么办？
这是 Git 2.9+ 的默认保护机制，不是 bug。常见于你 fork 后自己 init 过、commit 过，和上游初始提交完全无关——两个历史线没有共同祖先。
- 只在首次同步时需要加
--allow-unrelated-histories：git merge --allow-unrelated-histories upstream/main - 加完后 Git 会自动创建一个虚拟合并提交，把两条历史连起来；之后再
merge --ff-only就能正常用了 - 别用
--no-commit或--squash替代——它们会抹掉原始作者、时间戳和提交信息，对开源协作不友好 - 如果同步后发现文件全变成新增状态（而不是 diff），说明你漏了
--allow-unrelated-histories，得git reset --hard HEAD~1回退再试
同步完要不要 push 到自己的 origin？
要，但只推你真正想保留的分支。多数人只需同步 main，没必要把实验性分支也污染到远程。
- 同步完本地
main后，运行git push origin main，把最新主干更新到你自己的 fork 仓库 - 如果你维护的是
dev分支，且希望它也跟上游main保持一致，先git checkout dev，再git merge --ff-only upstream/main（目标始终是upstream/main，不是upstream/dev） - 别在
git merge后立刻git push --force——除非你明确知道 force 会覆盖别人已拉取的提交，否则风险极高
最易被忽略的一点：同步不是一次性动作。上游可能每天提交多次，你本地的 upstream/main 引用不会自动刷新；每次同步前，必须先 git fetch upstream，否则 merge 的还是旧数据。
