共用方式為


在 Visual Studio 中建立提取要求

如果您已向 GitHub 或 Azure DevOps 驗證,並已將變更推送至遠端存放庫,則可以建立提取要求,而不需要離開 Visual Studio。 Pull Request 是 GitHub 和 Azure DevOps 中用於程式碼審查的重要工具。 這些審查有助於發現新功能中的問題,並允許團隊成員與程式碼庫的不同區域分享他們的經驗,從而改善程式碼庫的整體健康狀況。

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

  1. 在建立拉取請求之前,您必須為您的變更建立新的分支。 此分支會將您的修改與主分支分開,直到它們準備好合併為止。

  2. 然後您可以在 Git 變更視窗中提交和推送變更,就像往常一樣。

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

    Git 變更視窗的螢幕擷取畫面,其中包含資訊列「已成功將 QP 推送到原始伺服器。提取要求:在 Visual Studio 中建立或在瀏覽器中建立。

    或者,您可以透過最上層功能表 Git> 或 Azure DevOps>,從遠端分支拉取請求的視窗導航至 [>] 視窗。 或以滑鼠右鍵按一下 Git 存放庫視窗中的分支。

    在 Git 功能表中選取 GitHub 並在 Visual Studio 2022 中將「新增拉取請求」文字醒目提示。

    或者,在 Git 存放庫視窗中右鍵選取分支,以開啟內容功能表,然後選取 [新增提取要求]。

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

    當你嘗試建立拉取請求,但鑰匙圈裡有多個帳號時,你會看到一個提示,問你該用哪個帳號。 請參閱將 GitHub 帳戶新增至您的鑰匙圈

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

    小提示

    使用 Visual Studio 2022 17.10 版和更新版本以及 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 和更新版本中,按一下下拉式清單,然後選擇 [ 建立為草稿]。

    螢幕擷取畫面顯示將新的提取要求建立為草稿的選項。

深入瞭解如何將提取要求範本新增至存放庫,請參閱 GitHub 檔Azure DevOps 檔

在編輯器中檢視或新增提取要求註解

使用 Visual Studio 17.11 或更新版本時,您可以在不轉換至瀏覽器進行操作的情況下檢視檢閱者的註解和建議。

顯示公關評論的螢幕截圖。

要啟用此功能,請打開 工具>選項 窗格,展開 「所有設定>預覽功能 」區塊,並選擇 「拉取請求評論」 勾選框。

要啟用此功能,請開啟 工具>選項 對話框,並展開 環境>預覽功能 區塊。 選擇 拉取請求評論勾選框,然後選擇確定

檢視拉取請求的註解

若要檢視拉取請求的註解,請檢出任何具有作用中拉取請求的分支,然後從資訊列選擇 [ 在檔案中顯示註解 ]。 您也可以在 [Git 變更] 視窗中選取 PR 號碼,或從具有 Git GitHub> 或 Azure DevOps 的 Git 最上層功能表中選取 PR 號碼 在>。

螢幕擷取畫面顯示在 Git 變更視窗中檢視註解的連結。

新增提取要求註解

使用 Visual Studio 17.13 或更新版本,您可以檢閱提取要求,或新增註解。 要啟用此功能,請打開 工具>選項 窗格,展開 「所有設定>預覽功能 」區塊,並選擇 「拉取請求評論」 勾選框。

使用 Visual Studio 17.13 或更新版本,您可以檢閱提取要求,或新增註解。 要啟用此功能,請開啟 工具>選項 對話框,並展開 環境>預覽功能 區塊。 選擇「 拉取請求註解」 勾選框,然後選擇 確定

啟用註解後,檢查任何有活躍合併請求的分支,然後在資訊列點選顯示檔案中的留言。 透過程式碼檔案上方的工具列按鈕來瀏覽變更內容。

若要新增註解,請按一下編輯器左側的 [新增註解 ] 圖示,如下列螢幕擷取畫面所示。

螢幕擷取畫面顯示檢閱提取要求中的檔案變更時 [新增註解] 圖示。

您也可以以滑鼠右鍵按一下一行程式碼,然後在操作功能表上選擇 Git> 新增註解

留言文字只有在你點擊留言視窗的 「新增留言 」按鈕後才會被發布。

您可以使用註解方塊中的 [回覆] 區段,繼續對現有註解進行交談。 註解處於作用中狀態或已解決。 您可以按一下「 回覆並解決」 來回覆註解,並一鍵將狀態變更為已解決,或使用註解文字上方的下拉式清單變更狀態。

您可以按兩下圖示,或按兩下三個點,以切換批注的讚狀態,您可以將批注文字複製到剪貼簿、將批注的連結複製到剪貼簿、刪除批注,或在提供者網站的網頁瀏覽器中開啟批注 (例如 github.com 或您的 Azure DevOps 專案網站) 。

某些 Git 提供者對於在拉取請求中新增註解的能力有限制。 例如,使用 GitHub 作為提供者,您只能在變更 3 行內的行上新增批注,但使用 Azure DevOps 提供者時,您可以在提取要求中涉及的檔案的任何行新增批注。 在任何情況下,您都只能在提取請求中包含的檔案上新增註解。

在差異檢視中檢視註解

您可以在差異檢視和檔案檢視中檢視註解。 在差異檢視中,您可以看到原始程式碼和更新程式碼旁邊的註解。 這樣可以更輕鬆地查看具體更改了什麼以及更改的原因。 您也可以在此檢視中直接編輯工作檔案。

截圖顯示差異檢視中的 PR 註解。

註解中的 Markdown 格式

在檔案檢視或差異檢視中,註解會使用 Markdown 格式呈現。

截取顯示 Markdown 格式的 PR 留言的螢幕。

使用鍵盤

您可以使用工具列中的圖示瀏覽檔案和個別註解,或使用下列鍵盤快速鍵:

行動 鍵盤捷徑
移至提取要求中的上一個檔案 Ctrl+Shift+Alt+F6
移至提取要求中的下一個檔案 Ctrl+Alt+F6
轉到上一條評論 控制鍵+Shift鍵+Alt鍵+F8
轉到下一個評論 Ctrl+Alt+F8
隱藏檔案中的註解 控制鍵+Shift鍵+F1

後續步驟

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

另請參閱