如何修復 Git “拒絕合併不相關的歷史”

一、概述

在 Git 中，有時分支沒有共同的歷史庫。因此，如果我們嘗試合併它們，我們會得到“refusing to merge unrelated histories”錯誤。在本教程中，我們將討論如何修復此錯誤以及如何在未來的項目中避免此錯誤。

2. 為什麼分支可以有不相關的歷史？

讓我們看看分支有不相關歷史時的場景。擁有不相關的歷史記錄庫的最常見原因是彼此獨立地啟動分支。例如，如果我們在本地機器上啟動一個新的 Git 項目，然後將其連接到遠程 GitHub 分支，這些分支將具有不同的歷史記錄庫。

唯一的例外是其中一個分支沒有提交。在這種情況下，它們應該毫無問題地合併。否則，我們將得到“refusing to merge unrelated histories” ，如下例所示：

$ git pull origin main
 ...
 fatal: refusing to merge unrelated histories

正如我們所見，我們無法使用git pull命令來合併具有不常見歷史記錄的分支。

3.如何修復錯誤

要修復上述錯誤，我們需要在git pull <remote> <branch>命令後使用選項–allow-unrelated-histories ，其中

• <remote>是遠程存儲庫 URL 或其短名稱origin
• <branch>是我們要合併的分支名稱

例如:

$ git pull origin main --allow-unrelated-histories

–allow-unrelated-histories選項將告訴 Git 我們允許合併沒有公共歷史庫的分支，然後應該會在沒有錯誤的情況下完成合併。我們應該注意，對於 Git 2.9 或更早的版本，這個選項不是必需的，我們的合併應該在沒有它的情況下工作。要檢查 Git 版本，我們可以使用git –version命令。

4. 未來如何避免錯誤

通常，獨立於遠程存儲庫創建本地存儲庫分支不是最佳實踐。更可靠的方法是使用git clone命令將遠程存儲庫下載到本地機器，如下所示：

$ git clone <repo_url>

這樣，我們從遠程服務器複製存儲庫，並且遠程和本地分支的提交歷史記錄庫保持相同。

5. 結論

在本教程中，我們討論了當 Git 拒絕合併不相關的歷史時如何合併分支。我們首先查看了何時會發生此錯誤。然後，我們使用–allow-unrelated-histories選項來修復它。最後，我們學會瞭如何在未來的項目中避免這個錯誤。