共用方式為


在 Visual Studio 中建立提取要求

如果您已向 GitHub 或 Azure DevOps 進行驗證,且已將變更推送至遠端存放庫,則您可以在不需要離開 Visual Studio 的情況下建立提取要求。 提取要求是 GitHub 和 Azure DevOps 中用於程式碼檢閱的重要工具。 這些檢閱有助於捕捉新功能中的問題,並可讓小組成員分享不同程式碼基底區域的經驗,以改善程式碼基底整體的健康情況。

注意

若要試用此功能,請確定您已在 [工具]>[選項]>[預覽功能]>[提取要求] 中啟用此功能

若要建立提取要求,請遵循下列步驟:

  1. 您必須先建立新的分支來進行變更,才能建立提取要求。 此分支會將您的修改與主分支分開,直到這兩者準備好合併為止。

  2. 然後,您可以像平常在 Git 變更視窗中一樣,認可推送變更。

  3. 選取通知橫幅中的連結,以在 Visual Studio 中建立在瀏覽器中建立

    Visual Studio 2022 中,[Git 變更] 視窗的螢幕擷取畫面,其中顯示 [已成功將 QP 推送至來源。提取要求:在 Visual Studio 中建立,或在瀏覽器中建立。] 資訊列。

    或者,您可以透過最上層的功能表 [Git]>[GitHub] 或 [Azure DevOps]>[新增提取要求],瀏覽至 [新增提取要求] 視窗,從遠端分支建立提取要求。 或以滑鼠右鍵按一下 Git 存放庫視窗中的分支。

    Visual Studio 2022 中,已選取 GitHub 的 Git 最上層功能表,以及醒目提示的 [新增提取要求] 文字。

    或以滑鼠右鍵選取 Git 存放庫視窗中的分支,以開啟捷徑功能表,然後選取 [新增提取要求]

    Visual Studio 2022 中,醒目提示導出 / 導入連結文字的 [Git 存放庫] 視窗。

  4. 選取您要合併的分支,並為您的提取要求提供描述性標題和描述。 您可以使用 Markdown 語法來格式化 Visual Studio 中的提取要求描述。 嘗試在 [描述] 方塊中輸入 Markdown 符號,並透過選取 [預覽] 按鈕來預覽您的 Markdown。

    提示

    透過 Visual Studio 2022 版本 17.10 預覽版 2 和更新版本,以及 GitHub Copilot 延伸模組,您可以使用 AI 產生描述變更的詳細提取要求描述。 按下閃光畫筆圖示,要求 GitHub Copilot 產生 PR 描述。 若要安裝 GitHub Copilot,請參閱在 Visual Studio 安裝和管理 GitHub Copilot

    要求 GitHub Copilot 產生 PR 描述之閃光畫筆圖示的螢幕擷取畫面。

    Visual Studio 2022 中,反白顯示預覽按鈕文字的 [新增提取要求] 視窗。

  5. 差異預覽可讓您查看已認可為提取要求一部分的檔案中的所有變更。 請參閱比較檔案 - 差異檢視

    提示

    摘要差異檢視選項可讓您只檢閱已變更的程式碼區段。

    Visual Studio 2022 中,反白顯示摘要按鈕文字的 [新增提取要求] 視窗。

  6. 您可以連結工作項目,方法是在描述方塊中輸入 # 或按下右下角的 # 按鈕,透過問題搜尋來參考工作項目。 您也可以輸入其 GitHub 使用者名稱或 Azure DevOps 身分識別或電子郵件,以新增您的檢閱者。

    描述方塊中有 # 的新提取要求,以及 Visual Studio 2022 中顯示的相關 GitHub 問題和提取要求清單。

  7. 按一下提取要求上的 [建立] 之後,其他開發人員就可以檢閱您的變更並提供意見反應。 或者,使用 Visual Studio 17.12 和更新版本,按兩下拉式清單,然後選擇 [ 建立為草稿]。

    此螢幕快照顯示建立新提取要求作為草稿的選項。

使用 Visual Studio 17.12 和更新版本,您可以啟用提取要求範本功能(在 [工具>選項>環境>預覽功能] 中,讓存放庫中的預設 PR 範本在建立 GitHub 和 Azure DevOps 的新提取要求時使用。 深入瞭解如何在 GitHub 檔和 Azure DevOps 檔中將提取要求範本新增至您的存放庫。

在編輯器中查看接收要求留言

從 Visual Studio 17.11 開始,您可以查看檢閱者的留言和建議,而無需將內容切換到瀏覽器。

顯示 PR 留言的螢幕擷取畫面。

若要啟用此功能,請開啟「工具」>「選項」>「預覽功能」,並確保選擇「接收要求留言」

若要查看接收要求的留言,請簽出任何具有使用中接收要求分支的分支,然後從資訊列中選取顯示檔案中的留言。 您也可以在「Git 變更」視窗中或從 Git 頂層選單中選擇「Git」>「GitHub」「Azure DevOps」>「在檔案中顯示留言」中選擇 PR 編號。

顯示在「Git 變更」視窗中查看留言之連結的螢幕擷取畫面。

您可以使用工具列中的圖示在檔案和單一留言之間瀏覽,或使用下列鍵盤快速鍵:

動作 鍵盤快速鍵
移至接收要求中的上一個檔案 Ctrl+Shift+Alt+F6
移至接收要求中的下一個檔案 Ctrl+Alt+F6
移至上一個留言 Ctrl+Shift+Alt+F8
移至下一個留言 Ctrl+Alt+F8

下一步

若要繼續您的旅程,請瀏覽 Visual Studio 頁面中的 [擷取、提取和同步處理]

另請參閱