在 Fabric 中比較並提交變更

Microsoft Fabric 中的比較與提交體驗顯示了你的工作空間與已連接的 Git 分支之間的差異。 在提交、撤銷、更新或解決衝突之前,你可以透過並排或內嵌比較檢視變更後的檔案。 在檢視工作區變更時,你可以直接在同一介面中認可這些變更。

Note

當你提交 Fabric 項目時,該項目中所有變更的檔案都會包含在提交中。 對於支援的 Fabric 項目,可以執行檔案層級的提交,允許你在項目內提交特定檔案,並保留剩餘檔案未提交。 檔案層級提交目前處於預覽階段,也可透過 Commit To Git API 使用。

本文說明如何檢視工作空間變更、即將收到的 Git 更新與衝突;提交工作空間變更;以及理解支援的情境與限制。

您可以執行的作業

  • 在承諾前先檢視工作區的變更。
  • 提交一個 Fabric 項目,或支援項目的子集檔案(預覽)。
  • 更新工作區前,先先檢查收到的 Git 變更。
  • 在解決之前,先比較有衝突的項目。

你可以在哪裡檢視變更

你可以從多個地點開啟比較體驗。 下表總結了這些進入點。

Location 你可以複習的內容
變更 標籤 自上次 Git 同步以來,工作區有變動。比較中工作區部分以綠色標示。
更新 分頁 自上次 Git 同步以來,連接的 Git 分支的變化。比較中 Git 的部分以綠色標示。
衝突對話 三種比較模式中的衝突項目: 最後同步與遠端Workspace 與遠端,以及 最後同步與工作區
個別項目 在展開檢視中顯示所選項目的差異。 其他項目仍維持收合狀態,但在對話方塊中仍可存取。

檢視並提交工作區變更

使用 變更 標籤檢查工作區的變更,並選擇要提交到 Git 的內容。

  1. 在工作區頂端,選擇 「來源控制」,然後選擇 「變更 」標籤。

  2. 在面板頂端選擇「 檢視並提交變更 」以開啟所有工作區變更。 要從特定項目開始,指向該項目並在旁邊選擇 「檢視並提交變更 」。

    變更分頁的截圖,裡面有檢視所有變更或單一項目變更的選項。

  3. 在比較對話框中,展開項目並檢視其變更後的檔案。 圖示會標示每個檔案為新檔案、修改或刪除檔案。 你可以在並排或行內模式中檢視這些變更。 在比較對話框中使用切換開關,可以在資料夾式檢視和平面清單式檢視間切換工作區項目。

    比較對話框中某項目檔案層級差異的截圖。

  4. 選取項目層級的核取方塊,可將該項目的所有檔案納入提交;或者選取個別檔案的核取方塊,僅將這些檔案納入提交。 必須的系統檔案會自動被選取,無法從提交中排除。

    Note

    檔案層級提交目前處於預覽階段,僅適用於已修改狀態下的支援項目

  5. 輸入提交訊息,然後選擇 提交。 如果你只選擇了項目中的部分檔案,Fabric 會顯示警告,表示部分提交可能導致項目定義不完整或無效。 例如,若提交一個倉庫視圖而不包含其依賴資料表,可能會阻止該項目被匯入。 若要還原有效的定義,請手動在 Git 中修正檔案或提交剩餘的必要檔案。

    部分檔案層級提交驗證警告的截圖。

    未被選取的檔案會保持未提交,所以你可以繼續處理它們,並在之後的提交中加入它們。 這讓你無須等到整個項目都準備就緒,就能直接提交已完成的工作。

保留檔案選擇以便稍後提交

你可以關閉比較對話框,而不會失去檔案選擇。 Fabric 會保留選定的檔案在來源控制面板中。 部分選取的項目會顯示部分選取的勾選框,其工具提示會列出選取的檔案。 你可以重新開啟比較對話框,或直接從面板提交,不用重新選擇檔案。

在原始碼控制面板中部分選取的檔案層級截圖。

檢視即將收到的更新

在更新工作區之前,請使用 「更新」 標籤檢查已連接的 Git 分支的變更。

  1. 在工作區頂端,選擇 「來源控制」,然後選擇 「更新 」標籤。
  2. 選擇面板頂端的 「檢視變更 」以開啟所有即將收到的變更。 若要從特定項目開始,請將游標移至該項目,然後選取其旁邊的 檢閱變更

更新標籤的截圖,裡面有檢視所有更新或單一項目更新的選項。

  1. 在比較對話框中,檢視即將發生的變更。

比較對話框中即將收到的更新截圖。

  1. 回到 「更新 」標籤以繼續更新操作。

檢查衝突

使用比較對話框檢視差異,再決定如何 解決衝突。 你可以用以下任一種方式開啟衝突項目的比較對話框:

  • 變更更新 標籤中選擇衝突項目。

  • 打開解決-衝突對話框中的比較檢視。

    衝突對話框的截圖,裡面有開啟比較檢視的選項。

選擇比較模式

對於有衝突的項目,請使用比較對話框右上角的選單,選擇以下比較模式之一:

  • 最後同步與遠端同步:比較最後一次工作區同步到 Git 版本與目前連接的 Git 分支版本。

  • Workspace 與遠端:比較目前工作區版本與連接的 Git 分支版本。

  • 上次同步與工作區:比較上次工作區與 Git 版本同步時的狀態,以及目前工作區中的變更。

    下拉選單中三種比較模式皆可選的衝突項目比較對話截圖。

支援檔案層級提交的項目

檔案層級提交(預覽)僅適用於以下項目:

系統檔案與平台變更

系統檔案、元資料及平台版本變更也參與 Git 同步。 當 Fabric 偵測到這些檔案中的任何差異時,會將該項目標記為已修改,並顯示在變更更新標籤中。

系統檔案變更在變更或更新清單中會以 / 表示。

系統檔案變更的截圖,在變更列表中以斜線表示。

在大多數情況下,你可以像審查其他變更一樣檢視系統檔案變更。 例如,平台版本更新可能在不改變你編輯的內容的情況下新增或刪除系統檔案。

在檔案層級提交過程中,所需的系統檔案會自動被選擇,且無法從提交中排除。

如需詳細資訊,請參閱自動產生的系統檔案

考慮事項與限制條件

  • 比較對話框不會顯示二進位檔案或超過 1 MB 的檔案內容。
  • Git status 可以偵測出僅有編碼變更的情況,例如某個檔案以不同的編碼手動上傳到 Git 時,即使比較對話框未顯示差異也能偵測出來。
  • 檔案層級提交目前處於預覽階段,僅適用於已修改狀態下的支援項目
  • 不支援從比較程式碼體驗中提交到另一個分支,包括當原始碼控制面板包含部分選取時。