使用重訂基底來套用變更

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Git 會自動在 分支 上維護 開發歷史，藉由將每個新的 提交 連結至其前一個提交。 當您 合併 一個分支到另一個分支時，歷程記錄可能會變得不那麼簡單。 例如，no-fast-forward 合併 通過建立一個具有多個前置提交的合併提交，來合併不同的開發分支。 相反地，Git rebase 會結合不同的開發分支，而不會建立合併提交，這會導致較簡單的提交歷程記錄，但會失去有關合併的資訊。 您在選擇 合併類型 時，可能會考慮是要保留合併記錄還是簡化提交記錄。

本文討論何時使用 rebase 而非無快速向前合併，並提供下列工作的程式：

• 重新設定本機分支的基底
• 在變基之後強制推送本地分支
• 互動式變基以合併本地提交

如需 Git 工作流程的概觀，請參閱 Azure Repos Git 教學課程。

先決條件

類別	需求
專案存取	專案的成員。
許可	- 在私人項目中檢視程式碼：至少 基本 權限。 - 複製或貢獻私人專案中的程式碼：作為 貢獻者 安全群組的成員或在專案中具有相應的許可權。 - 設定分支或存放庫許可權：管理分支或存放庫的許可權 許可權。 - 變更預設分支：編輯原則 存放庫的許可權。 - 匯入存放庫：專案管理員成員 安全組或 Git 專案層級 建立存放庫 許可權設定為 允許。 如需詳細資訊，請參閱 設定 Git 存放庫許可權。
服務	啟用 Repos。
工具	選擇性。 使用 az repos 命令：Azure DevOps CLI。

備註

在公用專案中，具有 項目關係人 存取權的使用者具有 Azure Repos 的完整存取權，包括檢視、複製及參與程式代碼。

重新設定本地分支的基底

Git rebase 將來源分支的提交整合到您目前的本地分支（目標分支）。 來源分支保持不變。 如需比較，Git rebase 和其他合併類型會顯示在下圖中。

Git rebase 會重新排序目標分支的提交歷史，使其包含所有來源分支的提交，然後再接上自上次共同提交之後的所有目標分支提交。 另一種看法是，rebase 就是將目標分支中的變更回放到來源分支的歷程記錄之上。 值得注意的是，Git rebase 會變更現有目標分支的提交順序，而這在其他合併策略中不是如此。 在上圖中，commit K' 包含與 K 相同的變更，但有新的提交 ID，因為它指向提交 E，而不是 C。

在重新基底期間，如果來源分支變更與目標分支變更衝突，Git 會提示您 解決合併衝突。 您可以在變基期間，以與合併期間解決合併衝突相同的方式來解決合併衝突。

Rebase 與 no-fast-forward 合併

Git rebase 會產生較簡單但較不精確的提交歷史，而不是 不快轉 合併，也稱為 三向 或 真實 合併。 當您想要在提交歷史記錄中保留合併記錄時，請使用禁止快進（no-fast-forward）合併。

如果您是負責功能或錯誤修正分支的唯一人員，請考慮使用 rebase 將最近的 main 分支工作定期整合到其中。 該策略有助於確保您隨時瞭解其他人最近的工作，並及時解決任何出現的合併衝突。 藉由變基，您將在最新的 main 分支工作之上實作新功能，這有助於維持線性的提交歷史。

如需瞭解有關 Git rebase 及何時使用的更多資訊，請參閱 rebase 與 merge。

Rebase 和 force-push 準則

如果您重新建置先前 推送的本機分支，然後再次執行預設 Git push 命令，推送將會失敗。 預設的 Git push 命令會套用快轉合併，以將本地分支整合到遠端分支。 該命令會在變基後失敗，因為變基會改變本地目標分支中現有提交的順序，因此它不再符合其遠端對應分支的歷史記錄。 在此情境下，強制推送 會成功，因為它覆寫了遠端分支。

Git 重設基底和強制推送是功能強大的工具，但在決定是否使用時，請記住這些指導方針：

• 除非您確定沒有人使用共用分支，否則請勿重新建置已推送並與他人共用的本機分支。 重新基底之後，您的本機分支將不再符合遠端分支的歷史記錄。
• 請勿強制推送至其他人正在使用的遠端分支，因為其遠端分支的本機版本將不再符合更新的遠端分支歷程記錄。
• 您的團隊應就變基和強推的使用情境達成共識。

小提示

針對協作審查流程，請使用 拉取請求，將新工作合併至遠端存放庫的預設分支。

如何重新基底

Visual Studio 2022

Visual Studio 2022 提供 Git 版本控制體驗，方法是使用 Git 功能表、Git 變更，以及透過 方案總管 中的操作功能表。 Visual Studio 2019 16.8 版也提供 Team Explorer Git 使用者介面。 如需詳細資訊，請參閱 Visual Studio 2019 - Team Explorer 索引標籤。

1. 選擇 [Git > 管理分支]，以開啟 [Git 存放庫] 視窗。

   

2. 在 [Git 存放庫] 視窗中，以滑鼠右鍵按兩下目標分支，然後選取 [簽出]。

   

3. 以滑鼠右鍵點擊來源分支，然後選取 [Rebase <target-branch> 合併至 <source-branch>。

   

4. Visual Studio 會在成功重新基底之後顯示確認訊息。

   

   如果因合併衝突而停止變更基底，Visual Studio 會通知您。 您可以 解決衝突，或取消變基並返回變基前狀態。

   

Visual Studio 2019 - Git 功能表

Visual Studio 2019 提供 Git 版本控制體驗，可以透過 Git 功能表、Git 變更，以及在 方案總管 中的操作功能表來使用。

1. 選擇 [Git > 管理分支]，以開啟 [Git 存放庫] 視窗。

   

2. 在 [Git 存放庫] 視窗中，以滑鼠右鍵單擊目標分支，然後選取 [檢出]。

   

3. 以滑鼠右鍵點擊來源分支，然後選取 [Rebase <目標分支> 到 <來源分支>] 。

   

4. Visual Studio 會在成功重新基底之後顯示確認訊息。

   

   如果因合併衝突而停止重新基底，Visual Studio 會通知您。 您可以 解決衝突，或取消重新基底並返回預先重新建置狀態。

   

Visual Studio 2019 - Team Explorer

Visual Studio 2019 16.8 版和更新版本提供 Git 版本控制體驗，同時維護 Team Explorer Git 使用者介面。 若要使用Team Explorer，請從功能表列取消勾選 工具選項預覽功能新增 Git 使用者體驗。 您可以在兩種介面之間互換使用 Git 功能。

1. 在 Team Explorer中，選取 [首頁] ，然後選擇 [分支]。

   

2. 在 [分支] 檢視中，以滑鼠右鍵點擊目標分支，然後選取 [簽出]。

   

3. 以滑鼠右鍵點擊來源分支，並選擇 重新基底至。

   

4. 確認重新基底選項，然後按兩下 [Rebase]。

   

5. Visual Studio 會在成功重新基底之後顯示確認訊息。

   

   如果在重新基底期間發生衝突，Visual Studio 會通知您。 您可以 解決衝突，或取消變基並返回變基前的狀態。

   

Git 命令行

若要將來源分支的提交整合到目標分支中，請執行 git rebase 命令：

git rebase <source branch name> <target branch name>

如果您目前的本機分支是目標分支，可以將 rebase 命令簡化為：

git rebase <source branch name>

Git 會在重新基底期間發生衝突時通知您。 您可以 解決衝突 ，然後執行 git rebase --continue，或執行 git rebase --abort 來撤銷重置基底並返回重置前的狀態。

在變基之後強制推送本機分支

如果您重新建置先前推送的本機分支，後續的預設 Git 推送將會 失敗。 相反地，您可以強制推送本機分支來覆蓋其遠端對應的分支，使其提交歷史相符。

警告

永遠不要強制推送其他人正在處理的分支。 如需詳細資訊，請參閱 Rebase 和 force push guidelines。

若要強制在 Visual Studio 中推送，您必須先啟用強制推送選項：

1. 移至 Tools>[選項]>原始檔控制>Git 全域設定。

2. 選取 [啟用 push --force-with-lease 選項。

Git 推送 --force-with-lease 旗標比 --force 旗標更安全，因為它不會覆蓋遠端分支中有未整合至您使用強制推送的本機分支的提交。

Visual Studio 2022

1. 在 [Git 變更] 視窗中，選取推送按鈕以提交您的更改。

   

   或者，您可以從 [Git] 功能表中選取 [推送]。

   

2. 如果預設 Git 推送作業失敗，Visual Studio 會啟動 Git-Push 失敗 對話方塊。 選擇 強制推送。

   

3. Visual Studio 會在成功推送之後顯示確認訊息。

   

Visual Studio 2019 - Git 功能表

1. 在 [Git 變更] 視窗中，選取推送按鈕以提交您的更改。

   

   或者，您可以從 [Git] 選單選取 [推送]。

   

2. 如果預設 Git 推送作業失敗，Visual Studio 會啟動 Git-Push 失敗 對話方塊。 選擇 強制推送。

   

3. Visual Studio 會在成功推送之後顯示確認訊息。

   

Visual Studio 2019 - Team Explorer

Visual Studio 2019 16.8 版和更新版本提供 Git 版本控制體驗，同時維護 Team Explorer Git 使用者介面。 若要使用Team Explorer，請從功能表列取消勾選 工具選項預覽功能新增 Git 使用者體驗。 您可以在兩種介面之間互換使用 Git 功能。

1. 在 Team Explorer中，選取 [首頁]，然後選擇 [同步處理] 以開啟 [同步處理 檢視]。

   

2. 在 [同步處理] 檢視中，選擇 [推送]，將變更上傳至遠端存放庫。

   

3. 如果預設 Git 推送作業失敗，Visual Studio 會啟動 Git-Push 失敗 對話方塊。 選擇 強制推送。

   

4. Visual Studio 會在成功推送之後顯示確認訊息。

   

Git 命令行

小提示

Git 推送 --force-with-lease 旗標比 --force 旗標更安全，因為它不會覆寫包含未整合到您強制推送的本機分支中的提交的遠端分支。

若要強制將新提交從本地分支推送至同名的遠端分支：

git push --force-with-lease <remote> <local branch name>

如果您要推送的分支是被簽出的分支，可以簡化強制推送命令為：

git push --force-with-lease <remote>

當您複製遠端存放庫時，Git 會將 alias 設置為 origin，作為您所複製之遠端存放庫 URL 的簡寫。 執行 git remote -v 來檢查 origin 別名值。 若要手動新增 origin 別名，請執行 git remote add origin <remote repo url>。 使用 origin 別名，您可以進一步簡化強制推送命令：

git push --force-with-lease origin

如果您目前的本機分支在 origin上追蹤遠端分支，您可以完整縮寫 force push 命令：

git push --force-with-lease

不過，如果您的本機分支未追蹤遠端分支，則完整縮寫的推送命令將會失敗。 執行 git remote show origin 來檢查分支的追蹤狀態。

互動式重訂基礎以合併本地提交

一般而言，當您在本機功能分支中開發新功能時，您將建立多個提交。 當您準備好發佈新功能時，您可能會想將這些提交合併成單一提交，以簡化提交歷程記錄。 您可以使用互動式 rebase 將多個提交 合併 為單一提交。

Visual Studio 2022

Visual Studio 2022 不支援互動式重新配置。 請改用 Git 命令行。

Visual Studio 2019 - Git 功能表

Visual Studio 2019 不支援互動式重新配置。 請改用 Git 命令行。

Visual Studio 2019 - Team Explorer

Visual Studio 2019 不支援互動式重新配置。 請改用 Git 命令行。

Git 命令行

1. 查看您想要執行互動式重新基底的本地分支。

2. 提交、暫存或捨棄任何未提交的變更。

3. 估算您想要在提交記錄中回溯的範圍。 當您執行互動式 rebase 命令時，您不需要準確地選擇需要壓縮的特定提交。 例如，如果您想要合併最後五個提交，請執行：

   git rebase -i HEAD~5
   

   Git 會開啟一個編輯器，從最新的開始列出最近的五次提交。 例如：

   pick 7068b09 Update README network switch section
   pick 9d247f7 Update README network controller section
   pick 5d7ab9f Fix fiber optic transmitter test
   pick 7b43f3f Add network switch test
   pick 00859d9 Add network controller test
   

4. 讓第一行保持為不變。 在接下來的幾行中，若要將提交與上面的提交合併，請將 pick 更改為 squash。 例如，若要合併最上面兩個提交和最下面兩個提交，請將提交清單修改為：

   pick 7068b09 Update README network switch section
   squash 9d247f7 Update README network controller section
   pick 5d7ab9f Fix fiber optic transmitter test
   pick 7b43f3f Add network switch test
   squash 00859d9 Add network controller test
   

5. 儲存並關閉編輯器。 Git 接著會為每個合併的提交打開新的編輯器，提示您輸入提交信息。 針對每個認可集，將認可訊息壓縮成一則訊息，然後儲存並關閉編輯器。 在上述範例中，壓縮的認可會使用新的認可訊息來壓縮：

   8fcb88f Update README network sections
   ac6d3c0 Fix fiber optic transmitter test
   f0aadc3 Add two network tests
   

   雖然提交 Fix fiber optic transmitter test 並未壓縮，但它有了新的提交 ID，因為它現在連結到不同的前置提交。

如需了解互動式 rebase 的詳細資訊，請參閱 Git rebase 互動模式。

備註

Azure DevOps 使用者可以 壓扁合併，以壓縮拉取請求期間主題分支的提交記錄。

後續步驟

使用 cherry-pick 複製變更

相關文章

• 您是 Git 存放庫的新手嗎？ 瞭解更多資訊
• 透過推送分享程式碼
• 以擷取、合併和拉取來更新程式碼