必须手动添加upstream远程源：执行git remote add upstream https://github.com/owner/repo.git，再用git remote -v确认origin指向fork、upstream指向原仓库。
怎么给 fork 仓库添加上游远程（upstream）
你 fork 的仓库不会自动跟踪原仓库更新，必须手动添加一个指向原始仓库的远程别名（通常叫 upstream）。不加这一步，git pull 永远只从你自己的 origin 拉，拉不到源项目的新提交。
操作很简单，进到本地 clone 目录后执行：
git remote add upstream https://github.com/owner/repo.git
注意把 URL 换成实际源仓库地址（不是你的 fork 地址）。可以用 git remote -v 确认是否添加成功——应该能看到两行：origin 指向你的 fork，upstream 指向源仓库。
常见错误：
- 误把
upstream指向自己的 fork（和origin重复），导致后续拉不到更新 - 用 SSH 地址添加
upstream却没配好密钥，git fetch upstream报Permission denied；建议统一用 HTTPS 地址，除非你明确需要 SSH
怎么安全地同步 main / master 分支
同步不是直接 git pull upstream main 就完事。如果你本地 main 有未 push 的提交，强行 merge 可能产生冲突甚至覆盖修改。推荐分三步走：
-
git fetch upstream：只下载源分支的最新 commit 记录，不改动你本地任何文件 -
git checkout main：确保你在目标分支上（比如main，有些老项目还是master） -
git merge upstream/main：把上游新提交合并进来；如果本地没改过main，Git 会做 fast-forward，很干净；如果有本地提交，就按需解决冲突
更保守的做法是用 git rebase upstream/main 替代 merge，能把你的本地提交“叠”在上游最新版之上，历史线更线性——但前提是没把本地分支推到远程（否则会重写公共历史）。
为什么 git pull upstream main 有时不生效
直接运行 git pull upstream main 看似省事，但容易出问题：
- 它等价于
git fetch upstream main && git merge FETCH_HEAD，跳过了fetch后检查上游状态的环节，一旦网络中断或权限失败，你可能以为同步完了，其实啥都没拉下来 - 如果本地
main分支跟踪的是origin/main（默认行为），git pull不带参数时仍会去拉origin，而不是你刚配的upstream - 某些 Git 版本对
pull的解析有歧义，尤其当远程名含下划线或特殊字符时，不如显式fetch + merge可控
所以别图快，fetch 和 merge 拆开执行，每步都能验证结果。
要不要同步其他分支（比如 dev、next）
源仓库的非主分支（如 dev）不一定稳定，也不保证长期存在。同步它们前先确认：
- 该分支是否在源仓库的
README或贡献指南里被明确标记为「公开开发分支」 - 你本地是否有同名分支？如果有，
git checkout dev && git merge upstream/dev才有意义；否则先git checkout -b dev upstream/dev创建跟踪分支 - 注意
upstream/dev可能频繁 force-push，用rebase同步比merge更合适，但同样要避免已推送到origin的分支上使用
多数人只需同步 main（或 master），其他分支按需拉取即可，别养成全自动同步所有分支的习惯——上游删掉一个实验分支，你的 git fetch --prune upstream 会删掉本地对应 ref，但不会提醒你。
