远程与 Fork

远程（remote） 是本地仓库与 GitHub 服务器之间的桥梁；Fork 是在自己账号下复制他人仓库，开源贡献的标准入口。本课对应 git-github 路线图 的 managing-remotes、forking-vs-cloning、pr-from-a-fork。

git push / git pull 基础在 git-essentials；这里讲多 remote、upstream 同步与 fork 工作流。

学习目标

• 管理多个 remote（origin、upstream）
• 区分 clone 与 fork 的使用场景
• 完成从 fork 开 PR 的完整同步流程

查看与配置 remote

git remote -v
git remote add upstream git@github.com:original-owner/project.git
git remote rename origin old-origin   # 少用
git remote remove upstream

典型 fork 布局：

remote	指向	用途
origin	你的 fork	push 你的分支
upstream	上游原仓	pull 最新 main，保持同步

同步 upstream 到 fork

git fetch upstream
git switch main
git merge upstream/main
# 或 git rebase upstream/main
git push origin main

在 feature 分支开发前，先更新 main，减少 PR 冲突。

Fork vs Clone

操作	结果
Clone	本地副本；需对原仓有读权限（public 可读）
Fork	GitHub 上在你账号建新仓 + 可选 clone 到本地

开源贡献：Fork → clone 你的 fork → 分支 → push origin → PR 到 upstream。

git clone git@github.com:you/forked-project.git
cd forked-project
git remote add upstream git@github.com:upstream-owner/forked-project.git
git switch -c fix/typo-in-readme
# 修改、commit
git push -u origin fix/typo-in-readme

然后在 GitHub：Compare & pull request 到 upstream-owner/forked-project 的 main。

HTTPS 与 SSH

# 查看当前 remote URL
git remote get-url origin

# 切换为 SSH
git remote set-url origin git@github.com:you/repo.git