共用方式為

快速入門：使用 GitHub Copilot 應用程式現代化工具對 .NET 專案進行評估和移轉

在本快速入門中，您會使用適用於 .NET 的 GitHub Copilot 應用程式現代化來評估和移轉 .NET 專案。 您要完成下列工作：

  • 評估範例專案 （Contoso University）
  • 開始移轉過程

Prerequisites

  • Windows 作業系統。

  • Visual Studio 2026（或 Visual Studio 2022 版本 17.14.17 及更高版本）。

  • .NET 桌面開發工作負載 ，並啟用下列選擇性元件：

    • GitHub Copilot
    • GitHub Copilot 應用程式現代化

  • GitHub Copilot 訂閱（付費或免費）。

  • 用 GitHub 帳號並 使用 Copilot 權限登入 Visual Studio。

    這很重要

    如果您變更訂用帳戶，則必須重新啟動 Visual Studio。

  • 程式代碼必須以 C# 撰寫。

評估應用程式整備程度

適用於 .NET 評定的 GitHub Copilot 應用程式現代化可協助您尋找應用程式整備挑戰、瞭解其影響，以及查看建議的移轉工作。 每個移轉工作都包含設定 Azure 資源、新增組態和進行程式碼變更的參考。 請遵循下列步驟來開始移轉：

  1. 將 .NET 遷移助手範例 版本庫複製到您的電腦。

  2. 在 Visual Studio 中，從範例存放庫開啟 Contoso University 解決方案。

  3. 在 [方案總管] 中，以滑鼠右鍵按一下解決方案節點，然後選取 [現代化]。

    顯示內容功能表中現代化選項的螢幕截圖。

  4. GitHub Copilot Chat 視窗隨即開啟，並顯示歡迎訊息和預先定義的選項。 從可用選項中選取 移轉至 Azure， 並將其傳送至 Copilot。

    螢幕擷取畫面，顯示歡迎訊息和移轉選項。

    Tip

    您可以直接開啟 GitHub Copilot Chat 並傳送 @Modernize Migrate to Azure 以啟動評量和移轉流程，而不是步驟 3 和 4。

  5. 新的 Copilot 聊天會話隨即開啟，並顯示歡迎訊息。 評量會自動啟動，並分析您的專案是否準備好移轉。

    螢幕擷取畫面，顯示正在進行的評估，並具有狀態指標。

  6. 評估完成後，您會在聊天視窗中看到全面的評估報告 UI 頁面和移轉任務清單。

    螢幕擷取畫面，顯示產生的評估報告，其中包含詳細的發現項目。

應用程式移轉

適用於 .NET 的 GitHub Copilot 應用程式現代化包含常見移轉案例的 預先定義工作 ，並遵循 Microsoft 的最佳做法。

開始移轉工作

以下列其中一種方式啟動移轉工作：

選項 1。 從評量報告中執行

選取上一個步驟的評量報告中的 [執行工作 ] 按鈕，以啟動移轉工作。

選項 2。 在 Copilot 聊天中傳送

在聊天中傳送移轉工作編號 （例如 1.1） 或其名稱。

在 Copilot Chat 中傳送訊息以啟動移轉工作的螢幕擷取畫面。

計劃和進度追蹤管理器生成

  • 當您開始移轉時，GitHub Copilot 會在代理程式模式中啟動名為「應用程式現代化：從移轉至<source technology><target technology>」的會話，並顯示預先定義的提示。
  • 該工具在資料夾中 .appmod/.migration 建立兩個檔案：
    • plan.md：整體遷移計畫。
    • progress.md： 一個進度追蹤器，GitHub Copilot 會隨著完成任務而更新。
  • 在繼續之前，請編輯這些檔案以自訂您的移轉。

開始程式碼修復

  • 如果您對計畫與進度追蹤器滿意，請輸入啟動遷移流程的提示，例如：

    The plan and progress tracker look good to me. Go ahead with the migration.

  • GitHub Copilot 會啟動移轉程式，並可能會要求您核准在模型內容通訊協定 （MCP） 伺服器中使用知識庫工具。 出現提示時授予權限。

  • Copilot 會依據計劃和進度追蹤器進行操作：

    • 管理相依性。
    • 套用設定變更。
    • 進行程式碼變更。
    • 建置解決方案，修正所有編譯與設定錯誤，確保建置成功。
    • 修復資安漏洞。

預設聊天訊息

GitHub Copilot 應用程式現代化版為 .NET 提供預設的聊天訊息選項，以簡化您的工作流程。

顯示 Copilot 聊天中預設聊天訊息選項的螢幕擷取畫面。

選擇預設選項之一，並在聊天中發送：

  • 執行現代化評定：啟動應用程式的新評量，以識別移轉整備問題和 Azure 相容性挑戰。
  • 檢視評量報告：開啟先前的評量報告，並根據結果顯示移轉工作的摘要。 如果先前的評量不存在，則會先執行新的評量。
  • 瀏覽熱門移轉工作：顯示建議的移轉工作和常見的現代化案例，無論任何特定評量結果為何。

Tip

這些預設訊息可協助您快速瀏覽常見工作流程，而無需輸入自訂提示。 您也可以輸入自己的訊息，以與 Copilot 互動以解決特定問題或需求。

後續步驟

Prerequisites

評估應用程式整備程度

適用於 .NET 評定的 GitHub Copilot 應用程式現代化可協助您尋找應用程式整備挑戰、瞭解其影響，以及查看建議的移轉工作。 每個移轉工作都包含設定 Azure 資源、新增組態和進行程式碼變更的參考。 請遵循下列步驟來開始移轉：

  1. 將 .NET 遷移助手範例 版本庫複製到您的電腦。

  2. 在 Visual Studio Code 中，從範例庫開啟 Contoso University 解決方案。

  3. 打開 GitHub Copilot 應用程式現代化 擴充功能。

  4. 在 快速開始 區塊中，選擇 開始評估。 評估 報告 頁面開啟。

  5. 請在頁面右上角選擇 「執行評估 」。

    任務部分中執行任務以啟動遷移任務的截圖。

  6. 評量會自動啟動，並分析您的專案是否準備好移轉。

    執行任務的截圖，分析你的專案是否能進行遷移準備。

  7. 評估完成後，您會在聊天視窗中看到全面的評估報告 UI 頁面和移轉任務清單。

    執行評估報告的介面截圖及遷移任務清單。

應用程式移轉

適用於 .NET 的 GitHub Copilot 應用程式現代化包含常見移轉案例的 預先定義工作 ，並遵循 Microsoft 的最佳做法。

建議使用以聊天為基礎的方式來開始遷移。 自訂 AppModernization-DotNet 代理程式針對應用程式現代化任務進行優化。 這個代理讓你能用簡單的自然語言提示來執行複雜的遷移情境。

請完成以下步驟選擇客製代理並開始遷移：

  1. 確保你在 Visual Studio Code 裡開啟 .NET 專案。

  2. 在 活動欄 中選擇聊天圖示，開啟 Copilot 聊天視窗。

  3. 在聊天視窗中，找到位於聊天輸入框頂端的客服代理選擇下拉選單。 從列表中選擇 AppModernization-DotNet 。 此自訂代理程式專為 .NET 應用程式現代化與遷移場景設計。

    在聊天視窗中選擇 .NET 自訂代理的截圖。

  4. 請在聊天視窗中輸入 migrate from <source> to <target> 提示，格式如下。 例如：

    migrate from rabbitmq to Azure service bus

  5. 代理會分析你的程式碼、建立遷移計畫、修改程式碼、執行驗證，並產生摘要。 選擇 繼續 進行每個步驟，並選擇 「保持 」以接受變更。

從使用者介面啟動遷移任務

你也可以從介面啟動遷移任務：

選項 1。 從評量報告中執行

選取上一個步驟的評量報告中的 [執行工作 ] 按鈕，以啟動移轉工作。

選項 2。 套用預先定義的任務

在 TASKS - .NET 區塊執行該特定任務。 例如，在「資料庫任務」下的「將資料庫遷移到 Azure Database for PostgreSQL 任務」會更新你的資料庫連線、設定、相依關係及資料存取程式碼，以使用 Azure Database for PostgreSQL。

執行特定預設任務的截圖。

計劃和進度追蹤管理器生成

當你開始遷移時，GitHub Copilot 會以代理模式啟動一個會話。

該工具會在資料夾中 .github/appmod/code-migration/<target-branch-name> 建立兩個檔案：

  • plan.md：整體遷移計畫。
  • progress.md： 一個進度追蹤器，GitHub Copilot 會隨著完成任務而更新。

在繼續之前，請編輯這些檔案以自訂您的移轉。

遷移任務中計畫產生的截圖。

開始程式碼修復

當你對計畫和進度追蹤器感到滿意時，輸入 繼續 開始遷移。

GitHub Copilot 會啟動移轉程式，並可能會要求您核准在模型內容通訊協定 （MCP） 伺服器中使用知識庫工具。 出現提示時授予權限。

Copilot 會依據計劃和進度追蹤器進行操作：

  • 管理相依性。
  • 套用設定變更。
  • 進行程式碼變更。
  • 建置專案，修正所有編譯與設定錯誤，確保建置成功。
  • 修復資安漏洞。

反覆選擇或輸入 「繼續 」以確認工具或指令的使用，並等待程式碼變更完成。

備註

在 Visual Studio Code 中，應用程式現代化預設使用 AppModernization-DotNet Claude Sonnet 4.5 的自訂代理程式，以便在更新 .NET 程式碼遷移到 Azure 時取得最佳效果。 如果你無法使用 Sonnet 4.5，則會退回到「自動」模式。 你可以從代理選單中選擇「配置自訂代理程式」來設定自訂代理程式來修改「模型」設定。 或者，你也可以在聊天視窗中使用語言模型選擇器，為當前聊天時段切換模型。

驗證迭代

程式碼變更完成後，遷移工具會開始驗證與修正的迴圈。 此迴路包含以下五個步驟：

  1. 偵測目前相依中的常見漏洞與暴露（CVE）並加以修正。
  2. 建立專案並解決任何建置錯誤。
  3. 分析程式碼的功能一致性。
  4. 分析專案中的單元測試失敗，並自動產生修正計畫，直到測試通過為止。
  5. 分析程式碼中初期遷移中遺漏的項目並修正。

所有流程完成後，遷移工具會產生摘要。 檢閱程式碼變更，並選取 [ 保留] 來確認。

後續步驟

  • Last updated on