Git 知识系列（八）：多 Remote 双向同步

在使用开源项目时，很多人的常见需求是：在维护自己版本的同时，还能同步上游的更新。方案二（配置多个 Remote）是最灵活的方式，本文详细介绍具体操作步骤。

核心概念

在同一个本地仓库配置两个远程仓库：

origin    → 你 Fork 的仓库（你的远程仓库）
upstream  → 原仓库（上游仓库）

Remote	作用	常用操作
`origin`	你Fork的仓库	推送（push）你的修改
`upstream`	原仓库	拉取（fetch）上游更新

配置步骤

1. Fork 原仓库

在 GitHub/GitLab 上将原仓库 Fork 到你的账户。

2. 克隆你 Fork 的仓库

git clone git@github.com:your-username/the-repo.git
cd the-repo

3. 添加原仓库作为 upstream

git remote add upstream git@github.com:original-owner/the-repo.git

4. 验证配置

git remote -v

输出类似：

origin    git@github.com:your-username/the-repo.git (fetch)
origin    git@github.com:your-username/the-repo.git (push)
upstream  git@github.com:original-owner/the-repo.git (fetch)
upstream  git@github.com:original-owner/the-repo.git (push)

日常使用流程

拉取上游更新

git fetch upstream

合并上游更新到你的分支

方式一：merge（保留合并历史）

git checkout main
git merge upstream/main

方式二：rebase（保持线性历史）

git rebase upstream/main

推送到你的 Fork

git push origin main

推送你的修改

git add .
git commit -m "我的自定义配置"
git push origin main

分支管理策略

推荐采用以下分支结构：

main                # 保持与上游同步
├── feature-a      # 你的自定义功能
└── feature-b      # 你的自定义功能

创建功能分支

git checkout -b my-custom-feature

同步上游更新的完整流程

# 1. 在 main 分支同步上游
git checkout main
git fetch upstream
git merge upstream/main
git push origin main

# 2. 回到功能分支，rebase 到最新的 main
git checkout my-custom-feature
git rebase main

适用场景

场景	是否适合
定制需要持续跟随原项目更新	✅ 非常适合
需要维护多个自定义分支	✅ 适合
只想简单使用不想深入管理	❌ 建议用 Fork + PR
临时小改动，后续可能丢弃	❌ 建议用 patch 方式

小结

通过配置多个 Remote，你可以在同一个本地仓库中：

随时获取上游项目的最新更新
保持自己的修改分支与上游同步
灵活地在自己的功能分支上进行开发

这是维护开源项目定制版本的最佳实践方案。