當你克隆了一個開源項目并將其推送到自己的倉庫后，定期更新該開源項目并與你的本地修改同步是一個常見的需求。為了高效地管理這一過程，你可以使用 Git 的 upstream 遠程倉庫和 rebase 技術來保持代碼的整潔和線性歷史。

1. 設置上游遠程倉庫

首先，你需要將原始的開源項目倉庫設置為 upstream 遠程倉庫。這樣，你可以輕松地從上游獲取最新的更改，并將其合并到你的本地分支中。

假設你已經克隆了開源項目的倉庫，并將其推送到自己的 GitHub 或其他托管平臺上的倉庫。你可以通過以下命令添加 upstream：

# 添加 upstream 遠程倉庫
git remote add upstream https://github.com/original-owner/original-repo.git# 查看所有遠程倉庫
git remote -v

你應該會看到類似如下的輸出：

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

2. 保持本地主分支與上游同步

為了確保你的本地主分支（通常是 main 或 master）始終與上游的最新版本保持同步，你可以定期從 upstream 拉取最新的更改。這里有兩種常見的方式：merge 和 rebase。

2.1. 使用 git pull --rebase 同步

git pull --rebase 是一種推薦的方式，因為它可以保持提交歷史的線性，避免不必要的合并提交。具體步驟如下：

# 切換到本地主分支
git checkout main# 從 upstream/main 拉取最新更改并 rebase
git pull --rebase upstream/main# 如果有沖突，解決沖突后繼續 rebase
git rebase --continue# 將更新后的本地主分支推送到你的遠程倉庫
git push origin main

2.2. 使用 git merge 同步

如果你更喜歡保留合并提交的歷史記錄，可以使用 git merge 來同步上游的更改：

# 切換到本地主分支
git checkout main# 從 upstream/main 拉取最新更改并合并
git pull upstream/main# 將更新后的本地主分支推送到你的遠程倉庫
git push origin main

3. 在功能分支上進行修改

為了保持主分支的整潔，建議你在功能分支上進行所有的開發工作。這樣，你可以隨時從主分支拉取最新的更改，而不會影響你的開發進度。

3.1. 創建功能分支

每次開始新的開發任務時，創建一個新的功能分支：

# 從本地主分支創建功能分支
git checkout -b feature/new-feature

3.2. 定期同步主分支

在開發過程中，如果上游有新的更改，你可以定期將主分支的最新更改合并到你的功能分支中。為了保持提交歷史的線性，建議使用 rebase：

# 切換到功能分支
git checkout feature/new-feature# 從本地主分支拉取最新更改并 rebase
git rebase main# 如果有沖突，解決沖突后繼續 rebase
git rebase --continue

3.3. 完成功能并推送

當你完成功能開發后，將功能分支合并到主分支，并推送到你的遠程倉庫：

# 切換到本地主分支
git checkout main# 從功能分支拉取最新更改并合并
git merge --no-ff feature/new-feature# 推送更新后的主分支
git push origin main# 刪除功能分支（可選）
git branch -d feature/new-feature

4. 處理沖突

在同步上游更改時，可能會遇到沖突。Git 會暫停 rebase 或合并操作，并提示你解決沖突。你可以按照以下步驟處理沖突：

1. 解決沖突：打開沖突文件，手動解決沖突。你可以使用 git diff 查看沖突的具體內容。
2. 標記沖突已解決：解決沖突后，使用 git add 將修改后的文件標記為已解決。

git add <conflicted-file>

3. 繼續 rebase 或合并：解決所有沖突后，繼續 rebase 或合并操作。
   • 對于 rebase：

git rebase --continue

- 對于 `merge`：

git merge --continue

4. 如果有多個沖突：Git 會逐個提示你解決每個沖突，直到所有沖突都解決完畢。每解決一個沖突后，都需要運行相應的繼續命令。
5. 放棄 rebase 或合并：如果你不想繼續 rebase 或合并，可以使用以下命令放棄并恢復到之前的狀態。
   • 對于 rebase：

git rebase --abort

- 對于 `merge`：

git merge --abort

5. 定期清理不再需要的遠程分支

如果你經常從上游同步更改并推送自己的修改，可能會積累大量的遠程分支。你可以定期清理不再需要的遠程分支，以保持倉庫的整潔。

# 列出所有遠程分支
git branch -r# 刪除不再需要的遠程分支
git push origin --delete <branch-name>

6. 自動化同步流程

如果你頻繁更新開源項目并推送自己的修改，可以考慮編寫腳本或使用CI/CD工具來自動化同步流程。例如，你可以編寫一個簡單的 Bash 腳本來自動執行 pull --rebase 和 push 操作。

#!/bin/bash# 切換到主分支
git checkout main# 從 upstream/main 拉取最新更改并 rebase
git pull --rebase upstream/main# 推送更新后的主分支
git push origin main

7. 提交 Pull Request 回上游

如果你對開源項目做出了有價值的改進，可以考慮向原始項目提交 Pull Request（PR）。這不僅可以幫助項目社區，還可以提高你的貢獻度。提交 PR 的步驟如下：

1. 確保你的修改符合項目的貢獻指南：大多數開源項目都有貢獻指南，說明如何提交代碼、編寫提交信息等。請仔細閱讀并遵守這些指南。
2. 創建一個新的功能分支：確保你在功能分支上進行所有修改，而不是直接在主分支上。
3. 提交 PR：將你的功能分支推送到你的遠程倉庫，然后在 GitHub 或其他平臺上創建一個 Pull Request，請求將你的更改合并到上游倉庫。
4. 等待審查：項目維護者會審查你的 PR，并可能要求你進行進一步的修改。根據反饋進行調整，直到 PR 被接受。

8. 總結

通過以上步驟，你可以有效地管理和更新從開源項目克隆的倉庫，同時保持自己的修改。關鍵是：

• 使用 upstream 遠程倉庫來跟蹤原始項目。
• 定期從 upstream 拉取最新的更改，并使用 rebase 保持提交歷史的線性。
• 在功能分支上進行所有開發工作，避免污染主分支。
• 及時處理沖突，并保持倉庫的整潔。