前言
在开发中，我们经常会遇到这种情况：基于一个开源项目或团队公共仓库做二次开发，既要持续同步源仓库的最新更新，又要把自己的修改安全提交到私有仓库。
很多新手会选择“克隆两份代码”或“手动复制文件”，既麻烦又容易出错。其实 Git 原生就支持多远程仓库管理。只需简单配置，就能在一个本地仓库里优雅地完成双向操作。
这篇指南手把手教你搭建这套工作流，全程通俗易懂，照着做就行。
核心思路：给仓库装两扇门
把本地 Git 仓库想象成一个房间，远程仓库就是通往外面的门。默认克隆时只有一扇门叫origin。我们再装一扇门：
- origin(正门)：连接你自己的仓库，日常推送代码用
- upstream(侧门)：连接源仓库，只用来拉取最新代码
进出通道分开，就不会走错门、推错代码。
三步搞定配置
假设你的仓库地址是https://github.com/yourname/repo.git，源仓库地址是https://github.com/original/repo.git。
第一步：克隆你自己的仓库
始终以自己的仓库作为主工作区：
git clone https://github.com/yourname/repo.git cd repo第二步：添加源仓库为 upstream
git remote add upstream https://github.com/original/repo.git第三步：验证配置
git remote -v正常输出应类似：
origin https://github.com/yourname/repo.git (fetch) origin https://github.com/yourname/repo.git (push) upstream https://github.com/original/repo.git (fetch) upstream https://github.com/original/repo.git (push)社区约定俗成把源仓库命名为upstream，自己的仓库保留origin，建议遵守这个习惯。
日常使用：同步与提交
配置完成后，只需记住两个场景。
场景一：从源仓库同步最新代码
# 1. 从 upstream 拉取最新代码(只拉取，不合并) git fetch upstream # 2. 将更新合并到你的分支(推荐 rebase，历史更干净) git rebase upstream/main # 3. 同步到你自己的远程仓库 git push origin main如果 rebase 过程中出现冲突，解决冲突后执行git rebase --continue即可。尽量用 rebase 而不是 merge，提交历史会更整洁。
场景二：正常开发并提交
和日常操作完全一样：
git add . git commit -m "feat: 新增自定义功能" git push origin main因为origin指向的是你自己的仓库，代码会安全推过去。
安全加固：防止手滑误推源仓库
很多人忽略了这一步。万一不小心执行了git push upstream，可能造成尴尬甚至事故。直接禁用 upstream 的推送权限：
git remote set-url --push upstream DISABLED再次验证：
git remote -v会看到：
upstream https://github.com/original/repo.git (fetch) upstream DISABLED (push)以后即使误敲推送命令，Git 也会直接报错拦截。
进阶：一键同步脚本
如果经常需要同步，可以在项目根目录创建sync.sh：
#!/bin/bash set -e echo "📥 正在拉取上游代码..." git fetch upstream echo "🔀 正在 rebase 到 upstream/main..." git rebase upstream/main echo "📤 正在推送到自己的仓库..." git push origin main echo "✅ 同步完成！"赋予执行权限：
chmod +x sync.sh以后只需运行./sync.sh即可一键完成全部同步。
避坑清单
| 注意点 | 说明 |
|---|---|
| 分支名要对齐 | 确保 upstream 和本地的分支名称一致(如都是 main)，避免合并错位 |
| 不要直接修改 upstream 分支 | 始终在自己的分支上开发，保持 upstream 分支纯净，仅用于同步 |
| 首次同步可能报错 | 如果两个仓库历史差异较大，rebase 时可能需要加--allow-unrelated-histories |
| 定期同步 | 不要攒太久再同步，间隔越短，冲突越少，解决起来也越轻松 |
总结
这套 “origin + upstream” 的双仓库工作流，是开源贡献、企业内部 Fork 定制、以及多仓库代码同步的行业标准做法。它不需要任何第三方工具，纯 Git 原生命令就能实现，既保证能持续接收上游更新，又让你的修改独立、安全管理。
