檢閱提取要求 (英文)

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

當您建立 提取要求 （PR） 並指定必要/選擇性的檢閱者時，Azure Repos 會通知檢閱者您的 PR 已準備好進行檢閱。 所有必要的檢閱者都必須核准PR中的變更，才能將變更合併至目標分支。 對於變更分支等重要分支的 main PR，您的小組可能已建立 分支 原則來指定檢閱者，或需要最少的檢閱者數目。 如果分支原則將選擇性檢閱者新增至您的PR，您可以保留這些檢閱者、要求檢閱者，或將其移除。 如果分支原則將必要的檢閱者新增至您的PR，則您無法將其設為選擇性或移除。 如需透過分支原則指派檢閱者的相關信息，請參閱 自動包含程式代碼檢閱者。

如果您正在檢閱PR，請嘗試提供精確且容易理解的建設性意見反應。 如需檢閱意見反應的詳細資訊，請參閱 提取要求意見反應。 本文說明如何在 Azure DevOps 中檢閱提取要求。

您只能使用瀏覽器在入口網站中檢閱 Azure DevOps PR。

在本文中，您將了解如何：

• 檢閱變更
• 使用批注
• 編輯檔案
• 追蹤已檢閱的檔案
• 投票處理PR變更
• 完成 PR

必要條件

• 您的 Azure DevOps 專案設定中必須啟用 Repos 。 如果 Repos 中樞和相關聯的頁面未顯示，請參閱開啟或關閉 Azure DevOps 服務以重新啟用 Repos。

• 若要檢閱 PR，您必須是 PR 所屬 Azure DevOps 專案的成員，且具有 基本 存取層級或更高層級。

  • 如果您沒有專案，請建立一個專案或 免費註冊。

  • 如果您不是項目成員， 請新增 。

  注意

  針對公用專案，獲得 項目關係人 存取權的使用者具有 Azure Repos 的完整存取 權。

• 若要深入瞭解許可權和存取權，請參閱 預設 Git 存放庫和分支許可權 和 關於存取層級。

您可以使用 Azure DevOps 命令行介面 （CLI） 來管理 Azure DevOps Services 中的 PR。 當您安裝 Azure CLI 和 Azure DevOps 擴充功能時，可以使用 Azure DevOps CLI。 如需管理PR的 CLI 命令清單，請參閱 az repos pr 命令。

檢閱變更

提取要求可讓指定的檢閱者先檢查、討論及投票處理建議的變更，再將這些變更套用至存放庫的目標分支。 請記住，如果在不同分支上使用相同的檔案來執行開發，可能會有衝突的變更。 在此情況下，必須仔細分析並解決這些衝突。 若要這樣做，可能需要手動編輯檔案，才能正確套用來源、目標或兩個分支的變更。 從來源或目標取得所有變更（可以透過單擊單一按鈕來完成）可能不是最佳變更，而且可能會遺失一些必要的變更。 這可以使用 ADO 工具來完成，或者使用開發工具（例如 Visual Studio）會更方便。

若要深入瞭解，請參閱 解決合併衝突。

下列步驟說明 Azure Repos 中的 PR 檢閱者如何流覽 PR，以瞭解建議的變更：

1. 從網頁瀏覽器開啟 Azure DevOps 組織的小組專案。 選擇 [存放庫 > 提取要求 ] 以列出 PR。 新開啟的 PR 預設為 [ 概觀 ] 索引標籤。

2. PR 的 [ 概觀 ] 索引標籤會顯示標題、描述、檢閱者、連結的工作專案、歷程記錄、狀態和批註。 閱讀PR描述以查看建議的變更。 檢視批注，以瞭解其他檢視所引發的問題。

   注意

   每個檔案估計有一些修改，並以 「+」 符號或名稱旁的 「重新命名、編輯」標籤示。 當檔案有超過 50% 的變更時，會將其視為 已重新命名。 這是無法變更之 Git 存放庫的預設閾值。

   

3. 選取 [ 檔案] 索引標籤，以檢閱 PR 來源分支中的所有內容變更。 初始檢視會顯示所有檔案變更的摘要檢視。 選擇檔案旁的 [ 檢視 ] 按鈕，只檢視該檔案的變更。 如果修改了檔案，[ 檢視 ] 按鈕會開啟差異檢視。 如果檔案已新增或刪除，[ 檢視 ] 按鈕會開啟內容窗格。

   

   注意

   基於效能考慮，摘要檢視不會顯示大於 0.5 MB 的檔案變更。

4. 在檔案的差異檢視中，您可以選取 並排 或 內嵌 差異配置。

   

   提示

   對於大於 5 MB 的任何 單一 檔案，差異檢視會顯示截斷的檔案內容。 如需完整內容的差異檢視，請使用本機差異工具下載並檢閱這類檔案。

   使用左側檔案樹狀目錄檢視另一個檔案，或選取檔案樹狀結構的根目錄，以查看所有檔案變更的摘要檢視。

5. 若要檢閱特定 推送 至來源分支所引進的變更集，請從變更下拉式清單中選取一或多個變更集。 當您選取一或多個變更集時，差異檢視會更新，只顯示所選變更集的變更。 當您上次檢閱之後，變更已推送至 PR，而您只想查看新的變更時，這項功能就很有用。 變更下拉式清單會將每個變更集命名為每個變更集，其中包含每個推送作業中最終認可的認可訊息。

   

   提示

   從 [變更] 下拉式清單中選取多個變更集時，按住 Shift 鍵。

6. 選擇 [更新] 索引標籤來檢視所有推送的變更集，以確保您未錯過任何來源分支變更。 變更集會編號，且最新的變更集會出現在清單頂端。 每個變更集都會顯示在該推送作業中推送的認可。 強制推送的變更集不會覆寫變更集歷程記錄，而且會顯示在變更集清單中，與任何其他變更集相同。

   

7. 選擇 [ 認可] 索引 標籤，在來源分支與目標分支分流之後，檢視來源分支的認可歷程記錄。 如果 PR 作者強制推送不同的認可歷程記錄，則會覆寫 [認可] 索引卷標的認可歷程記錄，因此[認可] 索引標籤中顯示的認可可能與 [更新] 索引卷標中顯示的認可不同。

   

檢閱檔案

選取 [PR 檔案] 索引標籤，以檢視提取要求目標分支旁對來源分支所做的實際變更。

注意

Azure DevOps 提取要求與 Azure DevOps 分支比較之間的不同變更是不同的比較方法所造成的。

git diff 命令有兩個比較方法：雙點 （git diff A..B） 和三點 （git diff A...B）。 根據預設，提取要求會顯示三點差異，而分支比較則會改為顯示兩點差異。

例如：

      C---D---E branch
     /
A---B---F---G   master

提取要求： git diff branch...master 只會產生 C、D、E 認可。 分支比較： git diff branch..master 會產生 C、D、E、F、G 認可。

如需詳細資訊，請參閱 three-dot-and-two-dot-git-diff-comparisons 和 git diff

注意

檢視單一 選取檔案的差異時，檔案大小限制為 5 MB。 若要檢視和差異大於 5 MB 的檔案，您可以使用本機差異工具來下載檔案並加以檢視。 檢視檔案集合的差異時，基於效能考慮，每個檔案的大小限製為0.5 MB。

檢閱更新

從 [ 所有更新 ] 下拉式清單中檢閱舊版的程序代碼。

分支的每個更新都會將新版本新增至清單，並在 PR 的 [更新] 索引卷標上。 當您選取不同的更新時，差異檢視更新會顯示每個 PR 版本中檔案之間的差異。

您可以逐步執行自上次檢閱后所做的變更，以趕上PR更新。

在 [更新] 索引標籤上瀏覽作者的變更清單。

在 [認可] 索引標籤上檢視和選取認可分支中所做的變更。

使用批注

PR 作者和檢閱者可以藉由新增和回應PR批注來彼此通訊。 當您檢閱 PR 時，請使用批注指出建議變更、 建議變更，以及回應先前批注的問題。 旨在提供精確且容易理解的建設性意見反應。 使用其 @username直接位址收件者。 使用 #workitemID!pullrequestID和其他PR參考工作專案。 有時候，PR 作者會為自己建立檔用途的批注。

在批注中提供意見反應

如果您的意見反應適用於檔案中的特定行或行範圍，請在檔案內的該位置新增批注：

1. 在 PR 的 [ 檔案 ] 索引標籤中，將滑鼠停留在您要批註的行上，然後選取批註按鈕 以開啟內嵌批注方塊。 您也可以選取多行，然後選取當您將滑鼠停留在這些行上時出現的批註按鈕。

   

2. 在批注方塊中輸入您的批注，然後選擇 [ 批注]。

   

如果您的意見反應適用於整個檔案，請從檔案選項功能表中選取 [新增批注]，以新增檔案層級批注 ：

若要提供與特定檔案無關的一般意見反應，請在 [ 概觀 ] 索引標籤中新增批註：

PR 檢閱者也可以使用批注來 建議特定檔案行的變更 ，如下一節所述。

建議批註中的變更

您可以使用批注來建議檔案中一行或多行的替換文字：

1. 在 PR 的 [ 檔案 ] 索引標籤中，將滑鼠停留在您要批註的行上，然後選取批註按鈕 以開啟內嵌批注方塊。 您也可以選取多行，然後選取當您將滑鼠停留在這些行上時出現的批註按鈕。 如果已接受，建議的內容將會取代您新增批注的行或行。

   

2. 選取批注方塊底下的燈泡圖示，以在圍欄程式代碼區塊內的批注方塊中做出建議的變更，然後選擇 [ 批註]。 如果您將批註新增至並存差異檢視的原始程式代碼（左側），則不會看到燈泡圖示。

   

PR 作者可以透過下列方式接受您的建議：

1. 選擇 [ 套用變更 ] 以暫存認可整備的變更。

   

2. 選擇 [ 認可所有變更 ] 以認可所有分段變更。 PR 作者可以選擇 [復原變更] 來取消設定建議。

   

編輯或刪除批注

您可以將滑鼠停留在批註上方並選擇編輯或移除圖示，以編輯或刪除批註：

喜歡批注

PR 作者和檢閱者可以 透過將滑鼠停留在批註上並選擇拇指圖示來喜歡 自己的或其他人的批註：

具有讚的批註會顯示填滿的拇指圖示和讚的數目。 將滑鼠停留在拇指圖示上方，以查看喜歡批註的人員清單。

回復批注

PR 作者應回復批注，讓檢閱者知道他們如何處理意見反應和建議：

1. 若要回復批注，請在 [撰寫回復] 欄位中輸入您的回應。 使用其 @username直接位址收件者。 使用 #workitemID!pullrequestID和其他PR參考工作專案。

   

2. 輸入回應之後，如果回應為最終回應，請選取 [ 回復及解決 ]。 否則，請選取 [ 回復]。

   

   如果您選取 [ 回復及解決]，批注狀態將會變更為 [已解決]。 PR 作者也可以直接變更批注的狀態，如下一節所述。

變更批注狀態

新的批注一開始會有作用中狀態，PR 作者會在PR期間更新檢閱程式，以指出他們如何處理檢閱者的意見反應和建議。 PR 作者可以從狀態下拉式清單中選取批注狀態：

• 使用中：新批注的默認狀態。

• 擱置中：此批注中的問題正在檢閱中，並等候其他專案。

• 已解決：已解決此批注中的問題。

• 無法修正：不會修正此批注中的問題，但無法修正。

• 已關閉：此批注中的討論已關閉。

PR 作者和檢閱者可以藉由 篩選 批注狀態來追蹤PR進度，如下一節所述。

篩選批注

您可以從批註篩選下拉式清單中選取篩選選項，以選取 [概觀] 索引卷標上顯示的批註或更新。 例如，選取 [新增 篩選] 選項，以查看自上次開啟PR之後的新批注和更新。 每個篩選選項都會顯示其類別的項目數。

編輯檔案

為了方便起見，PR 作者可以直接在 Azure Repos 中編輯檔案。 例如，您可能已接受檢閱者建議的程式代碼變更，而且想要在其他位置進行類似的變更。

1. 選擇 [ 存放庫 > 檔案]、選取 PR 來源分支、選取檔案，然後選擇 [ 編輯]。

   

2. 在編輯器中進行變更，然後選擇 [認可 ] 以開啟 [ 認可 ] 對話框。

   

3. 在 [認可] 對話框中，視需要編輯認可訊息，然後選擇 [認可] 認可並將變更推送至您的 PR。

   

追蹤已檢閱的檔案

PR 檢閱者可以選擇 [從檔案選項] 功能選取 [標記為已檢閱]，或選取檔案或資料夾旁的複選框，以追蹤已檢閱 的檔案：

投票處理PR變更

瀏覽器

PR 檢閱者可以從投票下拉式清單中選取投票選項來投票給PR。 PR 頁面上的檢閱者圖示會顯示其投票指示。

投票選項如下：

• 核准：核准 PR 中建議的變更。 此選項只是投票，且未核准PR。

• 核准建議：使用選擇性建議來核准PR中建議的變更。 此選項只是投票，且未核准PR。

• 等候作者：要求作者檢閱檢閱者批注。 PR 作者應該讓檢閱者知道在PR作者處理批注之後重新檢閱程式碼。 如果必要的檢閱者設定此投票選項，投票將會封鎖PR核准。

• 拒絕：表示無法接受變更。 當您選擇此選項時，請新增批注，說明原因。 如果必要的檢閱者設定此投票選項，投票將會封鎖PR核准。

• 重設意見反應：清除您的投票。 沒有投票並不會阻止 PR 完成。

Azure DevOps CLI

若要投票決定是否要核准PR，請使用 az repos pr set-vote 命令。

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

參數

參數	必要	描述:
--id	Yes	提取要求標識碼
--vote	Yes	提取要求的新投票值（接受的值：approve、、approve-with-suggestionsreject、 reset或 wait-for-author）
--detect	No	自動偵測組織（接受的值： false、 true）
--organization	是，如果未設定默認組織，且 Git 組態檔未指定組織	Azure DevOps 組織 URL，或使用下列項目來設定預設組織： az devops configure -d organization=<organization URL>
--subscription	No	Azure 訂用帳戶的名稱或識別符，或使用： az account set -s <name or ID>

範例

下列命令會投票核准PR #21。 命令會傳回數據表。

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

下列命令會移除您的投票。 命令會傳回數據表。

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

完成 PR

PR 作者可以選擇 PR 解析選項：

• 完成：如果所有必要的檢閱者已核准PR，且符合所有必要的分支原則，請立即完成PR。

• 設定自動完成：當所有必要的檢閱者核准並符合所有必要的分支原則時，自動完成PR。

• 標示為草稿：將PR設定為草稿狀態，表示它尚未準備好進行檢閱。 針對草稿 PR，您可以選取 [ 發佈 ] 來移除其草稿狀態，並標示它已準備好進行檢閱。

• 放棄：關閉 PR。 針對已放棄的 PR，您可以選取 [ 重新啟用 ] 來還原它。

如需完成PR的詳細資訊，請參閱 完成提取要求。

下一步

完成提取要求

相關文章

• 提取要求更新通知
• 關於提取要求和許可權