如何为已上传的GitHub仓库设置上游仓库以获取原项目提交历史？

一、你自己本地仓库可独立操作（无需团队仓库权限） #

完全可以在你本地的仓库副本中添加原Space Station 13仓库作为上游，以此查看原项目的5年提交历史，还能同步原项目的更新。操作步骤：

• 克隆团队仓库到本地：

  git clone <你的团队GitHub仓库地址>
  cd <仓库目录名>
  

• 添加原项目作为上游远程仓库：

  git remote add upstream <原Space Station 13的GitHub仓库地址>
  

• 拉取原项目的所有提交历史：

  git fetch upstream
  

• 查看原项目的提交历史：

  # 假设原项目主分支为main，若为master则替换
  git log --oneline upstream/main
  

• 后续若要基于原项目的更新开发，可以在你的分支中合并上游代码：

  git checkout <你的开发分支>
  git merge upstream/main
  

二、团队远程仓库关联历史（需仓库管理员操作） #

如果希望团队的远程GitHub仓库也显示原项目的完整提交历史，只有仓库管理员能执行以下操作（注意：此操作会修改远程仓库的历史记录，需提前和团队成员沟通，做好备份）：

1. 管理员克隆团队仓库到本地：

   git clone <团队GitHub仓库地址>
   cd <仓库目录名>
   

2. 添加原项目作为上游远程：

   git remote add upstream <原Space Station 13的GitHub仓库地址>
   

3. 拉取原项目的所有历史：

   git fetch upstream
   

4. 定位团队初始提交对应的原项目提交（可通过对比初始提交的文件内容，找到原仓库中匹配的提交哈希）
5. 将团队的所有提交重新挂靠到原项目历史之后：

   # 替换<原分支名>为原项目主分支（如main/master），<团队初始提交哈希>为你们仓库第一个提交的哈希，<团队主分支>为你们的主分支
   git rebase --onto upstream/<原分支名> <团队初始提交哈希> <团队主分支>
   

6. 强制推送到团队远程仓库：

   git push origin <团队主分支> --force
   

7. 通知所有团队成员重新克隆仓库，或执行git fetch origin后重置本地分支，避免历史冲突

注意事项 #

• 本地添加上游操作完全独立，不会影响团队远程仓库，适合你个人查看历史和同步原项目更新
• 远程仓库修改历史有风险，必须确保团队所有人都知晓并配合，避免代码丢失

内容的提问来源于stack exchange，提问作者G_Dude