手動更新

當您更新工作區中的專案或 復原 認可時，一定會有一或多個專案失敗的機會。 如果 Git 分支的傳入更新導致工作區中的不一致或其他難以事先判斷的問題，工作區將無法更新。 當項目無法更新時，更新程式就會停止。 如果失敗的專案是第一個正在更新的專案（或僅限）專案，工作區會與原始分支保持同步。 如果專案在一或多個專案成功更新之後失敗，您就會有一些專案同步處理且有些專案未同步的情況。 在此情況下，您的工作區不會同步至任何 Git 分支。

重要

這項功能處於預覽狀態。

更新可能會因為許多原因而失敗。 可能的原因包括但不限於下列問題：

• 相依專案已變更或刪除
• 已建立迴圈相依性
• 專案已重新命名
• 無效的項目數據

注意

這與衝突解決不同。 如果對工作區和 Git 分支中的相同專案進行變更，則會造成衝突並停用更新。 本文討論如何執行工作區無法更新，即使沒有直接衝突也一樣。

錯誤訊息可讓您知道哪個項目失敗，以及原因。

當更新失敗時，會出現此錯誤訊息。 任何嘗試在之後存取工作區的使用者都看到下列錯誤，直到更新順利完成為止。

選取 [ 檢視詳細資料 ] 以查看先前的錯誤訊息。

項目失敗后的 Git 狀態

您的工作區現在包含下列專案：

• 失敗前更新的專案或專案。 這些專案與 git 中的專案相同，但元數據不會更新。 其 Git 狀態為 已 同步，但具有三角形警告符號。
• 失敗的專案。 此專案具有必要的更新狀態。
• 可能，項目失敗時尚未更新的專案。 這些專案尚未更新，且需要更新的 Git 狀態。

顯示最新同步狀態之畫面底部的狀態列為紅色，並指出部分同步狀態。

更新失敗的專案

若要在工作區無法自動更新之後手動更新工作區：

1. 找出導致更新失敗的專案，以及使用錯誤對話框指出哪個項目失敗和錯誤訊息的問題。
2. 修正 Git 中的問題。 這可能表示視問題而定，執行下列一或多個動作：
   • 將專案還原為未失敗的舊版
   • 編輯專案解決問題
   • 還原已刪除的相依專案
   • 刪除相依於已刪除專案不支援的專案
3. 返回工作區，然後 再次更新 整個工作區。

考量與限制

更新程式會在一個項目失敗時立即失敗。 因此，無法知道 Git 分支中的其他專案是否也會有問題。 如果您要更新許多專案，而且有多個項目有問題，您必須針對每個失敗的項目重複此程式一次。

相關內容

衝突解決