最可控做法是添加upstream远程源后fetch再merge或rebase；需先git remote add upstream ，再git fetch upstream，然后git merge upstream/main（或rebase）；git pull upstream/main非法，正确为git pull upstream main。

怎么把 upstream 的新提交拉到本地 fork 分支

直接加 remote 指向原始仓库，再 fetch + merge（或 rebase）——这是最可控的做法。很多人卡在第一步：没配 upstream 远程源，或者配了但用 origin 直接去拉，结果报错 “Not possible to fast-forward” 或者根本拉不到上游更新。

• 先确认原始仓库地址（比如 https://github.com/vuejs/core），执行：

  git remote add upstream https://github.com/vuejs/core

• 首次添加后必须 git fetch upstream，否则本地没有它的分支引用（upstream/main、upstream/dev 等）
• 切到你本地要同步的分支（通常是 main），再运行：

  git merge upstream/main

  （推荐）或

  git rebase upstream/main

  （适合干净提交历史）
• 如果提示“refusing to merge unrelated histories”，说明你 fork 时初始提交和 upstream 完全无关——加 --allow-unrelated-histories 参数即可，但要小心冲突

为什么 git pull upstream/main 会失败

git pull 是 fetch + merge 的组合命令，但它默认只对当前分支设置的 upstream（即 branch.main.remote 配置）生效。你刚加的 upstream 远程源，并不会自动绑定到本地 main 分支上，所以 git pull upstream/main 实际是非法语法，Git 会报错 fatal: 'upstream/main' does not appear to be a git repository 或类似提示。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

• 正确写法只有两种：

  git fetch upstream && git merge upstream/main

  或

  git pull upstream main

  （注意空格，不是斜杠）
• git pull upstream main 能工作，是因为它等价于 “从 upstream 远程拉取 main 分支并合并到当前分支”，不依赖分支跟踪配置
• 别依赖 git branch --set-upstream-to=upstream/main 来简化——这会让本地 main 分支“认 upstream 为主”，后续 git pull 就默认拉 upstream，但容易和你自己的 origin 混淆，尤其当你也要 push 修改时

同步时遇到冲突，该不该用 rebase

rebase 让提交线性整洁，但会改写 commit hash；merge 保留真实协作时间线，更安全。选哪个，取决于你是否已把本地分支推到了自己的 origin 上。

• 如果还没 push 过（本地只有自己改的几处），用 git rebase upstream/main 更清爽，之后 git push -f origin main 强推也没问题
• 如果已经 push 到 origin，且别人可能基于你的分支工作，就别 rebase——用 git merge upstream/main，生成一个合并提交，不破坏已有历史
• rebase 过程中出现冲突，解决后用 git add . && git rebase --continue；别用 git commit，那会多出一个提交
• 误操作想退回？git rebase --abort 立刻回到 rebase 前状态，比 merge 后撤回简单得多

GitHub 页面上点 “Sync fork” 按钮到底干了什么

它只是帮你做了一次 git merge upstream/main 并推送到你的 origin/main，背后没有魔法。但它有硬限制：只能同步默认分支（通常是 main 或 master），不能选其他分支；而且要求你 fork 后没改过默认分支的提交历史（比如没 force push 过）。

• 按钮灰掉？常见原因：你 fork 的仓库默认分支名和 upstream 不一致（比如 upstream 是 main，你 fork 时默认是 master），需手动改分支名或配 remote 同步
• 点完按钮提示 “There isn’t anything to compare”，说明你的 fork 默认分支和 upstream 完全无共同祖先，得先用 --allow-unrelated-histories 手动 merge 一次
• 这个按钮不会 fetch 其他分支（如 dev、next），也不会更新你本地仓库——它只作用于 GitHub 服务器上的 origin 仓库

同步 upstream 的本质是维护两个远程源（origin 和 upstream）之间的分支关系，而不是“一键更新”。最容易被忽略的是：每次同步前，你得确保本地分支是干净的，且清楚自己接下来是要 merge 还是 rebase——选错会影响后续协作节奏。