在遠端主機上搭配安全殼層使用 Visual Studio Code （SSH）

重要

這是 Azure Sphere （舊版）檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式）檔。

Visual Studio Code 可以搭配 Azure Sphere SDK 使用，透過安全殼層（SSH）在遠端主機上建置和偵錯程式代碼。支援兩種案例：

不支援第三個案例—本機計算機上的程式碼和遠端電腦上的裝置上的程式碼。

設定本機計算機

下載並安裝 Visual Studio Code。
安裝適用於 Windows 或 Linux 的 Azure Sphere SDK。
在 Visual Studio Code 擴充功能面板中搜尋 Azure Sphere，然後按兩下 [安裝]，以安裝 Azure Sphere 擴充功能。

提示

有兩 Azure Sphere 個延伸模組，其中一個都會安裝兩者： 適用於 UI 元件的 Azure Sphere UI ，以及 工作區元件的 Azure Sphere 。
在 Visual Studio Code 擴充功能面板中搜尋 Remote-SSH，然後按兩下 [安裝 ] 按鈕，以安裝 Remote-SSH 擴充功能。

透過 USB 將裝置連線到本機電腦。
如果遠端電腦上還沒有專案，您可以複製範例存放庫，或從 Microsoft Samples Browser 取得單一專案。
在本機開啟 Visual Studio Code。
僅限第一次：從檢視>命令選擇區>遠端 SSH 開啟 Visual Studio Code：新增 SSH 主機，並輸入 SSH 主機資訊，如提示。（根據預設，名為 config 的檔案會寫入主目錄中的 .ssh 目錄。如果您的本機計算機是 Windows，這有時會造成許可權問題。您可能想要將檔案移至另一個目錄，並在 [檔案>喜好>>設定延伸模組>遠端 - SSH：組態檔] 中指定絕對路徑。

執行 Visual Studio Code 命令檢視>命令選擇區>遠端 SSH：連線到主機 ，Shift+Ctrl+P以連線到遠端電腦。
在 Visual Studio Code 擴充功能面板中搜尋 Azure Sphere，然後按兩下 [在 SSH 中安裝：[遠端名稱] 按鈕，以將 Azure Sphere 擴充功能安裝至遠端電腦。安裝之後，您可能需要重新啟動 Visual Studio Code 並重新連線到遠端電腦。

提示

若要檢查延伸模組是否已正確安裝在遠端電腦上，請清除延伸模組面板中的搜尋方塊，並確定Azure Sphere延伸模組出現在 SSH： [遠端名稱] - INSTALLED 檢視中。
使用 [檔案>開啟資料夾] 或 [檔案>開啟] 工作區開啟項目資料夾或工作區。

按 F5 建置和偵錯專案。如果專案先前尚未建置，或檔案已變更並重建是必要的，Visual Studio Code 會在偵錯開始之前建置專案。
等候數秒，讓 Visual Studio Code 建置應用程式、建立映像套件、將其部署至面板，然後在偵錯模式中啟動它。您會在一路上的 [輸出 ] 窗格中看到狀態更新。

首先，CMake 會判斷是否需要建置應用程式。如果是，焦點會移至輸出視窗，以顯示 CMake/Build 的輸出。

接下來，[ 輸出 ] 窗格會在映射套件部署至裝置時顯示結果。最後，偵錯控制台會接收焦點，並顯示調試程序輸出。

使用 Visual Studio Code 調試程式來設定斷點、暫停、逐步執行、逐步執行、重新啟動或停止應用程式。

透過 USB 將裝置連線到遠端電腦。
如果遠端電腦上還沒有專案，您可以複製範例存放庫，或從 Microsoft Samples Browser 取得單一專案。
在本機開啟 Visual Studio Code。
僅限第一次：從檢視>命令選擇區>遠端 SSH 開啟 Visual Studio Code：新增 SSH 主機，並輸入 SSH 主機資訊，如提示。（根據預設，名為 config 的檔案會寫入主目錄中的 .ssh 目錄。如果您的本機計算機是 Windows，這有時會造成許可權問題。您可能想要將檔案移至另一個目錄，並在 [檔案>喜好>>設定延伸模組>遠端 - SSH：組態檔] 中指定絕對路徑。

執行 VS Code 命令檢視>命令選擇區>遠端 SSH：連線到主機 （Shift+Ctrl+P）以連線到遠端電腦。
執行 VS Code 命令檢視>命令選擇區>喜好設定來新增遠端設定：開啟遠端設定，並將下列欄位新增至 JSON 物件（如果是空的檔案，您需要將此包裝在 {}中）：
```
    "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }
```
視專案和小組的設定而定，您可以改為將此設定新增至使用者/工作區設定。
在 Visual Studio Code 擴充功能面板中搜尋 Azure Sphere，然後按兩下 [在 SSH 中安裝：[遠端名稱] 按鈕，以將 Azure Sphere 擴充功能安裝至遠端電腦。安裝之後，您可能需要重新啟動 Visual Studio Code 並重新連線到遠端電腦。

提示

若要檢查延伸模組是否已正確安裝在遠端電腦上，請清除延伸模組面板中的搜尋方塊，並確定Azure Sphere延伸模組出現在 SSH： [遠端名稱] - INSTALLED 檢視中。
使用 [檔案>開啟資料夾] 或 [檔案>開啟工作區] 開啟項目資料夾或工作區。

按 F5 建置和偵錯專案。如果專案先前尚未建置，或檔案已變更並重建是必要的，Visual Studio Code 會在偵錯開始之前建置專案。
等候數秒，讓 Visual Studio Code 建置應用程式、建立映像套件、將其部署至面板，然後在偵錯模式中啟動它。您會在一路上的 [輸出 ] 窗格中看到狀態更新。

首先，CMake 會判斷是否需要建置應用程式。如果是，焦點會移至輸出視窗，以顯示 CMake/Build 的輸出。

接下來，[ 輸出 ] 窗格會在映射套件部署至裝置時顯示結果。最後，偵錯控制台會接收焦點，並顯示調試程序輸出。

使用 Visual Studio Code 調試程式來設定斷點、暫停、逐步執行、逐步執行、重新啟動或停止應用程式。

若要結束遠端偵錯會話，請選取 [檔案>關閉遠端連線]。